The Rancher Command Line Interface (CLI)is a unified tool to manage your Rancher server. With this tool, you can control your services, containers and hosts within a Rancher environment and automate them through scripts.
Rancher CLI v0.2.0+ is only compatible with Rancher Server v1.2.0+.
You can check the releases page for direct downloads of the binary or build your own.
To enable the CLI to connect to Rancher server, you can configure the environment variables needed. The environment variables that are required are RANCHER_URL, RANCHER_ACCESS_KEY and RANCHER_SECRET_KEY.
The access key and secret key should be an account API key. In your Rancher setup, you can create an account API key under the API tab and expand the Advanced Options.
You can run rancher config to set these environment variables for the CLI.
$ rancher --url http://<RANCHER_SERVER_URL> config
URL [http://<RANCHER_SERVER_URL>]:
Access Key [http://<RANCHER_SERVER_URL>]: <ACCESS_KEY>
Secret Key [http://<RANCHER_SERVER_URL>]: <SECRET_KEY>
INFO[0102] Saving config to /Users/<username>/.rancher/cli.json
Note: The
<RANCHER_SERVER_URL>includes whatever port was exposed when installing Rancher server. If you had followed the installation instructions, your URL would behttp://<server_ip>:8080/.
The binaries will be located in /bin.
Run make.
Run CROSS=1 make build
Run docker run --rm -it rancher/cli [ARGS] You can pass in credentials by bind mounting in a config file or setting env vars. You can also use the wrapper script in ./contrib/rancher that will make the process a bit easier.
To build rancher/cli just run make. To use a custom Docker repository do REPO=custom make and it will producte custom/cli image.
For bugs, questions, comments, corrections, suggestions, etc., open an issue in
rancher/rancher with a title starting with [cli] .
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.