CLI

了解 DC/OS 中的命令行界面实用程序

DC/OS 命令行界面 (DC/OS CLI) 实用程序允许您管理群集节点、安装和管理软件包、检查群集状态以及管理服务和任务。

DC/OS 1.13 需要 DC/OS CLI >= 0.8。安装时,请遵循这些说明

若要列出可用命令,请运行不带参数的 dcos

  1. $ dcos
  2. Usage:
  3. dcos [command]
  4. Commands:
  5. auth
  6. Authenticate to DC/OS cluster
  7. cluster
  8. Manage your DC/OS clusters
  9. config
  10. Manage the DC/OS configuration file
  11. help
  12. Help about any command
  13. job
  14. Deploy and manage jobs in DC/OS
  15. marathon
  16. Deploy and manage applications to DC/OS
  17. node
  18. View DC/OS node information
  19. package
  20. Install and manage DC/OS software packages
  21. plugin
  22. Manage CLI plugins
  23. service
  24. Manage DC/OS services
  25. task
  26. Manage DC/OS tasks
  27. Options:
  28. --version
  29. Print version information
  30. -v, -vv
  31. Output verbosity (verbose or very verbose)
  32. -h, --help
  33. Show usage help
  34. Use "dcos [command] --help" for more information about a command.

设置群集

要与群集进行交互,首先需要设置 CLI。

若要显示 DC/OS CLI 版本,请运行:

  1. dcos --version

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 中,您可以选择使用 DCOS_CONFIG 环境变量更改配置文件的位置。

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 支持以下环境变量,可以动态设置。

DCOS_CLUSTER (仅限 DC/OS CLI 0.5.x 及更高版本)

连接的群集。要设置连接的群集,请使用以下命令设置变量:

  1. dcos cluster setup <cluster-url>

在完成登录程序后,您的 CLI 已准备好与您的群集进行交互。您会注意到,现在它有其他命令,例如,marathonnodepackage 等。这些命令来自 插件、dcos-core-cli 和 dcos-enterprise-cli(如适用),它将作为设置命令的一部分自动安装。

DCOS_CONFIG(仅限 DC/OS CLI 0.4.x)

此命令显示 DC/OS 配置文件的路径。如果将 DC/OS 配置文件放入 /home/jdoe/config/dcos.toml,请使用以下命令设置变量:

  1. export DCOS_CONFIG=/home/jdoe/config/dcos.toml

如果您已经配置了 DCOS_CONFIG 环境变量:

  • 在转换为[新配置结构] (#configuration-files) 后,不再接受 DCOS_CONFIG
  • 在调用 dcos cluster setup 之前,您可使用 dcos config set 更改 DCOS_CONFIG 指向的配置。该命令会显示一条警告消息,指出该命令已弃用,建议使用 dcos cluster setup

列出群集

DC/OS CLI 可以与多个群集配合使用。以下命令显示最新配置的群集:

DCOS_DIR(仅限 DC/OS CLI 0.5.x 及更高版本)

如果您希望 DC/OS 配置目录为 /home/jdoe/config 等特定路径,请使用以下命令设置变量:

  1. export DCOS_DIR=/home/jdoe/config

可选择地设置 DCOS_DIR 并运行 dcos cluster setup 命令。

  1. ```
  2. export DCOS_DIR=<path/to/config_dir> (optional, default when not set is ~/.dcos)
  3. dcos cluster setup <url>
  4. ```

此设置根据 $DCOS_DIR/clusters/<cluster_id> 下的群集配置生成和更新。将新设置的群集设置为连接的群集。

DCOS_SSL_VERIFY

该命令指示是否验证 SSL 证书或设置 SSL 证书路径。您必须手动设置此变量。设置此环境变量相当于在 DC/OS 配置[文件] (#configuration-files) 中设置 dcos config set core.ssl_verify 选项。例如,指示您想要设置 SSL 证书的路径:

  1. $ dcos cluster list
  2. NAME ID STATUS VERSION URL
  3. * cluster 26f72c2f-8d03-47d7-b95f-972b1fd3dea2 AVAILABLE 1.13 <cluster-url>

注意:* 表示 CLI 当前已连接到群集名称。如果使用另一个群集再次运行设置命令,您将在列表中看到一个新项目。

DCOS_LOG_LEVEL

该命令向指示级别或更高级别的 stderr 显示日志消息。这相当于 —log-level 命令行选项。严重级别为:

  • 调试 将所有消息打印到 stderr,包括信息、警告、错误和关键消息。
  • 信息 将提示信息、警告、错误和关键消息打印到 stderr
  • 警告 将警告、错误和关键消息打印到 stderr
  • 错误 将错误和关键消息打印到 stderr
  • 关键 仅将关键信息打印到 stderr
例如,将日志级别设置为警告:

  1. export DCOS_LOG_LEVEL=warning

DCOS_DEBUG

该命令指示是否将其他调试消息打印到 stdout。该参数默认设置为 false。例如:

  1. export DCOS_DEBUG=true

安装 CLI

安装 DC/OS 命令行界面…Read More

配置 CLI

配置命令行界面…Read More

更新 CLI

更新命令行界面…Read More

卸载 CLI

卸载 DC/OS 命令行界面…Read More

CLI 插件

如何扩展命令行界面…Read More

DC/OS Enterprise CLI

ENTERPRISE

配置 DC/OS Enterprise 命令行界面…Read More

CLI 自动完成

启用 CLI 自动完成…Read More

命令参考

探索 DC/OS 独有的命令…Read More