自动注销本地实例 - AWS CodeDeploy

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

自动注销本地实例

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

注意

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

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

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

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

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

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

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

  • (可选)是否删除与本地实例关联的 IAM 用户。默认行为是删除 IAM 用户。如果您不希望删除与本地实例关联的 IAM 用户,请在命令中指定 --no-delete-iam-user 选项。

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

注销实例并删除用户的示例:

aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2

注销实例但不删除用户的示例:

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

deregister 命令执行以下操作:

  1. 使用 CodeDeploy 取消注册本地实例。

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

在注销本地实例后,请注意以下情况:

  • 它立即停止显示在控制台中。

  • 您可以立即创建另一个同名的实例。

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