Como solucionar problemas de pilha do CloudFormation no meu projeto do AWS Amplify?

Breve descrição

Para solucionar problemas de pilha do CloudFormation no seu projeto do Amplify, primeiro identifique o que está causando o problema revisando o seguinte no console do CloudFormation:

• O Status code (Código do status) e o Status reason (Motivo do status) da pilha de backend.
• Os valores de Status, Status reason (Motivo do status) e Logical ID (ID lógico) dos Eventos recentes da pilha de backend.
• Os valores de Status, Status reason (Motivo do status) e Logical ID (ID lógico) dos Recursos da pilha de backend.

Observação: o valor de Status reason (Motivo do status) contém uma mensagem de erro retornada pelo CloudFormation que identifica o que está causando o erro.

Em seguida, corrija o problema com base nos valores de Status, Status reason (Motivo do status) e Logical ID (ID lógico) listados no console.

Resolução

Observação: as pilhas do CloudFormation que o Amplify provisiona ou atualiza podem retornar erros por vários motivos. Veja a seguir os motivos mais comuns pelos quais as pilhas do CloudFormation retornam erros associados a projetos do Amplify:

• Configurações incorretas no projeto do Amplify associado
• Arquivos ausentes no projeto do Amplify associado
• Usar uma versão desatualizada da Interface de linha de comando da Amplify Command Line Interface (Amplify CLI)

Identifique o que está causando o problema revisando os códigos de status e os motivos de status da pilha no console do CloudFormation

1.    Abra o console do Amplify.

2.    Escolha a guia Backend environments (Ambientes de backend). Em seguida, escolha o ambiente de backend da sua aplicação.

3.    Escolha a guia Overview (Visão geral). Em seguida, escolha View in CloudFormation (Exibir no CloudFormation). A página Stack info (Informações da pilha) do CloudFormation associada ao ambiente de backend é aberta no console do CloudFormation.

4.    No painel Overview (Visão geral), analise os valores de Status e Status reason (Motivo do status). Este é o Status reason (Motivo do status) do código de status da pilha de backend.

Observação: se a pilha raiz do projeto estiver no status UPDATE_ROLLBACK_FAILED, siga as instruções neste artigo: Como fazer com que minha pilha do CloudFormation seja atualizada se estiver presa no estado UPDATE_ROLLBACK_FAILED?

5.    Escolha a guia Events (Eventos). Revise os valores de Status, Status reason (Motivo do status) e Logical ID (ID lógico) para todos os eventos recentes que estão em status de falha.

Observação: certifique-se de identificar todos os eventos com o status UPDATE_FAILED.

6.    Escolha a guia Resources (Recursos). Revise os valores de Status, Status reason (Motivo do status) e Logical ID (ID lógico) para todos os recursos que estão em status de falha.

7.    (Somente para pilhas aninhadas) No painel Resources (Recursos), procure recursos do tipo AWS::CloudFormation::Stack. Em seguida, revise os valores de Status reason (Motivo do status) para as pilhas aninhadas que estão em status de falha.

Importante: durante a solução de problemas, ignore os recursos que falharam com um status Resource update cancelled (Atualização de recurso cancelada). Esse status significa um recurso dependente e downstream que não falhou, mas também não foi atualizado devido a outra falha de recurso.

Corrija o problema com base nos valores de Status, Status reason (Motivo do status) e Logical ID (ID lógico) listados no console

Siga as instruções no Guia de solução de problemas da Amplify CLI. Para obter mais informações, você também pode pesquisar Motivos de status específicos na página de Problemas com a Amplify CLI no GitHub.

Observação: é uma prática recomendada testar primeiro as soluções em um ambiente que não seja de produção.

---