Rancher CLI工具可用于与Rancher进行交互,使用此工具,您可以使用命令行而不是GUI来操作Rancher。

一:下载Rancher CLI

Rancher CLI二进制文件可以直接从Rancher UI下载,下载链接可以从Rancher UI右下角找到。Rancher CLI有Windows,Mac和Linux的二进制文件。您还可以从文件下载页面下载最新版本的二进制文件。

二:运行要求

下载Rancher CLI后,您需要进行一些配置。 Rancher CLI要求:

三:CLI登录认证

1、在使用Rancher CLI控制Rancher Server之前,必须使用API Bearer Token登录进行身份验证。

使用以下命令登录:

./rancher login https://<SERVER_URL> --token <BEARER_TOKEN>

替换<BEARER_TOKEN><SERVER_URL>

image-20180818181947065

2、如果Rancher Server使用自签名证书,Rancher CLI会提示您是否继续连接

image-20180818182047812

3、输入yes,接着会让您选择默认项目:(输入编号)

image-20180818182216104

4、输入番号后,会自动保存一个cli配置文件,后期的登录就不会再次要求登录了

image-20180818182343843

5、接着可以输入rancher node查看节点信息:

image-20180818182501263

四:项目切换

如果需要操作其他项目,需要先进行项目切换,通过 ./rancher context switch 切换到其他项目,输入编号进行项目选择:

User:rancher-cli-directory user$ ./rancher context switch
NUMBER    CLUSTER NAME   PROJECT ID              PROJECT NAME
1         cluster-2      c-7q96s:p-h4tmb         project-2
2         cluster-2      c-7q96s:project-j6z6d   Default
3         cluster-1      c-lchzv:p-xbpdt         project-1
4         cluster-1      c-lchzv:project-s2mch   Default
Select a Project:

输入编号后,控制台会显示一条消息,表明您已切换到其他项目,并生成新的配置文件。

INFO[0005] Setting new context to project project-1
INFO[0005] Saving config to /Users/markbishop/.rancher/cli2.json

五:命令参数

以下命令可用于Rancher CLI。

命令 结果
apps, [app] 对应用商店(即单个Helm chartRancher chart)执行操作。
catalog 应用商店)执行操作。
clusters, [cluster] 集群上执行操作。
context 在Rancher 项目之间切换。有关示例,请参阅项目选择
inspect [OPTIONS] [RESOURCEID RESOURCENAME] 显示有关Kubernetes资源或Rancher资源(即:项目工作负载)的详细信息。按名称或ID指定资源。
kubectl 运行kubectl命令
login, [l] 登录Rancher Server。有关示例,请参阅CLI身份验证
namespaces, [namespace] 命名空间执行操作。
nodes, [node] 节点上执行操作。
projects, [project] 项目执行操作。
ps 显示项目中的工作负载
settings, [setting] 显示Rancher Server的当前设置。
ssh 使用SSH协议连接到您的一个集群节点。
help, [h] 显示一个命令的命令列表或帮助。

六: Rancher CLI帮助

使用CLI登录Rancher Server后,输入./rancher --help以获取命令列表。 所有命令都接受--help标志,该标志记录每个命令的用法。