CLI
了解 DC/OS 中的命令行界面实用程序
DC/OS 1.12 需要 DC/OS CLI >= 0.7。安装时,请遵循说明。
若要列出可用命令,请运行不带参数的 :
表 1 - 命令
表 2 - 选项
如需更多信息,请参阅以下扩展描述:
设置群集
要与群集进行交互,首先需要设置 CLI。
若要显示 DC/OS CLI 版本,请运行:
dcos --version
您将获得类似以下内容的输出信息:
$ dcos --version
dcos.version=N/A
dcos.commit=N/A
dcos.bootstrap-id=N/A
DC/OS CLI 版本和配置文件
DC/OS CLI 0.4.x 和 0.5.x 针对配置文件的位置使用不同的结构。
DC/OS CLI 0.4.x 具有单个配置文件,默认情况下存储在 ~/.dcos/dcos.toml
。在 DC/OS CLI 0.4.x 中,您可以选择使用 环境变量更改配置文件的位置。
DC/OS CLI 0.5.x 具有每个连接群集的配置文件,默认情况下存储在 ~/.dcos/clusters/<cluster_id>/dcos.toml
中。在 DC/OS CLI 0.5.x 中,您可以选择使用 [DCOS_DIR
](#dcos-cdir)环境变量更改配置目录的基本部分(~/.dcos
)。
- 如果更新到 DC/OS CLI 0.5.x 并运行任何 CLI 命令,它将触发从旧配置结构到新配置结构的转换。
- 在调用
dcos cluster setup
后(或已经发生转换),如果您尝试使用dcos config set
命令更新群集配置,该命令将显示一条警告消息,指出该命令已弃用且群集配置状态现在可能已损坏。
环境变量
DC/OS CLI 支持以下环境变量,可以动态设置。您正在使用的 CLI 版本将决定应使用哪个命令。
DCOS_CLUSTER
(仅限 DC/OS CLI 0.5.x 及更高版本)- (仅限 DC/OS CLI 0.4.x)
dcos cluster setup <cluster-url>
接受所有登录和身份认证问题:
在完成登录程序后,您的 CLI 已准备好与您的群集进行交互。
dcos cluster setup
命令安装 和 ,但不安装 dcos-enterprise-cli
。DC/OS Enterprise CLI 必须单独安装。请参阅 安装 DC/OS Enterprise CLI。
安装 DC/OS Enterprise CLI 后,您将看到添加的新命令:
dcos backup
dcos license
dcos security
dcos
Command line utility for the Mesosphere Datacenter Operating
System (DC/OS). The Mesosphere DC/OS is a distributed operating
system built around Apache Mesos. This utility provides tools
for easy management of a DC/OS installation.
Available DC/OS commands:
auth Authenticate to DC/OS cluster
backup Access DC/OS backup functionality
cluster Manage your DC/OS clusters
config Manage the DC/OS configuration file
help Display help information about DC/OS
job Deploy and manage jobs in DC/OS
license Manage your DC/OS licenses
node View DC/OS node information
package Install and manage DC/OS software packages
security DC/OS security related commands
service Manage DC/OS services
task Manage DC/OS tasks
Get detailed command description with 'dcos <command> --help'.
表 3 - DC/OS Enterprise 命令
DCOS_CONFIG(仅限 DC/OS CLI 0.4.x)
此命令显示 DC/OS 配置文件的路径。如果将 DC/OS 配置文件放入 /home/jdoe/config/dcos.toml
,请使用以下命令设置变量:
export DCOS_CONFIG=/home/jdoe/config/dcos.toml
如果您已经配置了 DCOS_CONFIG
环境变量:
- 在转换为[新配置结构] (#configuration-files) 后,不再接受 。
- 在调用
dcos cluster setup
之前,您可使用dcos config set
更改DCOS_CONFIG
指向的配置。该命令会显示一条警告消息,指出该命令已弃用,建议使用dcos cluster setup
。
列出群集
DC/OS CLI 可以使用以下命令与多个群集配合使用。
以下命令显示最新配置的群集:
如果您希望 DC/OS 配置目录为 /home/jdoe/config
等特定路径,请使用以下命令设置变量:
export DCOS_DIR=/home/jdoe/config
可选择地设置 DCOS_DIR
并运行 dcos cluster setup
命令。
此设置根据 $DCOS_DIR/clusters/<cluster_id>
下的群集配置生成和更新。将新设置的群集设置为已连接的群集。
DCOS_SSL_VERIFY
export DCOS_SSL_VERIFY=false
列出群集
DC/OS CLI 可以与多个群集配合使用。以下命令显示最新配置的群集:
dcos cluster list
NAME ID STATUS VERSION URL
* cluster 26f72c2f-8d03-47d7-b95f-972b1fd3dea2 AVAILABLE 1.12 <cluster-url>
注意:* 表示 CLI 当前已连接到群集名称。如果使用另一个群集再次运行设置命令,您将在列表中看到一个新项目。
该命令向指示级别或更高级别的 stderr
显示日志消息。这相当于 --log-level
命令行选项。严重级别为:
debug
- 向stderr
打印所有消息,包括信息、警告、错误以及关键消息。info
- 向stderr
打印信息、警告、错误和关键消息。warning
- 向stderr
打印警告、错误和关键消息。error
- 向stderr
打印错误和关键消息。critical
- 仅向stderr
打印关键信息。
例如,将日志级别设置为 warning
:
export DCOS_LOG_LEVEL=warning
DCOS_DEBUG
该命令指示是否将其他调试消息打印到 。该参数默认设置为 false
。例如:
Configuring the CLI
配置命令行界面…
DC/OS Enterprise CLI
ENTERPRISE
配置 DC/OS Enterprise 命令行界面…
启用 CLI 自动完成…
Installing the CLI
安装 DC/OS 命令行界面…
Updating the CLI
更新命令行界面…
卸载 DC/OS 命令行界面…
CLI Plugins
如何扩展命令行界面…