AWS CodeDeploy
User Guide (API Version 2014-10-06)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

自动注销本地实例

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

注意

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

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

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

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

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

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

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

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

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

例如:

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

deregister 命令执行以下操作:

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

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

当您注销本地实例之后,在 AWS CodeDeploy 删除有关已注销本地实例的记录之前,您无法创建同名的替代本地实例或者相同的关联 IAM 用户名。这通常需要大约 24 个小时。

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