命令参考：rdctl

命令参考：rdctl

rdctl 是包含在 Rancher Desktop 中的命令行工具，它能让你通过命令行访问 GUI 功能。rdctl 旨在帮助用户完成脚本（用于自动化、CI/CD）、故障排除、远程管理等任务。当前版本的 rdctl 支持以下命令（即将发布的版本中将支持更多命令）：

信息

由于当前版本的 rdctl 是实验性的，因此所有子命令的名称、参数以及它们的输出可能会改变。

警告

Rancher Desktop 应用程序必须为以下命令运行：

命令列表

rdctl list-settings
rdctl set
rdctl shutdown

备注

很多 rdctl 命令都有对应的 API 调用。下面列出了两种格式的可用命令。api 示例假定你使用 curl 作为与 API 对话的工具。

rdctl 或 rdctl help

运行 rdctl 或 rdctl help 查看可用命令的列表：

示例输出

> rdctl help
The eventual goal of this CLI is to enable any UI-based operation to be done from the command-line as well.
Usage:
  rdctl [command]
Available Commands:
  api           Run API endpoints directly
  completion    Generate the autocompletion script for the specified shell
  factory-reset Clear all the Rancher Desktop state and shut it down.
  help          Help about any command
  list-settings Lists the current settings.
  set           Update selected fields in the Rancher Desktop UI and restart the backend.
  shell         Run an interactive shell or a command in a Rancher Desktop-managed VM
  shutdown      Shuts down the running Rancher Desktop application
  start         Start up Rancher Desktop, or update its settings.
  version       Shows the CLI version.
Flags:
      --config-path string   config file (default /Users/jan/Library/Application Support/rancher-desktop/rd-engine.json)
  -h, --help                 help for rdctl
      --host string          default is localhost; most useful for WSL
      --password string      overrides the password setting in the config file
      --port string          overrides the port setting in the config file
      --user string          overrides the user setting in the config file
Use "rdctl [command] --help" for more information about a command.

rdctl api

运行 rdctl api / 全局列出所有端点：

示例输出

$ rdctl api / | jq -r .[]
GET /
GET /v0
GET /v1
GET /v1/about
GET /v1/diagnostic_categories
GET /v1/diagnostic_checks
POST /v1/diagnostic_checks
GET /v1/diagnostic_ids
PUT /v1/factory_reset
PUT /v1/propose_settings
GET /v1/settings
PUT /v1/settings
PUT /v1/shutdown
GET /v1/transient_settings
PUT /v1/transient_settings

rdctl api /vX

运行 rdctl api /v1 列出版本 1 中的所有端点：

示例输出

$ rdctl api /v1 | jq -r .[]
GET /v1
GET /v1/about
GET /v1/diagnostic_categories
GET /v1/diagnostic_checks
POST /v1/diagnostic_checks
GET /v1/diagnostic_ids
PUT /v1/factory_reset
PUT /v1/propose_settings
GET /v1/settings
PUT /v1/settings
PUT /v1/shutdown
GET /v1/transient_settings
PUT /v1/transient_settings

rdctl api /v0/settings

rdctl api [endpoints] 是对直接使用 API 的用户最有用的命令，因此它们不适合像 rdctl set 一样日常使用。例如：

以下命令

rdctl api /v0/settings --method PUT --body '{"kubernetes": {"enabled": false}}'

与以下命令是一样的：

rdctl set --kubernetes-enabled=false

只是它没那么简洁和用户友好。

rdctl extension install

安装 Rancher Desktop 扩展。

rdctl extension install <image-id>

选项 & 示例输出

选项

--force               Avoids any interactivity.
<image-id>:<tag>      The <tag> is optional, e.g. splatform/epinio-docker-desktop:latest.

示例

$ rdctl extension install docker/logs-explorer-extension:0.2.2
Installing image docker/logs-explorer-extension:0.2.2

rdctl extension ls

列出当前安装的镜像。

rdctl extension ls

示例输出

示例

$ rdctl extension ls
Extension IDs
docker/logs-explorer-extension:0.2.2

