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

卸载 Catalog 服务

CLI

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

dcos package uninstall <servicename>

例如，如需卸载 Chronos：

dcos package uninstall chronos

Web 界面

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

导航至 DC/OS Web 界面中的服务选项卡。
选择服务，单击最右的垂直省略号，然后选择删除。

图 1. 删除服务
复制并运行显示的命令。

故障排除

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

Incomplete uninstall of package [chronos] due to Mesos unavailability

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

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

可以使用以下指定服务 ID 的 CLI 命令关闭服务，然后运行 [框架清理器](#framework-cleaner），从而完成卸载：

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

卸载用户创建的服务

CLI

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

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

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

Web 界面

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

Services 选项卡

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

清理资源和 ZooKeeper

关于清理

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

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

配置清理

脚本采用以下标记：

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

命令运行如下：

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

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

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

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

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 运行

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

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

 your-machine$ dcos node ssh --master-proxy --leader

运行 mesosphere/janitor 镜像，该镜像带有为服务配置的角色和 ZooKeeper 节点，并且在严格模式群集中还带有认证令牌：
```
 docker run mesosphere/janitor /janitor.py -r sample-role -z sample-zk [-a auth-token]
```

通过 Marathon 运行

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

{
  "id": "janitor",
  "cmd": "/janitor.py -r sample-role -z dcos-service-sample",
  “CPU”: 1,
  "mem": 128,
  "disk": 1,
  "instances": 1,
  "container": {
    "docker": {
      "image": "mesosphere/janitor:latest",
      "network": "HOST"
    },
    "type": "DOCKER"
  }
}

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

验证结果

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

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

your-machine$ dcos node ssh --master-proxy --mesos-id=c62affd0-ce56-413b-85e7-32e510a7e131-S3

agent-node$ docker ps -a
容器 ID        镜像                       命令             ...
828ee17b5fd3        mesosphere/janitor:latest   /bin/sh -c /janito  ...

agent-node$ docker logs 828ee17b5fd3

示例结果

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

your-machine$ dcos node ssh --master-proxy --leader

leader-node$ docker run mesosphere/janitor /janitor.py -r sample_role -z dcos-service-sample
[... docker 下载 ...]
管理节点： http://leader.mesos:5050/master/ Exhibitor: http://leader.mesos:8181/ Role: sample_role ZK Path: sample

正在销毁卷...
Mesos version: 0.28.1 => 28
在从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S5 上找到 1 个“sample_role”卷，正在删除：
200
在从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S4 上找到 1 个“sample_role” 卷，正在删除...
200
从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S3 未保留资源给任何角色
从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S2 未保留资源给任何角色
在从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S1 上找到 1 个“sample_role” 卷，正在删除...
200
从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S0 未保留资源给任何角色。已知角色为：[slave_public]

不会保留资源...
在从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S5 上找到 4 个角色“sample_role” 的资源，正在删除...
200
在从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S4 上找到 4 个角色“sample_role” 的资源，正在删除...
200
从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S3 未保留资源给任何角色
从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S2 未保留资源给任何角色
在从节点  3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S1 上找到 4 个角色“sample_role” 的资源，正在删除...
200
从节点 3ce447e3-2894-4c61-bd0f-be97e4d99ee9-S0 未保留资源给任何角色。已知角色为：[slave_public]

正在删除 zk 节点...
成功删除存在的 z 节点 'dcos-service-sample' (代码=200)。
顺利完成清理。

如果从 Marathon 运行脚本，您还会看到以下输出：

从 Marathon 删除自己以免运行环路：/janitor
已成功从 Marathon 删除自己（代码=200）：/janitor

卸载服务

在 CLI 中卸载 DC/OS 服务

卸载 Catalog 服务

CLI

Web 界面

故障排除

卸载用户创建的服务

CLI

Web 界面

Services 选项卡

清理资源和 ZooKeeper

关于清理

配置清理

通过 DC/OS CLI 运行

通过 Marathon 运行

验证结果

示例结果