本文档采用自动化机器翻译技术翻译。尽管我们力求提供准确的译文，但不对翻译内容的完整性、准确性或可靠性作出任何保证。若出现任何内容不一致情况，请以原始英文版本为准，且原始英文版本为权威文本。

SUSE Rancher Prime CLI

Rancher CLI（命令行界面）是一个统一的工具，您可以用它与Rancher交互。使用此工具，您可以通过命令行操作Rancher，而不是使用图形用户界面（GUI）。

下载Rancher CLI

可以直接从UI下载二进制文件。

在左上角，单击 ☰。
在导航侧边栏菜单的底部，单击关于。
在 CLI下载部分 下，有Windows、Mac和Linux的二进制文件下载链接。您还可以查看我们的CLI发布页面以直接下载二进制文件。

要求

下载Rancher CLI后，您需要进行一些配置。Rancher CLI需要：

您的Rancher服务器URL，用于连接到Rancher服务器。
一个API Bearer Token，用于与Rancher进行身份验证。有关获取Bearer Token的更多信息，请参见 rancher-admin/users/settings/api-keys.adoc[创建API密钥]。

CLI身份验证

在您可以使用Rancher CLI控制Rancher服务器之前，您必须使用API Bearer Token进行身份验证。使用以下命令登录（将 <BEARER_TOKEN> 和 <SERVER_URL> 替换为您的信息）：

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

如果Rancher服务器使用自签名证书，Rancher CLI会提示您继续连接。

项目选择

在您执行任何命令之前，您必须选择一个 Rancher 项目来执行这些命令。要选择一个项目进行操作，请使用命令 ./rancher context switch。当您输入此命令时，将显示可用项目的列表。输入一个数字以选择您的项目。

示例：./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/.ranchcli2.json

确保您可以成功运行 rancher kubectl get pods。

命令

以下命令可在 Rancher CLI 中使用。

命令结果

命令	结果
`clusters, [cluster]`	对您的集群执行操作。
`context`	在 Rancher 项目之间切换。有关示例，请参见项目选择。
`inspect [OPTIONS] [RESOURCEID RESOURCENAME]`	显示有关 Kubernetes 资源或 Rancher 资源（即：项目和工作负载）的详细信息。按名称或 ID 指定资源。
`kubectl`	运行 kubectl 命令。
`login, [l]`	登录到 Rancher 服务器。有关示例，请参见 CLI 身份验证。
`machines, [machine]`	对机器执行操作。
`namespaces, [namespace]`	对名称空间执行操作。
`nodes, [node]`	对节点执行操作。
`projects, [project]`	对项目执行操作。
`ps`	在项目中显示工作负载。
`server`	对服务器执行操作。
`settings, [setting]`	显示您 Rancher 服务器的当前设置。
`ssh`	使用 SSH 协议连接到您的集群节点之一。
`up`	应用 compose 配置。
`wait`	等待资源集群、APP、项目和多集群APP。
`token`	进行身份验证并生成新的 kubeconfig 词元。
`help, [h]`	显示命令列表或某个命令的帮助信息。

clusters, [cluster]

对您的集群执行操作。

context

在 Rancher 项目之间切换。有关示例，请参见项目选择。

inspect [OPTIONS] [RESOURCEID RESOURCENAME]

显示有关 Kubernetes 资源或 Rancher 资源（即：项目和工作负载）的详细信息。按名称或 ID 指定资源。

kubectl

运行 kubectl 命令。

login, [l]

登录到 Rancher 服务器。有关示例，请参见 CLI 身份验证。

machines, [machine]

对机器执行操作。

namespaces, [namespace]

对名称空间执行操作。

nodes, [node]

对节点执行操作。

projects, [project]

对项目执行操作。

ps

在项目中显示工作负载。

server

对服务器执行操作。

settings, [setting]

显示您 Rancher 服务器的当前设置。

ssh

使用 SSH 协议连接到您的集群节点之一。

up

应用 compose 配置。

wait

等待资源集群、APP、项目和多集群APP。

token

进行身份验证并生成新的 kubeconfig 词元。

help, [h]

显示命令列表或某个命令的帮助信息。

Rancher CLI 帮助

一旦通过 CLI 登录到 Rancher 服务器，输入 ./rancher --help 以获取命令列表。

所有命令都接受 --help 标志，该标志记录每个命令的用法。

局限性

Rancher CLI 无法用于安装仪表板APP或 Rancher 功能图表。