安装命令行界面

安装命令行界面来执行日常任务（第 2 部分）

DC/OS 命令行界面（CLI）为您提供一种方便的方式来执行管理任务、检索组件和操作信息以及监控群集状态和活动。

虽然您可以使用基于 DC/OS Web 的控制台以交互方式执行许多相同的任务，或者使用对 DC/OS 应用程序编程接口 (API) 的调用以编程方式执行许多任务，但大多数群集操作员都以交互式或脚本中的方式使用命令行程序来管理大部分常见群集操作和群集相关的活动。

开始之前

在开始本教程前，您应验证以下内容：

  • 您必须能够从托管 CLI 的计算机上访问带有至少一个管理节点和三个代理节点的配置正确的 DC/OS 群集。
  • 您必须拥有具有本地操作系统管理权限的帐户。
  • 您必须能够在托管 CLI 的计算机上打开命令行 shell。
  • 您必须能够在托管 CLI 的计算机上运行客户端 URL () 程序。
  • 在开始安装之前，您必须禁用任何安全或防病毒软件（仅 Windows）。

学习目的

完成本教程，您将学习到：

  • 如何直接从包资源库安装 DC/OS 命令行界面 (CLI)
  • 如何使用 DC/OS CLI 从本地计算机上的终端 shell 连接到群集。
  • 如何使用 CLI 命令执行常见管理任务。

安装 DC/OS CLI

  1. 在要安装 DC/OS 命令行界面 (CLI) 的计算机上打开终端 shell。

  2. 打开 Web 浏览器并导航到 DC/OS 基于 Web 控制台的 URL。

  3. 单击 DC/OS 基于 Web 控制台右上角的群集名称菜单。

  4. 从群集名称菜单中 ，选择 安装 CLI。

  5. 单击要安装 CLI 的计算机的相应操作系统选项卡。

  6. 遵循操作系统选项卡上显示的说明。

  7. 在本地主机计算机上键入管理帐户的密码。

  8. 键入群集管理帐户的用户名和密码。

    群集的默认管理用户名为 bootstrapuser。帐户的默认密码为 deleteme。

  9. 通过运行以下命令来验证您可以从命令行连接到群集：

    如果群集可用且 CLI 安装成功完成，那么命令会返回与以下内容类似的群集基本信息：

    1. NAME                        ID                    STATUS    VERSION                                       URL                                       
    2. *  lgunn-sidebet  351c8aa0-880e-459a-9483-cd6a4ab4391e  AVAILABLE  1.13.0   http://lgunn-sid-elasticl-1lqsarfasaw88-301095172.us-west-2.elb.amazonaws.com

  10. 关闭 DC/OS 基于 Web 管理控制台中的“安装 CLI”对话框。

验证登录凭据

您可以通过运行以下命令验证帐户是否有权连接到群集：

    最初，只有默认群集管理帐户才有权连接到群集。当您授权其他用户访问群集并替换默认群集管理帐户和密码时，您可以通过运行 dcos auth login 命令来验证其对群集的访问。

    验证群集上运行的服务

    安装 DC/OS CLI 之后，有许多命令可供您用于检查群集的状态并执行常规管理任务。

    例如，您可以通过运行以下命令来检查运行服务列表：

    如果您刚刚完成了前一个教程，且尚未安装任何其他服务，此命令会返回类似于以下内容的信息：

    1. NAME          HOST    ACTIVE  TASKS  CPU  MEM  DISK  ID                                         
    3. metronome  10.0.4.82   True     0    0.0  0.0  0.0   ec31ddcf-1e31-4556-9f3b-9a56e172b6ef-0000
    • marathon 服务是 DC/OS 群集的基本组件，为 DC/OS 核心提供初始化服务。
    • metronome 服务提供类似于 DC/OS 群集的 cron 程序的基本调度和作业管理。

    在您部署其他服务时，您可以使用 dcos service 命令来验证这些服务的状态。

    检查已连接节点的状态

    您可以使用 DC/OS 命令行界面来检查已连接节点的状态并返回日志信息。作为搜索 DC/OS 群集的起点，您可能需要运行 dcos node list 命令。

    1. dcos node list

    此命令返回有关群集中已连接代理和管理节点的基本信息。例如：

    您还可能希望搜索单个节点的日志。例如，您可以通过运行命令 来检索有关当前管理节点领导者的详细信息。

    此命令将返回记录在领导管理节点的日志消息中的信息。记录的消息为此示例条目提供信息：

    1. 2019-05-27 18:47:51 UTCbouncer.sh [2847]: 10.0.4.82 [27/May/2019:18:47:51 +0000] "GET /acs/api/v1/internal/policyquery?rid=dcos:adminrouter:ops:mesos&uid=dcos_history_service&action=full HTTP/1.0" 200 22 "-" "Master Admin Router" (0.001926 s)

    同样，您可以通过运行类似于以下内容的命令来检索有关特定节点的详细信息：

    1. dcos node log --mesos-id ec31ddcf-1e31-4556-9f3b-9a56e172b6ef-S1

    在本示例中，ec31ddcf-1e31-4556-9f3b-9a56e172b6ef-S1 是代理标识符 (ID)。您可以使用 dcos node list 命令查找代理标识符，然后检索代理的日志信息。然后，您可以使用返回的信息来跟踪代理活动、分析操作或排除潜在问题。

    获取 CLI 程序的使用信息

    要浏览通过 DC/OS CLI 选项可用的信息类型，请输入 dcos help 命令。此帮助选项汇总了可用的顶级命令。例如：

    然后，您可以使用单个命令的 --help 选项来查看有关特定命令的使用信息。例如，您可以运行 dcos node --help 来查看有关特定 命令和参数的信息。有关使用 DC/OS 命令行界面的更多信息，请参阅 。

    后续步骤

    祝贺您！您已使用 DC/OS CLI 成功连接到您的群集，可以开始使用 DC/OS 命令行界面来查看某些可用的任务和信息。

    接下来的教程探讨可以通过 DC/OS 基于 Web 的管理控制台或命令行界面执行的其他入门任务：

    相关主题

    • 启动并监控 DC/OS 应用程序和服务。
    • Apache Mesos 是 DC/OS 的核心，负责低级别任务的维护。
    • 在群集内提供服务发现。
    • DC/OS Net 提供网络服务，例如，DC/OS 内部第 4 层负载均衡器。
    • 是存储 DC/OS 服务的包资源库，例如，Apache Spark 或 Apache Cassandra，您可以直接从 DC/OS 基于 Web 的控制台或命令行界面 (CLI) 将其安装到集群上。