rdctl extension uninstall

卸载 Rancher Desktop 扩展。

rdctl extension uninstall <image-id>

选项 & 示例输出

选项

<image-id>:<tag>      The <tag> is optional, e.g. splatform/epinio-docker-desktop:latest.

示例

$ rdctl extension uninstall docker/logs-explorer-extension:0.2.2
Uninstalling image docker/logs-explorer-extension:0.2.2: Deleted docker/logs-explorer-extension:0.2.2

rdctl list-settings

运行 rdctl list-settings 以查看当前的活动配置：

示例输出

> rdctl list-settings
{
  "version": 6,
  "application": {
    "adminAccess": false,
    "pathManagementStrategy": "rcfiles",
    "updater": {
      "enabled": false
    },
    "debug": false,
    "telemetry": {
      "enabled": true
    },
    "autoStart": false,
    "startInBackground": false,
    "hideNotificationIcon": false,
    "window": {
      "quitOnClose": false
    }
  },
  "virtualMachine": {
    "memoryInGB": 6,
    "numberCPUs": 2,
    "hostResolver": true
  },
  "WSL": {
    "integrations": {}
  },
  "containerEngine": {
    "allowedImages": {
      "enabled": false,
      "patterns": [
        "docker.io"
      ]
    },
    "name": "moby"
  },
  "kubernetes": {
    "version": "",
    "port": 6443,
    "enabled": false,
    "options": {
      "traefik": true,
      "flannel": true
    },
    "ingress": {
      "localhostOnly": false
    }
  },
  "portForwarding": {
    "includeKubernetesServices": false
  },
  "images": {
    "showAll": true,
    "namespace": "k8s.io"
  },
  "diagnostics": {
    "showMuted": false,
    "mutedChecks": {}
  },
  "experimental": {
    "virtualMachine": {
      "type": "qemu",
      "useRosetta": false,
      "socketVMNet": false,
      "mount": {
        "type": "reverse-sshfs",
        "9p": {
          "securityModel": "none",
          "protocolVersion": "9p2000.L",
          "msizeInKB": 128,
          "cacheMode": "mmap"
        }
      },
      "networkingTunnel": false
    }
  },
  "extensions": {
    "docker/logs-explorer-extension:0.2.2": true
  }
}

调用以下 API 以查看当前的活动配置：

示例输出

curl -s -H "Authorization: Basic $AUTH" http://localhost:6107/v0/settings -X GET

注意：-X GET 是可选的。你也可以单独使用前面的命令。

rdctl set

运行 rdctl set [flags] 来设置属性。在大多数情况下，Kubernetes 会在运行 set 命令时重置。你可以通过在单个命令中使用链接来设置多个属性。下面是一些参考示例：

示例输出

> rdctl set --kubernetes-enabled=false
> rdctl set --container-engine docker --kubernetes-version 1.21.2

调用以下 API 来设置属性：

示例输出

curl -s -H "Authorization: Basic $AUTH" http://localhost:6107/v0/settings -d '{ "kubernetes": { "containerEngine": "docker", "enabled": false, "version":"1.23.5" }}' -X PUT

rdctl shutdown

运行 rdctl shutdown 来正常关闭 Rancher Desktop：

示例输出

> rdctl shutdown
Shutting down.

调用以下 API 来关闭 Rancher Desktop：

示例输出

shutdown: curl -s -H "Authorization: Basic $AUTH" http://localhost:6107/v0/shutdown -X PUT

rdctl start

运行 rdctl start 来确保 Rancher Desktop 按照要求运行和配置：

示例输出

> rdctl start --container-runtime dockerd -- kubernetes-version 1.19.3

调用以下 API 来确保 Rancher Desktop 按照要求运行和配置，请填写你的用户和密码：

示例输出

curl -s -H "Authorization: Basic $(echo -n "user:PASSWORD" | base64)"

rdctl version

运行 rdctl version 来查看当前 rdctl CLI 的版本：

示例输出

> rdctl version
rdctl client version: 1.1.0, targeting server version: v1