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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 usar o AWS CLI para cancelar o registro de instâncias locais.

nota

Você não pode usar o CodeDeploy console para cancelar o registro de uma instância local. 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. Ele não desinstala o CodeDeploy agente da instância local. Ele não remove o arquivo de configuração da instância local.

Para usar o CodeDeploy console para realizar algumas (mas não todas) as atividades desta seção, consulte a seção CodeDeploy console doCancelar 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 CodeDeploy agente e remover o arquivo de configuração da instância local, consulteDesinstale automaticamente o CodeDeploy agente e remova o arquivo de configuração de uma instância local.

Para desinstalar manualmente somente o CodeDeploy agente da instância local, consulteGerenciando as operações CodeDeploy do agente.

Use o AWS CLI para chamar o comando de cancelamento de registro, especificando:

  • O nome que identifica de forma exclusiva a instância local para 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 AWS região em que a instância local foi registrada CodeDeploy (com a --region opção). 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 AWS região padrão associada ao usuário do IAM chamador 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 local com. 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.