Rancher CLI(命令行界面)是一个命令行工具，可用于与 Rancher 进行交互。

下载 Rancher CLI

Rancher 提供了 Windows、Mac 和 Linux 的 Rancher CLI 二进制文件下载链接，该链接位于 Rancher UI 的右下角，单击链接可以下载 Rancher CLI 二进制文件。除此之外，您还可以访问 Rancher 的 GitHub 页面，导航到CLI 发行页面，下载该二进制文件。

要求

下载 Rancher CLI 后，需要配置一些参数：

  • 您的Rancher Server URL，用于连接到 Rancher Server。
  • API Bearer Token，用于与 Rancher 进行身份验证。有关获取 Bearer Token 的更多信息，请参见创建 API 密钥。

CLI 认证

在使用 Rancher CLI 控制 Rancher Server 之前，必须使用 API​​ Bearer Token 进行身份验证。使用以下命令登录(用您的信息替换 <BEARER_TOKEN> 和 <SERVER_URL> )：

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

如果您的 Rancher Server 使用的是自签名证书，则 Rancher CLI 会询问您是否继续连接。

选择项目

在执行任何命令之前，必须选择一个 Rancher 项目(Project)来对其执行命令。要选择要运行的项目，请使用命令 ./rancher context switch 切换或选择项目。输入此命令时，将显示可用项目的列表。输入数字以选择您的项目。

例如： ./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:

输入数字“3”，单击回车键，控制台会显示两条消息，第一条说明您已切换到项目project-1，第二条说明修改project-1参数后，这些改动会被保存到/Users/markbishop/.rancher路径下的cli2.json文件中。

  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]对应用商店 App 执行操作 (例如，单个Helm charts 或 Rancher charts)。
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 参数，可以通过该参数查看每个命令行的用法。