Name: ui
Owner: Rancher
Description: Rancher UI
Created: 2014-12-17 21:13:03.0
Updated: 2018-01-17 02:07:55.0
Pushed: 2018-01-18 19:08:53.0
Homepage: http://rancher.com
Size: 33944
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Perhaps you like managing Cattle.
Prerequisites:
If you're on a Mac and use Homebrew, you can follow these steps:
ew install node watchman yarn
rn global add bower
Setup:
t clone 'https://github.com/rancher/ui'
'ui'
scripts/update-dependencies
Run development server:
rn start
Connect to UI at https://localhost:8000/ . The server automatically picks up file changes, restarts itself, and reloads the web browser. This is intended only for development, see below for distributing customizations.
Run development server pointed at another instance of the Rancher API
NCHER="http://rancher:8080/" yarn start
and/or pointed at another instance of the Catalog API
TALOG="http://catalog:8088/" yarn start
RANCHER and CATALOG can also be hostname[:port]
or ip[:port]
.
Rancher releases include a static copy of the UI passed in during build as a tarball. To generate that, run:
scripts/build-static
We highly suggest making customizations as an ember-cli addon rather than forking this repo, making a bunch of changes and then fighting conflicts to keep it up to date with upstream forever. ui-example-addon-machine is an example addon that adds a custom screen for a docker-machine driver. If there is no way for you to get to what you want to change from an addon, PRs to this repo that add generalized hooks so that you can are accepted.
Rancher UI supports localization via translations files. You can swap translations live by utilizing the Language Picker located in the footer. If you would like to add your own translations files follow the directions below.
`en-us.yaml
file located in ``
/translations` folder and rename using the
<language-code>/<country-code>.yaml``
format (Supported Locales)`languageName
` value as this is what will be displayed in the language picker in the UI`SHFT + L
` when not focused in an input or text area to toggle the languages between your currently selected language and a special none language to see what key values are missingIf you want to customize the UI, re-packaging all of Rancher to distribute the UI is possible but not terribly convenient. Instead you can change Cattle to load the UI source from a remote web server:
./scripts/build-static -l -c 'your-server.com'
./dist/static/latest
so that it's available at http://your-server.com/latest (you can rename the “latest” part with the -v
flag)//yourserver.com/latest
rn global add ember-cli
ember test
ember test --server
Please submit bugs and issues to rancher/rancher with a title starting with [UI]
.
Or just click here to create a new issue.
Copyright (c) 2014-2016 Rancher Labs, Inc.
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.