Cancelar automaticamente o registro de uma instância on-premises - AWS CodeDeploy

Cancelar automaticamente o registro de uma instância on-premises

Normalmente, você cancela o registro de uma instância on-premises quando não planeja mais implantá-la. Quando você cancela o registro de uma instância local, mesmo que essa instância local possa fazer parte das tags de instância local de um grupo de implantação, ela não é incluída em nenhuma implantação. Você pode usa a AWS CLI para cancelar manualmente o registro de instâncias locais.

nota

Não é possível usar o console do CodeDeploy para cancelar o registro de uma instância on-premises. Além disso, cancelar o registro de uma instância no local remove qualquer tag de instância no local que esteja associada à instância no local. O processo não desinstala o agente do CodeDeploy da instância on-premises. Ele não remove o arquivo de configuração da instância local.

Para usar o console do CodeDeploy para realizar algumas (mas não todas as) atividades desta seção, consulte a seção do console do CodeDeploy em Cancelar manualmente o registro de uma instância on-premises.

Para desassociar manualmente qualquer tag de instância on-premises associada, consulte Remover manualmente tags de instância local de uma instância on-premises.

Para desinstalar automaticamente o agente do CodeDeploy e remover o arquivo de configuração da instância on-premises, consulte Desinstalar automaticamente o agente do CodeDeploy e remover o arquivo de configuração de uma instância on-premises.

Para desinstalar manualmente apenas o agente do CodeDeploy da instância on-premises, consulte Gerenciar as operações do agente do CodeDeploy.

Use a AWS CLI para chamar o comando deregister, especificando:

  • O nome que identifica de forma exclusiva a instância on-premises no CodeDeploy (com a opção --instance-name).

  • Opcionalmente, se deseja excluir o usuário do IAM associado à instância on-premises. O comportamento padrão é excluir o usuário do IAM. Se não quiser excluir o usuário do IAM associado à instância no local, especifique a opção --no-delete-iam-user no comando.

  • Opcionalmente, a região da AWS na qual a instância on-premises foi registrada no CodeDeploy (com a opção --region). Esta deve ser uma das regiões compatíveis listadas em Região e endpoints na Referência geral da AWS (por exemplo, us-west-2). Se essa opção não for especificada, a região da AWS padrão associada ao usuário do IAM responsável pela chamada será usada.

Um exemplo que cancela o registro de uma instância e exclui o usuário:

aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2

Um exemplo que cancela o registro de uma instância e não exclui o usuário:

aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2

O comando deregister faz o seguinte:

  1. Cancela o registro da instância on-premises no CodeDeploy.

  2. Se especificado, exclui o usuário do IAM associado à instância on-premises.

Depois de cancelar o registro de uma instância on-premises:

  • Ela não é mais exibida no console imediatamente.

  • Você pode criar outra instância com o mesmo nome imediatamente.

Se esse comando encontrar erros, será exibida uma mensagem de erro descrevendo como você pode concluir manualmente as etapas restantes. Caso contrário, será exibida uma mensagem de sucesso, descrevendo como chamar o comando uninstall.