卸载服务

在 CLI 中卸载 DC/OS 服务

可在 CLI 中卸载服务。如果 Universe 服务有任何不能通过正常卸载过程清理的保留资源,也可能需要运行框架清理器脚本。框架清理器脚本 从 ZooKeeper 中删除服务实例以及与其关联的任何数据。

卸载 Universe 服务

CLI

使用以下命令卸载数据中心服务:

  1. dcos package uninstall <servicename>

例如,如需卸载 Chronos:

  1. dcos package uninstall chronos

Web 界面

可在 DC/OS Web 界面的 服务 选项卡中卸载服务。“服务”选项卡为本地 DC/OS Marathon 实例提供了完整的功能界面。

  1. 导航至 DC/OS Web 界面中的 服务 选项卡。

  2. 选择服务,单击最右的垂直椭圆形,然后选择删除

    Destroy app

    图 1. 删除服务

  3. 复制并运行显示的命令。

故障排除

卸载显示以下错误消息时可能失败:

  1. Incomplete uninstall of package [chronos] due to Mesos unavailability

该服务可能处于非活动状态,并且不会显示在 DC/OS UI 中,但可以通过使用以下 CLI 命令查找:

  1. dcos service --inactive
  2. NAME HOST ACTIVE TASKS CPU MEM DISK ID
  3. chronos 10.0.6.138 False 0 0.0 0.0 0.0 7c0a7bd4-3649-4ec1-866c-5db8f2292bf2-0001

可以使用以下指定服务 ID 的 CLI 命令关闭服务,然后运行 框架清理器,从而完成卸载:

  1. dcos service shutdown 7c0a7bd4-3649-4ec1-866c-5db8f2292bf2-0001

卸载用户创建的服务

CLI

使用以下命令卸载用户创建的服务:

  1. dcos marathon app remove [--force] <app-id>

如需更多信息,请参阅 命令名称

Web 界面

可在 服务 选项卡中打开 DC/OS Web 界面,并从中卸载服务。“服务”选项卡为本地 DC/OS Marathon 实例提供了完整的功能界面。

Services 选项卡

  1. 导航至 DC/OS Web 界面中的 服务 选项卡。
  2. 单击 已安装 选项卡查看已安装的服务。
  3. 将光标悬停在要卸载的包的名称上,然后就会看到右侧的红色“卸载”链接。单击此链接卸载包。

清理资源和 ZooKeeper

关于清理

如果服务有保留资源,并且没有自动清理对其进行彻底清理,您可以使用框架清理器的 Docker 镜像——mesosphere/janitor,从 ZooKeeper 中删除服务实例并销毁与其关联的所有数据,简化该流程。在 DC/OS 1.10+ 群集上,仅在极少数情况下(例如卸载失败)需要该流程。 包的文档可能在“卸载”部分有附加信息。

运行框架清理器脚本的方法有两种。首选方法是通过 DC/OS CLI 运行。如果没有 CLI ,也可以将镜像作为自行删除 Marathon 任务运行。

配置清理

脚本采用以下标记:

  • -r <role>:要删除的资源的角色
  • -z <zk-node>:要删除的配置 zookeeper 节点

命令运行如下:

  1. docker run mesosphere/janitor /janitor.py -r <service_name>-role -z dcos-service-<service_name>

如果您正在使用严格模式群集,就必须提供执行清理所需的附加参数:

  • -a <token>:用于认证的令牌
  • --username <username>--password <password>:用于认证的用户名和密码

例如,可以使用含有以下内容的认证令牌运行命令:

  1. docker run mesosphere/janitor /janitor.py -r <service_name>-role -z dcos-service-<service_name> -a <content of "dcos config show core.dcos_acs_token">

通过 DC/OS CLI 运行

连接到首要实例并启动脚本:

  1. 打开群集首要实例的 SSH 会话。

    1. your-machine$ dcos node ssh --master-proxy --leader
  2. 运行 mesosphere/janitor 镜像,该镜像带有为服务配置的角色和 ZooKeeper 节点,并且在严格模式群集中还带有认证令牌:

    1. docker run mesosphere/janitor /janitor.py -r sample-role -z sample-zk [-a auth-token]

通过 Marathon 运行

在 DC/OS 服务 选项卡中,使用 JSON 编辑器将以下内容添加为 Marathon 任务。根据需要清理的内容,替换传递到 -r/-z 的值。

  1. {
  2. id”: "janitor",
  3. "cmd": "/janitor.py -r sample-role -z dcos-service-sample",
  4. CPU”: 1,
  5. "mem": 128,
  6. "disk": 1,
  7. "instances": 1,
  8. "container": {
  9. "docker": {
  10. "image": "mesosphere/janitor:latest",
  11. "network": "HOST"
  12. },
  13. "type": "DOCKER"
  14. }
  15. }

当框架清理器完成工作后,就会自动从 Marathon 中移除,确保仅运行一次。移除操作即便已经成功完成,通常也会导致清理任务出现 TASK_KILLED 甚至是 TASK_FAILED 的结果。清理任务还会从“服务”和“仪表板”选项卡中迅速消失。

验证结果

如需查看脚本的结果,请前往 Mesos(http://your-cluster.com/mesos) 并查看任务的 stdout 内容。如果 stdout 缺少内容,请手动运行以下命令:

确定运行 Docker 任务的代理 ID。示例如下:

  1. your-machine$ dcos node ssh --master-proxy --mesos-id=c62affd0-ce56-413b-85e7-32e510a7e131-S3
  2. agent-node$ docker ps -a
  3. CONTAINER ID IMAGE COMMAND ...
  4. 828ee17b5fd3 mesosphere/janitor:latest /bin/sh -c /janito ...
  5. agent-node$ docker logs 828ee17b5fd33

示例结果

以下是成功运行样本安装的输出示例:

  1. your-machine$ dcos node ssh --master-proxy --leader
  2. leader-node$ docker run mesosphere/janitor /janitor.py -r sample_role -z dcos-service-sample
  3. [... docker download ...]
  4. Master: http://leader.mesos:5050/master/ Exhibitor: http://leader.mesos:8181/ Role: sample_role ZK Path: sample
  5. Destroying volumes...
  6. Mesos version: 0.28.1 => 28
  7. Found 1 volume(s) for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S5, deleting...
  8. 200
  9. Found 1 volume(s) for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S4, deleting...
  10. 200
  11. No reserved resources for any role on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S3
  12. No reserved resources for any role on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S2
  13. Found 1 volume(s) for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S1, deleting...
  14. 200
  15. No reserved resources for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S0. Known roles are: [slave_public]
  16. Unreserving resources...
  17. Found 4 resource(s) for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S5, deleting...
  18. 200
  19. Found 4 resource(s) for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S4, deleting...
  20. 200
  21. No reserved resources for any role on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S3
  22. No reserved resources for any role on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S2
  23. Found 4 resource(s) for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S1, deleting...
  24. 200
  25. No reserved resources for role 'sample_role' on slave 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S0. Known roles are: [slave_public]
  26. Deleting zk node...
  27. Successfully deleted znode 'dcos-service-sample' (code=200), if znode existed.
  28. Cleanup completed successfully.

如果通过 Marathon 运行脚本,您还会看到以下输出:

  1. Deleting self from Marathon to avoid run loop: /janitor
  2. Successfully deleted self from marathon (code=200): /janitor