Rancher CLI
Rancher CLI(命令行界面)是一个命令行工具,可用于与 Rancher 进行交互。使用此工具,你可以使用命令行而不用通过 GUI 来操作 Rancher。
下载 Rancher CLI
你可以直接 UI 下载二进制文件。
- 点击左上角的 ☰。
- 在导航侧边栏菜单底部,单击简介。
- 在 CLI 下载中,有 Windows、Mac 和 Linux 的二进制文件下载链接。你还可以访问我们的 CLI 发布页面直接下载二进制文件。
要求
下载 Rancher CLI 后,你需要进行一些配置。Rancher CLI 需要:
- 你的 Rancher Server URL,用于连接到 Rancher Server。
- API 持有者令牌(Bearer Token),用于向 Rancher 进行身份验证。有关获取持有者令牌的更多信息,请参阅创建 API 密钥。
CLI 身份验证
在使用 Rancher CLI 控制你的 Rancher Server 之前,你必须使用 API 持有者令牌进行身份验证。运行以下命令进行登录(将 <BEARER_TOKEN>
和 <SERVER_URL>
替换为你的实际信息):
$ ./rancher login https://<SERVER_URL> --token <BEARER_TOKEN>
如果 Rancher Server 使用自签名证书,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:
命令 | 结果 |
---|---|
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
标志,该标志解释了每个命令的用法。
限制
Rancher CLI 不能用于安装仪表板应用程序或 Rancher 功能 Chart。