オンプレミスインスタンスを自動的に登録解除します

通常は、デプロイする計画がなくなった後、オンプレミスインスタンスの登録を解除します。オンプレミスインスタンスの登録を解除すると、オンプレミスインスタンスがデプロイグループのオンプレミスインスタンスタグの一部であっても、オンプレミスインスタンスはデプロイには含まれなくなります。を使用して AWS CLI 、オンプレミスインスタンスの登録を解除できます。

注記

CodeDeploy コンソールを使用してオンプレミスインスタンスを登録解除することはできません。また、オンプレミスインスタンスの登録を解除しても、オンプレミスインスタンスに関連付けられたオンプレミスインスタンスタグは解除されません。オンプレミスインスタンスから CodeDeploy エージェントをアンインストールしません。オンプレミスインスタンスの設定ファイルはオンプレミスインスタンスから削除されません。

CodeDeploy コンソールを使用してこのセクションのアクティビティの一部 (すべてではない) を実行するには、 の CodeDeploy コンソールセクションを参照してください手動でオンプレミスのインスタンスの登録を解除します。

オンプレミスインスタンスタグの関連付けを手動で解除するには、オンプレミスインスタンスから手動でオンプレミスインスタンスタグを削除します を参照してください。

CodeDeploy エージェントを自動的にアンインストールし、オンプレミスインスタンスから設定ファイルを削除するには、「」を参照してください CodeDeploy エージェントを自動的にアンインストールし、オンプレミスインスタンスから設定ファイルを削除する。

オンプレミスインスタンスから CodeDeploy エージェントのみを手動でアンインストールするには、「」を参照してください CodeDeploy エージェントオペレーションの管理。

を使用して AWS CLI 登録解除コマンドを呼び出し、以下を指定します。

• オンプレミスインスタンスを に一意に識別する名前 CodeDeploy ( --instance-nameオプションを指定）。

• 必要に応じて、オンプレミスインスタンスに関連付けられた IIAM ユーザーを削除するかどうか デフォルトの動作では、IAM ユーザーが削除されます。オンプレミスインスタンスに関連付けられた IAM ユーザーを削除しない場合は、コマンドで --no-delete-iam-user オプションを指定します。

• オプションで、オンプレミスインスタンスが に登録 CodeDeployされた AWS リージョン ( --regionオプションを指定）。これは、「AWS 全般のリファレンス」(例: us-west-2) の「リージョンエンドポイント」にリストされているサポート対象のリージョンの 1 つである必要があります。このオプションを指定しない場合、呼び出し元の 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 コマンドを呼び出す方法が説明されます。