使用Rancher CLI

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

下载 Rancher CLI

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

提示

国内用户,可以导航到 http://mirror.cnrancher.com 下载所需资源

要求

下载 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 chartsRancher 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 参数,可以通过该参数查看每个命令行的用法。