Excluir instâncias de pilhas de StackSets do CloudFormation

É possível excluir instâncias de pilha de um conjunto de pilhas usando o console do CloudFormation ou o AWS CLI.

Para um conjunto de pilhas com permissões gerenciadas pelo serviço, se você excluir instâncias de pilha de uma unidade organizacional (OU) de nível superior, a OU será removida como um destino do conjunto de pilhas.

Excluir instâncias de pilha (console)

1. Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. Na barra de navegação na parte superior da tela, escolha a Região da AWS na qual você criou o conjunto de pilhas.

3. No painel de navegação, escolha StackSets. Na página StackSets, selecione o conjunto de pilhas.

4. Com o conjunto de pilhas selecionado, escolha Delete stacks from StackSet (Excluir pilhas do StackSet) no menu Actions (Ações).

5. Na página Definir opções de implantação escolha as contas das quais as instâncias de pilha serão excluídas.

   1. [Permissões autogerenciadas] Em Accounts (Contas), escolha Deploy stacks in accounts (Implantar pilhas em contas). Cole os números da sua conta de destino na caixa de texto, separando-os com vírgulas.

      [Permissões gerenciadas pelo serviço] Para unidades organizacionais (OUs), especifique os IDs das OUs de destino.

      nota

      O StackSets também exclui instâncias de pilha de qualquer OU filha das OUs de destino especificadas.

   2. Em Especificar regiões, escolha as regiões das quais você deseja excluir instâncias de pilha.

   3. Em Deployment options (Opções de implantação):

      • Em Máximo de contas simultâneas, modifique o máximo de contas simultâneas conforme necessário.

      • Em Tolerância a falhas, modifique a tolerância a falhas conforme necessário.

      • Em Reter pilhas, escolha se deseja habilitar esta opção para remover as instâncias de pilha do seu conjunto de pilhas, mas salvar as pilhas e seus recursos associados. Quando pilhas de um conjunto de pilhas são salvas pela habilitação da opção Reter pilhas, os recursos da pilha permanecem no estado atual, mas a pilha deixa de fazer parte do conjunto de pilhas. Para voltar a associar uma pilha ou adicionar uma pilha existente a um conjunto de pilhas, consulte Importar pilhas para StackStes do CloudFormation.

      • Em Simultaneidade de regiões, modifique a simultaneidade de regiões conforme necessário.

      • Em Modo de simultaneidade, modifique o modo de simultaneidade conforme necessário.

   4. Escolha Próximo.

6. Na página Analisar, examine suas escolhas. Para fazer alterações, escolha Editar na seção relacionada.

7. Quando estiver pronto para remover instâncias de pilha do conjunto de pilhas, escolha Enviar.

   Depois que a exclusão da pilha for concluída, é possível verificar se as instâncias da pilha foram excluídas do conjunto de pilhas na página de detalhes do StackSet, na guia Stack instances (Instâncias da pilha).

Excluir instâncias de pilha (AWS CLI)

Ao atuar como administrador delegado, você deve definir a opção --call-as como DELEGATED_ADMIN toda vez que executar um comando StackSets.

--call-as DELEGATED_ADMIN

1. Use o comando delete-stack-instances. Para --stack-set-name, especifique o nome do conjunto de pilhas.

   Como --retain-stacks é obrigatório para o comando delete-stack-instances, se você não quiser reter (salvar) pilhas, adicione --no-retain-stacks. Neste exemplo, adicionaremos a opção --no-retain-stacks, já que não reteremos nenhuma pilha.

   Em --regions, especifique as regiões das quais deseja excluir instâncias de pilha. Neste caso, as regiões Oeste dos EUA (Oregon) e Leste dos EUA (Norte da Virgínia).

   [Permissões autogerenciadas] Na opção --accounts, especifique as contas que você usou ao criar o conjunto de pilhas.

   aws cloudformation delete-stack-instances --stack-set-name my-stackset \
     --accounts '["account_ID_1","account_ID_2"]' --regions '["us-west-2","us-east-1"]' \
     --no-retain-stacks

   [Permissões gerenciadas pelo serviço] Em --deployment-targets, especifique o ID da organização (raiz) ou os IDs das OUs em que você criou instâncias de pilha.

   aws cloudformation delete-stack-instances --stack-set-name my-stackset \
     --deployment-targets OrganizationalUnitIds='["ou-rcuk-1x5jlwo", "ou-rcuk-slr5lh0a"]' --regions '["us-west-2","us-east-1"]' \
     --no-retain-stacks

   nota

   O StackSets também exclui instâncias de pilha de qualquer OU filha das OUs de destino especificadas.

   Para especificar suas preferências sobre como o CloudFormation executa essa operação de conjunto de pilhas, especifique a opção --operation-preferences, como no exemplo a seguir. Para fins deste exemplo, usaremos conta, e não porcentagem. Para aplicar porcentagens, use FailureTolerancePercentage ou MaxConcurrentPercentage.

   --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1

   nota

   O valor de MaxConcurrentCount depende do valor de FailureToleranceCount. MaxConcurrentCount é, no máximo, um a mais do que MaxConcurrentCount.

2. Opcionalmente, depois que a exclusão da pilha for concluída, verifique se as instâncias de pilha foram excluídas do conjunto de pilhas executando o comando describe-stack-set-operation para mostrar o status e os resultados da operação de exclusão de pilhas. Para --operation-id, use o ID de operação retornado pelo comando delete-stack-instances.

   aws cloudformation describe-stack-set-operation --stack-set-name my-stackset \
     --operation-id ddf16f54-ad62-4d9b-b0ab-3ed8e9example