Monitorar o progresso da atualização de uma pilha - AWS CloudFormation

Monitorar o progresso da atualização de uma pilha

Monitore o progresso da atualização de uma pilha visualizando os eventos da pilha. A guia Eventos do console exibe cada etapa principal da criação e atualização da pilha classificada pelo tempo de cada evento, com os eventos mais recentes na parte superior.

Eventos gerados durante uma atualização de pilha bem-sucedida

O início do processo de atualização da pilha é marcado com um evento UPDATE_IN_PROGRESS para a pilha:

2011-09-30 09:35 PDT AWS::CloudFormation::Stack MyStack UPDATE_IN_PROGRESS

Em seguida estão os eventos que marcam o início e a conclusão da atualização de cada recurso que foi alterado no modelo de atualização. Por exemplo, a atualização de um recurso do AWS::RDS::DBInstance chamado MyDB resultaria nas seguintes entradas:

2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_COMPLETE 2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS

O evento UPDATE_IN_PROGRESS é registrado quando o AWS CloudFormation relata que começou a atualizar o recurso. O evento UPDATE_COMPLETE é registrado quando o recurso é criado com êxito.

Quando o AWS CloudFormation tiver atualizado com êxito a pilha, você verá o seguinte evento:

2011-09-30 09:35 PDT AWS::CloudFormation::Stack MyStack UPDATE_COMPLETE
Importante

Durante as operações de atualização de pilha, se o CloudFormation precisar substituir um recurso existente, primeiramente ele criará um novo recurso e, em seguida, excluirá o antigo. No entanto, pode haver casos em que o CloudFormation não pode excluir o recurso antigo (por exemplo, se o usuário não tiver permissões para excluir um recurso de um determinado tipo).

O CloudFormation faz três tentativas de excluir o recurso antigo. Se o CloudFormation não puder excluir o recurso antigo, ele removerá o recurso antigo da pilha e continuará a atualizá-la. Quando a atualização da pilha estiver concluída, o CloudFormation emitirá um evento de pilha UPDATE_COMPLETE, mas incluirá um StatusReason que declarará que não foi possível excluir um ou mais recursos. O CloudFormation também emite um evento DELETE_FAILED para o recurso específico, com um StatusReason correspondente fornecendo mais detalhes sobre o motivo pelo qual o CloudFormation não conseguiu excluir o recurso.

O recurso antigo ainda existe e continuará a gerar cobranças, mas deixará de ser acessível por meio do CloudFormation. Para excluir o recurso antigo, acesse o recurso antigo diretamente usando o console ou a API do serviço em questão.

Isso também se aplica aos recursos que você removeu do modelo de pilha e, portanto, eles serão excluídos da pilha durante a atualização da pilha.

Eventos gerados quando uma atualização de recurso falha

Se a atualização de um recurso falhar, o AWS CloudFormation relatará um evento UPDATE_FAILED que incluirá um motivo para a falha. Por exemplo, se o modelo de atualização tiver especificado uma alteração de propriedade não aceita pelo recurso, como a redução do tamanho de AllocatedStorage para um recurso do AWS::RDS::DBInstance, você verá eventos como estes:

2011-09-30 09:36 PDT AWS::RDS::DBInstance MyDB UPDATE_FAILED Size cannot be less than current size; requested: 5; current: 10 2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS

Se um recurso de atualização falhar, o AWS CloudFormation reverterá quaisquer recursos que tiverem sido atualizados para as configurações anteriores à atualização. Aqui está um exemplo de eventos que seriam vistos durante uma reversão de atualização:

2011-09-30 09:38 PDT AWS::CloudFormation::Stack MyStack UPDATE_ROLLBACK_COMPLETE 2011-09-30 09:38 PDT AWS::RDS::DBInstance MyDB UPDATE_COMPLETE 2011-09-30 09:37 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS 2011-09-30 09:37 PDT AWS::CloudFormation::Stack MyStack UPDATE_ROLLBACK_IN_PROGRESS The following resource(s) failed to update: [MyDB]

Para visualizar os eventos da pilha usando o console

  1. No console do AWS CloudFormation, selecione a pilha que você atualizou e, em seguida, escolha a guia Eventos para visualizar eventos de pilhas.

  2. Para atualizar a lista de eventos com os mais recentes, selecione o botão "atualizar" no console do AWS CloudFormation.

Para visualizar os eventos da pilha usando a linha de comando