Solução de problemas do AWS CloudFormation StackSets

Este tópico contém alguns problemas comuns do AWS CloudFormation StackSets e soluções sugeridas para esses problemas.

Motivos comuns de falha na operação da pilha

Problema: uma operação de pilha falhou, e o status da instância de pilha é OUTDATED.

Causa: pode haver várias causas comuns para a falha na operação da pilha.

• Permissões insuficientes em uma conta de destino para criar recursos especificados no seu modelo.

• O modelo do AWS CloudFormation pode conter erros. Valide o modelo no AWS CloudFormation e corrija os erros antes de tentar criar seu conjunto de pilhas.

• O modelo pode estar tentando criar recursos globais que precisam ser únicos, mas não são. Por exemplo, os buckets do S3.

• Não existe um número de conta de destino especificado. Verifique os números da conta de destino que você especificou na página Definir opções de implantação do assistente.

• A conta de administrador não possui uma relação de confiança com a conta de destino.

• A quantidade máxima especificada para um recurso no seu modelo já existe na sua conta de destino. Por exemplo, você pode ter atingido o limite de permitido de funções IAM em uma conta de destino, mas o modelo cria mais funções IAM.

• Você atingiu a quantidade máxima permitida de pilhas em um conjunto de pilhas. Consulte Limites do AWS CloudFormation para saber o número máximo de pilhas por conjunto de pilhas.

Solução: Para obter mais informações sobre as permissões necessárias das contas de destino e administrador antes de criar conjuntos de pilhas, consulte Definir permissões básicas para operações de conjuntos de pilhas.

Realizar novamente operações de criação ou atualização de pilha com falha

Problema: uma operação de criação ou atualização de pilha falhou, e o status da instância de pilha é OUTDATED. Para saber o motivo da falha de uma tentativa de criação ou atualização de pilha, abra o console do AWS CloudFormation e veja os eventos da pilha, que exibirão status DELETED (para operações de criação com falha) ou FAILED (para operações de atualização com falha). Navegue pelos eventos de pilha e localize a coluna Motivo do status. O valor de Motivo do status explica o motivo da falha na operação.

Depois de corrigir a causa subjacente da falha na criação da pilha, você poderá tentar realizar a criação da pilha novamente. Para isso, execute as etapas a seguir.

Solução: execute as seguintes etapas para tentar realizar a operação da pilha novamente.

1. No console, selecione o conjunto de pilhas que contém a pilha na qual a operação falhou.

2. No menu Actions (Ações), escolha Edit StackSet details (Editar detalhes do StackSet) para tentar criar ou atualizar as pilhas novamente.

3. Na página Specify template (Especificar modelo), mantenha a opção padrão Use current template (Usar modelo atual) para usar o mesmo modelo do AWS CloudFormation. Se sua operação de pilha falhou porque o modelo necessário foi alterado e você deseja enviar um modelo revisado, escolha Carregar um modelo no Amazon S3 e, em seguida, Procurar para selecionar o modelo atualizado. Quando você terminar de carregar do modelo revisado, escolha Próximo.

4. Na página Especificar detalhes, escolha Próximo se você não estiver alterando nenhum parâmetro específico do seu modelo.

5. Na página Definir opções de implantação, altere os padrões para Máximo de contas simultâneas e Tolerância a falhas, se desejar. Para obter mais informações sobre essas configurações, consulte Opções de operação do conjunto de pilhas.

6. Na página Revisão, revise suas seleções e marque a caixa de seleção para confirmar os recursos do IAM necessários. Selecione Enviar.

7. Se sua pilha não for atualizada com êxito, repita este procedimento depois de ter resolvido todos os problemas subjacentes que estejam impedindo a criação de pilhas.

Falha de exclusão de instância de pilha

Problema: houve uma falha de exclusão de pilha.

Causa: a exclusão de pilha falhará para as pilhas em que a proteção contra encerramento foi ativada.

Solução: determine se a proteção contra encerramento foi ativada para a pilha. Caso tenha sido, desative a proteção contra encerramento e, em seguida, execute a exclusão de instância de pilha novamente.