本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
自动注销本地实例
通常,当您不再计划部署到某个本地实例之后,您可以注销该实例。在您注销本地实例时,即使本地实例可能属于某个部署组的本地实例标签,该本地实例也不会包括在任何部署中。您可以使用 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 命令执行以下操作:
-
使用 CodeDeploy 取消注册本地实例。
-
如果指定,则删除与本地实例关联的 IAM 用户。
在注销本地实例后,请注意以下情况:
-
它立即停止显示在控制台中。
-
您可以立即创建另一个同名的实例。
如果此命令遇到错误,则将显示错误消息,说明您可以如何手动完成剩余步骤。否则,将显示成功消息,说明如何调用 uninstall 命令。