AWS CodeDeploy
用户指南 (API 版本 2014-10-06)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

自动注销本地实例

通常,当您不再计划部署到某个本地实例之后,您可以注销该实例。在您注销本地实例时,即使本地实例可能属于某个部署组的本地实例标签,该本地实例也不会包括在任何部署中。您可以使用 AWS CLI 注销本地实例。

注意

您不能使用 CodeDeploy 控制台注销本地实例。此外,取消注册本地实例不会取消关联与本地实例关联的任何本地实例标签。此操作不会从本地实例中卸载 CodeDeploy 代理。此操作不会从本地实例中删除本地实例配置文件。

要使用 CodeDeploy 控制台执行此部分中的一些(而非全部)活动,请参阅 手动注销本地实例 的 CodeDeploy 控制台部分。

要手动取消任何已关联本地实例标签的关联,请参阅从本地实例中手动删除本地实例标签

要自动卸载 CodeDeploy 代理并删除本地实例中的配置文件,请参阅自动从本地实例卸载 CodeDeploy 代理并删除配置文件

要仅从本地实例手动卸载 CodeDeploy 代理,请参阅管理 CodeDeploy 代理操作

使用 AWS CLI 调用 deregister 命令,在命令中指定:

  • 唯一标识 CodeDeploy 的本地实例的名称(使用 --instance-name 选项)。

  • (可选)是否删除与本地实例关联的 IAM 用户(默认情况下,使用 --delete-iam-user 选项)。如果您不希望删除与本地实例关联的 IAM 用户,请指定 --no-delete-iam-user 选项。

  • (可选)其中向 CodeDeploy 注册本地实例的 AWS 区域(使用 --region 选项)。这必须是 AWS General Reference区域和终端节点中列出的支持区域之一(例如,us-west-2)。如果未指定此选项,则将使用与发出调用的 IAM 用户关联的默认 AWS 区域。

例如:

aws deploy deregister --instance-name AssetTag12010298EX --delete-iam-user --region us-west-2

deregister 命令执行以下操作:

  1. 使用 CodeDeploy 注销本地实例。

  2. 如果指定,则删除与本地实例关联的 IAM 用户。

如果此命令遇到错误,则将显示错误消息,说明您可以如何手动完成剩余步骤。否则,将显示成功消息,说明如何调用 uninstall 命令。