外部インスタンスの登録を解除する

外部インスタンスの使用が終了したら、Amazon ECS と AWS Systems Managerをインスタンスから登録解除することをお勧めします。登録解除後、コンテナインスタンスは新しいタスクを受けることができなくなります。

登録解除するときにコンテナインスタンスでタスクが実行されている場合、インスタンスを削除するかタスクが他の手段で停止するまで、これらのタスクは実行されたままになります。ただし、これらのタスクは Amazon ECS によるモニタリングや情報収集の対象外になります。外部インスタンス上のこれらのタスクが Amazon ECS サービスに含まれる場合、サービススケジューラは、可能であれば、別のコンテナインスタンスでそのタスクの別のコピーを開始します。

外部インスタンスを新しいクラスターに登録するには、外部インスタンスが Amazon ECS と Systems Manager の両方から登録解除された後、インスタンスの残りの AWS リソースをクリーンアップして新しいクラスターに登録します。

AWS Management Console

1. コンソール (https://console.aws.amazon.com/ecs/v2) を開きます。

2. ナビゲーションバーから、外部インスタンスが存在するリージョンを選択します。

3. ナビゲーションペインで [Clusters] (クラスター) を選択し、外部インスタンスをホストするクラスターを選択します。

4. [Cluster : name] (クラスター: 名前) のページで、[Infrastructure] (インフラストラクチャ) タブを選択します。

5. [Container instances] (コンテナインスタンス)で、登録解除する外部のインスタンス ID を選択します。コンテナインスタンスの詳細ページにリダイレクトされます。

6. [Container Instance : id] (コンテナインスタンス: id) ページで、[Deregister] (登録解除) を選択します。

7. 登録解除メッセージを確認します。[Deregistered from AWS Systems Manager]を選択して、外部インスタンスを Systems Manager 管理対象インスタンスとして登録解除することもできます。[Deregister] (登録解除) を選択します。

   注記

   Systems Manager コンソールで、外部インスタンスを Systems Manager 管理対象インスタンスとして登録解除できます。手順については、AWS Systems Manager ユーザーガイドの管理対象インスタンスの登録を解除するを参照してください。

8. インスタンスの登録を解除したら、オンプレミスサーバーまたは VM の AWS リソースをクリーンアップします。

   オペレーティングシステム	ステップ
   Linux	インスタンスの Amazon ECS コンテナエージェントと SSM Agent サービスを停止します。 sudo systemctl stop ecs amazon-ssm-agent Amazon ECS パッケージおよびSystems Manager パッケージを削除します。 CentOS 7、CentOS 8、および RHEL 7 の場合 sudo yum remove -y amazon-ecs-init amazon-ssm-agent SUSE Linux Enterprise Server 15 の場合 sudo zypper remove -y amazon-ecs-init amazon-ssm-agent Ubuntu と Debian の場合 sudo apt remove -y amazon-ecs-init amazon-ssm-agent 残ったディレクトリを削除します。 sudo rm -rf /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm
   Windows	インスタンスの Amazon ECS コンテナエージェントと SSM Agent サービスを停止します。 Stop-Service AmazonECS Stop-Service AmazonSSMAgent Amazon ECS パッケージを削除します。 .\ecs-anywhere-install.ps1 -Uninstall

AWS CLI

1. コンテナインスタンスを登録解除するには、インスタンス ID とコンテナインスタンス ARN が必要です。これらの値がない場合は、次のコマンドを実行してください

   次のコマンドを実行して、インスタンス ID を取得します。

   インスタンス ID (instanceID) を使用し、コンテナインスタンス ARN (containerInstanceARN) を取得します。

   instanceId=$(aws ssm describe-instance-information --region "{{ region }}" | jq ".InstanceInformationList[] |select(.IPAddress==\"{{ IPv4 Address }}\") | .InstanceId" | tr -d'"'

   以下のコマンドを実行します。

   インスタンス (deregister-container-instance) を登録解除するには、コマンドのパラメータとして containerInstanceArn を使用します。

   instances=$(aws ecs list-container-instances --cluster "{{ cluster }}" --region "{{ region }}" | jq -c '.containerInstanceArns')
   containerInstanceArn=$(aws ecs describe-container-instances --cluster "{{ cluster }}" --region "{{ region }}" --container-instances $instances | jq ".containerInstances[] | select(.ec2InstanceId==\"{{ instanceId }}\") | .containerInstanceArn" | tr -d '"')

2. 次のコマンドを実行して、インスタンスをドレインします。

   aws ecs update-container-instances-state --cluster "{{ cluster }}" --region "{{ region }}" --container-instances "{{ containerInstanceArn }}" --status DRAINING

3. コンテナインスタンスのドレインが終了したら、次のコマンドを実行してインスタンスを登録解除します。

   aws ecs deregister-container-instance --cluster "{{ cluster }}" --region "{{ region }}" --container-instance "{{ containerInstanceArn }}"

4. 次のコマンドを実行し、SSM からコンテナインスタンスを削除します。

   aws ssm deregister-managed-instance --region "{{ region }}" --instance-id "{{ instanceId }}"

5. インスタンスの登録を解除したら、オンプレミスサーバーまたは VM の AWS リソースをクリーンアップします。

   オペレーティングシステム	ステップ
   Linux	インスタンスの Amazon ECS コンテナエージェントと SSM Agent サービスを停止します。 sudo systemctl stop ecs amazon-ssm-agent Amazon ECS パッケージおよびSystems Manager パッケージを削除します。 sudo (yum/apt/zypper) remove amazon-ecs-init amazon-ssm-agent 残ったディレクトリを削除します。 sudo rm -rf /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm
   Windows	インスタンスの Amazon ECS コンテナエージェントと SSM Agent サービスを停止します。 Stop-Service AmazonECS Stop-Service AmazonSSMAgent Amazon ECS パッケージを削除します。 .\ecs-anywhere-install.ps1 -Uninstall