6 - Rancher CLI

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登录进行身份验证。

使用以下命令登录:

  1. ./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 切换到其他项目，输入编号进行项目选择：

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

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

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

五：命令参数

以下命令可用于Rancher CLI。

命令结果
apps, [app]对应用商店（即单个Helm chart或Rancher 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标志，该标志记录每个命令的用法。