Annulation de l'enregistrement d'une instance externe Amazon ECS

Nous vous recommandons de désenregistrer l'instance à la fois auprès d'Amazon ECS et une AWS Systems Manager fois que vous en aurez terminé avec l'instance. Après l'annulation de l'enregistrement, l'instance externe n'est plus en mesure d'accepter de nouvelles tâches.

Si des tâches sont en cours d'exécution sur l'instance de conteneur lorsque vous annulez l'enregistrement, ces tâches restent en cours d'exécution jusqu'à ce que vous les arrêtiez d'une autre manière. Toutefois, ces tâches ne sont plus surveillées ou prise en compte par Amazon ECS. Si ces tâches sur votre instance externe font partie d'un Amazon ECS service, le planificateur de service commence une autre copie de cette tâche sur une autre instance de conteneur, si possible.

Après avoir désenregistré l'instance, nettoyez les AWS ressources restantes sur l'instance. Vous pouvez ensuite l'enregistrer dans un nouveau cluster.

Procédure

AWS Management Console

1. Ouvrez la console à partir de l'adresse https://console.aws.amazon.com/ecs/v2.

2. Dans la barre de navigation, choisissez la région dans laquelle votre instance externe est inscrite.

3. Dans le panneau de navigation, choisissez Clusters, puis sélectionnez le cluster qui héberge l'instance externe.

4. Sur la page Cluster : name (Cluster : nom), choisissez l'onglet Infrastructure.

5. Sous Constainer instances (Instances de conteneur), sélectionnez l'ID de l'instance externe pour annuler l'enregistrement. Vous êtes redirigé vers la page de détails de l'instance de conteneur.

6. Sur la page Container Instance : id (Instance de conteneur : id), choisissez Deregister (Annuler l'enregistrement).

7. Passez en revue le message d'annulation d'enregistrement. Sélectionnez Deregister from AWS Systems Manager(Annuler l'enregistrement AWS Systems Manager) pour également annuler l'enregistrement de l'instance externe en tant qu'instance gérée par Systems Manager. Choisissez Deregister (Annuler l'enregistrement).

   Note

   Vous pouvez annuler l'enregistrement de l'instance externe en tant qu'instance gérée par Systems Manager dans la console Systems Manager. Pour obtenir des instructions, consultez Annuler l'enregistrement des instances géréesdans le Guide de l'utilisateur AWS Systems Manager .

8. Après avoir désenregistré l'instance, nettoyez les AWS ressources sur votre serveur local ou sur votre machine virtuelle.

   Système d’exploitation	Étapes
   Linux	Arrêtez l'agent de conteneur Amazon ECS et les services SSM Agent sur l'instance. sudo systemctl stop ecs amazon-ssm-agent Supprimez les packages Amazon ECS et Systems Manager. Pour CentOS 7, CentOS 8 et RHEL 7 sudo yum remove -y amazon-ecs-init amazon-ssm-agent Pour SUSE Enterprise Server 15 sudo zypper remove -y amazon-ecs-init amazon-ssm-agent Pour Debian et Ubuntu sudo apt remove -y amazon-ecs-init amazon-ssm-agent Supprimez les répertoires restants. sudo rm -rf /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm
   Windows	Arrêtez l'agent de conteneur Amazon ECS et les services SSM Agent sur l'instance. Stop-Service AmazonECS Stop-Service AmazonSSMAgent Supprimez le package Amazon ECS. .\ecs-anywhere-install.ps1 -Uninstall

AWS CLI

1. Vous avez besoin de l'ID d'instance et de l'ARN de l'instance de conteneur pour annuler l'enregistrement de l'instance de conteneur. Si vous n'avez pas ces valeurs, exécutez les commandes suivantes.

   Exécutez la commande suivante pour obtenir l'ID d'instance.

   Vous utilisez l'ID d'instance (instanceID) pour obtenir l'ARN de l'instance de conteneur (containerInstanceARN).

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

   Exécutez les commandes suivantes.

   Vous utilisez l'containerInstanceArn comme paramètre dans la commande pour annuler l'enregistrement de l'instance (deregister-container-instance).

   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. Exécutez la commande suivante pour purger l'instance.

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

3. Une fois le drainage de l'instance de conteneur terminé, exécutez la commande suivante pour annuler son enregistrement.

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

4. Exécutez la commande suivante pour supprimer l'instance de conteneur de SSM.

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

5. Après avoir désenregistré l'instance, nettoyez les AWS ressources sur votre serveur local ou sur votre machine virtuelle.

   Système d’exploitation	Étapes
   Linux	Arrêtez l'agent de conteneur Amazon ECS et les services SSM Agent sur l'instance. sudo systemctl stop ecs amazon-ssm-agent Supprimez les packages Amazon ECS et Systems Manager. sudo (yum/apt/zypper) remove amazon-ecs-init amazon-ssm-agent Supprimez les répertoires restants. sudo rm -rf /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm
   Windows	Arrêtez l'agent de conteneur Amazon ECS et les services SSM Agent sur l'instance. Stop-Service AmazonECS Stop-Service AmazonSSMAgent Supprimez le package Amazon ECS. .\ecs-anywhere-install.ps1 -Uninstall