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.
Tópicos
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.
No console, selecione o conjunto de pilhas que contém a pilha na qual a operação falhou.
-
No menu Actions (Ações), escolha Edit StackSet details (Editar detalhes do StackSet) para tentar criar ou atualizar as pilhas novamente.
-
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.
-
Na página Especificar detalhes, escolha Próximo se você não estiver alterando nenhum parâmetro específico do seu modelo.
-
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.
-
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.
-
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.