cli

README

Rancher CLI

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.

Version Compatibility

Rancher CLI v0.2.0+ is only compatible with Rancher Server v1.2.0+.

Running

You can check the releases page for direct downloads of the binary or build your own.

Setting up Rancher CLI with Rancher Server

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 be http://<server_ip>:8080/.

Building

The binaries will be located in /bin.

Linux binary

Run make.

Mac binary

Run CROSS=1 make build

Docker image

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.

Contact

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.

License

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.