Excluir pilhas do AWS CloudFormation StackSets - AWS CloudFormation
Excluir pilhas do seu StackSet (console)Excluir pilhas do StackSet (AWS CLI)

Excluir pilhas do AWS CloudFormation StackSets

É possível excluir pilhas de StackSets usando o console ou a AWS CLI do CloudFormation.

nota

Excluir pilhas de uma unidade organizacional (UO) do nível superior removerá essa UO como um destino do StackSet.

Excluir pilhas do seu StackSet (console)

Para excluir pilhas

  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 em que você criou o StackSet.

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

  4. Com o StackSet selecionado, escolha Excluir pilhas do StackSet no menu Ações.

  5. Na página Definir opções de implantação, primeiro escolha as contas e as regiões nas quais você deseja excluir as pilhas.

    1. [Permissões autogerenciadas] Em Contas, escolha Implantar pilhas em contas ou Implantar pilhas em unidades organizacionais.

      Se você escolher Implantar pilhas em contas, cole os números das contas de destino na caixa de texto Números das contas, separando os números com vírgulas.

      Se você escolher Implantar pilhas em unidades organizacionais, cole a ID da OU de destino na caixa de texto Números da organização para que todas as contas da organização especificada sejam destino da implantação.

    2. [Permissões gerenciadas pelo serviço] Em Unidades organizacionais (UOs), especifique os IDs das UOs de destino.

      Importante

      O CloudFormation excluirá as pilhas das UOs de destino especificadas e das OUs subordinadas a elas.

      Em Tipo de filtro da conta, você pode refinar de quais contas as pilhas serão excluídas escolhendo uma das opções a seguir e fornecendo os números das contas.

      • Nenhuma (padrão): excluir as pilhas de todas as contas da UOs especificadas.

      • Interseção: excluir as pilhas apenas de determinadas contas individuais das UOs selecionadas.

      • Diferença: excluir as pilhas de todas as contas das UOs selecionadas, exceto determinadas contas.

      • União: excluir as pilhas das UOs especificadas e também de contas individuais adicionais.

    3. Em Especificar regiões, escolha as regiões das quais você deseja excluir as pilhas das contas de destino.

  6. Em Opções de implantação, faça o seguinte:

    • Em Máximo de contas simultâneas, especifique quantas contas são processadas simultaneamente.

    • Em Tolerância a falhas, especifique o número máximo de falhas de conta permitidas por região. A operação será interrompida e não prosseguirá para outras regiões quando esse limite for atingido.

    • Em Reter pilhas, habilite esta opção para salvar as pilhas e os recursos a elas associados ao removê-las do StackSet. Os recursos permanecem em seu estado atual, mas não fazem mais parte do StackSet.

    • Em Simultaneidade de regiões, escolha o modo de processar as regiões: Sequencial (uma região de cada vez) ou Paralelo (várias regiões simultaneamente).

    • Em Modo de simultaneidade, escolha como a simultaneidade se comporta durante a execução de uma operação.

      • Tolerância a falhas estrita: reduz o nível de simultaneidade da conta quando ocorrem falhas, permanecendo dentro da faixa de Tolerância a falhas +1.

      • Tolerância a falhas flexível: mantém o nível de simultaneidade especificado (o valor de Máximo de contas simultâneas) a despeito de falhas.

  7. Escolha Próximo.

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

  9. Quando estiver tudo pronto para remover as pilhas do StackSet, escolha Enviar.

    Após a exclusão de pilhas ser concluída, é possível verificar se as pilhas foram excluídas do StackSet na página de detalhes do StackSet, na guia Instâncias de pilha.

Excluir pilhas do StackSet (AWS CLI)

nota

Ao atuar como um administrador delegado, você deve incluir --call-as DELEGATED_ADMIN no comando.

Use o comando delete-stack-instances com o nome do StackSet.

Nestes exemplos, usamos a opção --no-retain-stacks porque não vamos reter nenhuma pilha. Use --retain-stacks em vez de --no-retain-stacks se quiser manter as pilhas e seus recursos.

Em --regions, especifique as Regiões da AWS das quais você deseja excluir pilhas, por exemplo, us-west-2 e us-east-1.

Defina o processamento simultâneo de contas e outras preferências usando a opção --operation-preferences. Esses exemplos usam configurações baseadas em contagem. Observe que MaxConcurrentCount não deve exceder FailureToleranceCount + 1. Para configurações baseadas em porcentagem, use FailureTolerancePercentage ou MaxConcurrentPercentage em vez disso.

Para excluir pilhas (permissões autogerenciadas)

Na opção --accounts, especifique os IDs das contas das quais as pilhas serão excluídas.

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 \
  --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
Para excluir pilhas (permissões gerenciadas pelo serviço)

Em --deployment-targets, especifique o ID raiz da organização ou os IDs das unidades organizacionais (UOs) das quais as pilhas serão excluídas.

Importante

O CloudFormation excluirá as pilhas das UOs de destino especificadas e das OUs subordinadas a elas.

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 \
  --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

Para obter mais informações, consulte DeleteStackInstances na AWS CloudFormation API Reference.

Opcionalmente, após a exclusão das pilhas ser concluída, verifique se as pilhas foram excluídas do StackSet executando o comando describe-stack-set-operation para mostrar o status e os resultados da operação de exclusão de pilhas. Em --operation-id, use o ID de operação que foi retornado pelo comando delete-stack-instances.

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