CLI 规范

使用命令行界面

是管理集群节点、安装和管理包、检查集群状态，以及管理服务和任务的实用程序。DC/OS CLI 开放且可扩展：任何人都可以创建新子命令，可供最终用户安装。例如，Spark DC/OS 服务 提供了可用 Spark 的 CLI 扩展。安装后，您可以键入以下命令以提交 Spark 作业并查询其状态：

DC/OS CLI 发现子命令的方式

运行 命令时，它会在~/.dcos/clusters/subcommands/env/bin 目录中搜索当前 shell 的“路径”中的前缀为 dcos- 的可执行文件。

如需安装 CLI 子命令，请运行：

  1.  dcos package install <package>

或

    DC/OS 服务和 CLI 子命令同样采用 打包格式和资料库 。

    注意: CLI 模块为 且存储于 ~/.dcos/clusters//subcommands。必须为每个集群安装 CLI 模块。例如，如果连接到集群 1 并安装 Spark 模块，则连接到也运行 Spark 的集群 2。在安装该集群的模块之前，Spark CLI 命令不可用。

    标准标记

    必须为每个DC/OS CLI 子命令分配一组如下标准标记：

    –info

    --info 标记显示一行简短描述，描述了子命令的功能。该内容在用户运行 dcos help 时显示。

    Spark CLI 的示例：
    1. dcos spark --info

    运行没有参数的 dcos 命令时，就会为每条子命令返回该信息：

    1. dcos | grep spark
    2.       spark        Spark DC/OS CLI Module

    –help 和 -h

    --help 和 -h 标记均显示子命令的详细使用情况。

    Marathon CLI 示例：

    DC/OS CLI 子命令命名规范为：

    1.  dcos <subcommand> <resource> <verb>
    1.  dcos marathon app add

    子命令记录

    环境变量 DCOS_LOG_LEVEL 设置为用户在命令行中设置的日志级别。

    中描述了日志记录级别：调试、信息、警告、错误和关键。

    要使您的子命令可供最终用户使用,将软件包条目添加到 Mesosphere Universe 存储库。参见规范的 Universe 说明书。包条目必须包含名为 的文件，其中包含可执行子命令的链接。

    运行 dcos package install <package> --cli 时：

    1. 就会从存储库中 检索要添加的软件包条目。
    2. 用户平台的可执行文件已下载。

    DC/OS CLI 模块

    具有一套用于子命令开发人员的工具。

    Hello World 示例 执行称为 的新子命令：