Cancelar o registro de uma instância externa

Recomendamos que, depois de concluir o uso de uma instância externa, você cancele o registro da instância no Amazon ECS e no AWS Systems Manager. Depois do cancelamento do registro, a instância externa não poderá mais aceitar novas tarefas.

Se você tiver tarefas em execução na instância de contêiner quando cancelar o registro, estas tarefas permanecerão em execução até serem interrompidas por outros meios. Contudo, essas tarefas não serão mais monitoradas ou gerenciadas pelo Amazon ECS. Se essas tarefas da instância externa fizerem parte de um serviço do Amazon ECS, o programador de serviços iniciará uma nova cópia das tarefas em uma instância diferente, se possível.

Para registrar uma instância externa em um novo cluster, após o cancelamento do registro da instância externa no Amazon ECS e no Systems Manager, você pode limpar os AWS recursos restantes na instância e registrá-la em um novo cluster.

AWS Management Console

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Na barra de navegação, escolha a região em que sua instância externa está registrada.

3. No painel de navegação, escolha Clusters e selecione o cluster que hospeda a instância externa.

4. Na página Cluster : name, escolha a guia Infrastructure (Infraestrutura).

5. Em Container instances (Instâncias de contêiner), selecione o ID da instância externa para cancelar o registro. Você será redirecionado para a página de detalhes da instância do contêiner.

6. Na página Container Instance : id, escolha Deregister.

7. Revise a mensagem de cancelamento do registro. Selecione Cancelar o registro no AWS Systems Manager para também cancelar o registro da instância externa como uma instância gerenciada no Systems Manager. Escolha Cancelar registro.

   nota

   É possível cancelar o registro da instância externa como uma instância gerenciada do Systems Manager no console do Systems Manager. Para obter instruções, consulte Deregistering managed instances (Cancelar o registro de instâncias gerenciadas) no AWS Systems Manager Guia do usuário do .

8. Depois de cancelar o registro da instância, limpe AWS os recursos no servidor local ou na VM.

   Sistema operacional	Etapas
   Linux	Interrompa o agente de contêiner do Amazon ECS e os serviços do SSM Agent na instância. sudo systemctl stop ecs amazon-ssm-agent Remova os pacotes do Amazon ECS e do Systems Manager. Para CentOS 7, CentOS 8 e RHEL 7 sudo yum remove -y amazon-ecs-init amazon-ssm-agent Para SUSE Enterprise Server 15 sudo zypper remove -y amazon-ecs-init amazon-ssm-agent Para Debian e Ubuntu sudo apt remove -y amazon-ecs-init amazon-ssm-agent Remova os diretórios restantes. sudo rm -rf /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm
   Windows	Interrompa o agente de contêiner do Amazon ECS e os serviços do SSM Agent na instância. Stop-Service AmazonECS Stop-Service AmazonSSMAgent Remova o pacote do Amazon ECS. .\ecs-anywhere-install.ps1 -Uninstall

AWS CLI

1. Você precisa do ID da instância e do ARN da instância de contêiner para cancelar o registro da instância de contêiner. Se você não tiver esses valores, execute os comandos a seguir

   Execute o comando a seguir para obter o ID da instância.

   Você usa o ID da instância (instanceID) para obter o ARN (containerInstanceARN) da instância de contêiner.

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

   Execute os seguintes comandos.

   Você usa o containerInstanceArn como parâmetro no comando para cancelar o registro da instância (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. Execute o comando a seguir para drenar a instância.

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

3. Depois que a instância de contêiner terminar de ser drenada, execute o comando a seguir para cancelar o registro da instância.

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

4. Execute o comando a seguir para remover instâncias de contêiner do SSM.

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

5. Depois de cancelar o registro da instância, limpe AWS os recursos no servidor local ou na VM.

   Sistema operacional	Etapas
   Linux	Interrompa o agente de contêiner do Amazon ECS e os serviços do SSM Agent na instância. sudo systemctl stop ecs amazon-ssm-agent Remova os pacotes do Amazon ECS e do Systems Manager. sudo (yum/apt/zypper) remove amazon-ecs-init amazon-ssm-agent Remova os diretórios restantes. sudo rm -rf /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm
   Windows	Interrompa o agente de contêiner do Amazon ECS e os serviços do SSM Agent na instância. Stop-Service AmazonECS Stop-Service AmazonSSMAgent Remova o pacote do Amazon ECS. .\ecs-anywhere-install.ps1 -Uninstall