使用 dcos task exec

BETA

在任务容器内使用 dcos task exec 命令

dcos task exec 命令让您可以在任务的容器内执行任意命令，并将其输出返回到本地终端，以了解有关某个特定任务如何表现的更多信息。它提供了非常类似于 docker exec 体验，不需要 SSH 密钥。

要使用调试功能，必须使用 Mesos 容器运行时或通用容器运行时来启动服务或作业。调试不能用于用 Docker 运行时启动的容器。如需更多信息，请参阅 使用 Mesos 容器化工具。

您可以在下列模式下执行此命令。

  • dcos task exec <task-id> <command>（无标记）：将 STDOUT 和 STDERR 作为原始字节从远程终端传输到本地终端。

  • dcos task exec --tty <task-id> <command>：将 STDOUT 和 STDERR 从远程终端传输到本地终端，但不作为原始字节。相反，此选项将本地终端置于原始模式，分配远程伪终端 (PTY)，并通过远程 PTY 来传输 STDOUT 和 STDERR。

  • dcos task exec --interactive <task-id> <command> 将 STDOUT 和 STDERR 从远程终端传输到本地终端，并将 STDIN 从本地终端传输到远程命令。

  • dcos task exec --interactive --tty <task-id> <command>：将 STDOUT 和 STDERR 从远程终端传输到本地终端，并将 STDIN 从本地终端传输到远程终端。此外，还将本地终端置于原始模式，分配远程伪终端 (PTY)，并通过远程 PTY 传输 STDOUT、STDERR 和 STDIN。此模式提供最大功能。

有关 dcos task exec 命令的更多信息，请参阅 CLI 参考部分。

提示

  • 为方便查看，我们已经包含了上述完整标记的文本，但每一个都可以缩短。不是输入 --interactive，您只需输入 -i。同样，不是输入 --tty，您只需输入 -t。
  • 如果您的模式传输原始字节，您将无法启动 vim 等类似程序，因为这些程序需要使用控制字符。

快速入门

使用本指南开始使用 dcos task exec 调试命令。

先决条件：

使用在容器内运行的命令传送输出

您可以使用 dcos task exec 命令在容器内运行命令。此例中，启动了一个长期运行的 Marathon 应用程序，然后使用 dcos task exec 命令获取运行此应用程序的节点的主机名。

  1. 创建 Marathon 应用定义，并使用以下内容为其命名 my-app.json：

    1. {
    2.    "id": "/my-app",
    3.    "cmd": "sleep 100000000",
    4.    "cpus": 1,
    5.    "instances": 1
    6.  }

  2. 在 DC/OS 上部署服务：

    1. dcos marathon app add my-app.json

  3. 使用此 CLI 命令获取作业的任务 ID：

    1. dcos task

    输出应与此类似：

    1. NAME        HOST        USER  STATE  ID                                               
    2. my-app      10.0.1.106  root    R    <task_id>

  4. 运行此命令以显示运行应用程序的容器的主机名，其中 <task-ID> 是您的任务 ID。

    1. dcos task exec <task_id> hostname

    输出应与此类似：

    1. ip-10-0-1-105.us-west-2.compute.internal

有关 dcos task exec 命令的更多信息，请参阅 CLI 参考部分。

在任务容器内运行交互命令

您可以使用 dcos task exec 命令，在群集中的机器上运行交互命令。此例中，dcos task exec 命令用来将简单脚本从本地计算机复制到节点上的任务容器。然后使用 dcos task exec 命令对脚本进行管理。

  1. 创建 Marathon 应用定义，并使用以下内容为其命名 my-interactive-app.json：

    1. {
    2.    "id": "/my-interactive-app",
    3.    "cmd": "sleep 100000000",
    4.    "cpus": 1,
    5.    "instances": 1
    6. }

  2. 在 DC/OS 上部署应用程序：

    1. dcos marathon app add my-interactive-app.json

  3. 使用此 CLI 命令获取应用程序的任务 ID：

    1. dcos task

    输出应与此类似：

    1. NAME                HOST        USER  STATE  ID                                               
    2. my-interactive-app  10.0.1.106  root    R    <task_id>

  4. 用以下内容编写名为 hello-world.sh 的脚本：

    1. echo "Hello World"

  5. 将脚本上传到任务容器：

    1. cat hello-world.sh | dcos task exec -i <task_id> bash -c "cat > hello-world.sh"

  6. 提供文件可执行权限：

    1. dcos task exec <task_id> chmod a+x hello-world.sh

  7. 在容器内运行脚本：

    1. dcos task exec <task_id> ./hello-world.sh

    输出应与此类似：

    1. Hello World

启动长期运行的交互式 Bash 会话

此例中，长期运行的 作业 通过使用 dcos job run 命令来启动，dcos task exec 命令用于在该作业的容器内启动交互式 Bash shell。

  1. 使用 DC/OS CLI 部署和运行作业：

    1. 创建以下应用定义并另存为 my-job.json。这将指定运行 10000000 秒的休眠作业。

      1. {
      2.   "id": "my-job",
      3.   "labels": {},
      4.   "run": {
      5.     "artifacts": [],
      6.     "cmd": "sleep 100000000",
      7.     "cpus": 0.01,
      8.     "disk": 0,
      9.     "env": {},
      10.     "maxLaunchDelay": 3600,
      11.     "mem": 32,
      12.     "placement": {
      13.       "constraints": []
      14.     },
      15.     "restart": {
      16.       "policy": "NEVER"
      17.     },
      18.     "volumes": []
      19.   }
      20. }

    2. 使用此 CLI 命令部署该作业：

      1. dcos job add my-job.json

    3. 验证作业是否已成功部署：

      1. dcos job list

      输出应类似于：

      1. ID      DESCRIPTION  STATUS       LAST SUCCESFUL RUN        
      2. my-job               Unscheduled         None

    4. 运行作业：

      1. dcos job run my-job

  2. 使用此 CLI 命令获取作业的任务 ID：

    1. dcos task

    输出应与此类似：

    1. NAME                          HOST       USER  STATE  ID                                                                       
    2. 20161209183121nz2F5.my-job    10.0.2.53  root    R    <task_id>

  3. 在容器内部启动一个指定了任务 ID（<task_id>）的进程，并将 TTY 附加到该进程。这将启动交互式 Bash 会话。

    1. dcos task exec --interactive --tty <task_id> bash

    您现在应该是位于运行交互式 Bash 会话 的容器内部。

    1. root@ip-10-0-2-53 / #

  4. 从交互式 Bash 会话运行一个命令。例如 ls 命令：

    1. root@ip-10-0-1-104 / # ls
    2. bin   dev  home  lib64         media  opt   root    sbin  sys  usr
    3. boot  etc  lib     lost+found  mnt    proc  run    srv   tmp  var

提示

您可以将简化缩写 -i 用于 --interactive 或将 -t 用于 --tty。此外，只需要 <task_id> 的开头唯一字符。例如，如果您的任务 ID 是 exec-test_20161214195 并且没有以字母 e 开头的其他任务 ID，则有效的命令语法如下：dcos task exec -i -t e bash。如需更多信息，请参阅 CLI 命令 参考。