Monitorar o progresso da pilha
Esta seção descreve como monitorar uma implantação de pilha que está em andamento. O CloudFormation fornece uma lista detalhada e cronológica dos eventos de implantação, mostrando o progresso e quaisquer problemas encontrados durante a implantação.
Tópicos
- Visualizar eventos da pilha (console)
- Visualizar eventos da pilha (AWS CLI)
- Códigos de status da pilha
- Entender os eventos de criação de pilhas do CloudFormation
- Monitorar o progresso da atualização de uma pilha
- Continuar revertendo uma atualização
- Determinar a causa de uma falha na pilha
- Escolha como lidar com falhas ao provisionar recursos
Visualizar eventos da pilha (console)
Para visualizar os eventos da pilha
-
Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation
. -
Na barra de navegação na parte superior da tela, escolha a Região da AWS na qual você criou a pilha.
-
Na página Stacks (Pilhas) do console do CloudFormation, selecione o nome da pilha. O CloudFormation exibe a página de detalhes da pilha para a pilha selecionada.
-
Escolha a guia Eventos para visualizar os eventos de pilha que o CloudFormation gerou para sua pilha.
O CloudFormation atualiza automaticamente os eventos da pilha a cada minuto. Além disso, o CloudFormation exibe o emblema Novos eventos disponíveis quando ocorrem novos eventos de pilha. Escolha o ícone de atualização para carregar esses eventos na lista. Ao visualizar eventos de criação da pilha, você pode entender a sequência de eventos que levam à criação da sua pilha (ou falha, se você está depurando a pilha).
Durante a criação da pilha, ela estará listada na página Pilhas com um status de CREATE_IN_PROGRESS
. Após a pilha ter sido criada com êxito, seu status muda para CREATE_COMPLETE
.
Para ter mais informações, consulte Entender os eventos de criação de pilhas do CloudFormation e Monitorar o progresso da atualização de uma pilha.
Visualizar eventos da pilha (AWS CLI)
Como alternativa, você pode usar o comando describe-stack-events enquanto a pilha está sendo criada para visualizar os eventos à medida que eles são relatados.
O comando describe-stack-events a seguir descreve os eventos da pilha
.myteststack
aws cloudformation describe-stack-events --stack-name
myteststack
O seguinte é um exemplo de resposta.
{
"StackEvents": [
{
"StackId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
"EventId": "af67ef60-0b8f-11e3-8b8a-500150b352e0",
"ResourceStatus": "CREATE_COMPLETE",
"ResourceType": "AWS::CloudFormation::Stack",
"Timestamp": "2013-08-23T01:02:30.070Z",
"StackName": "myteststack",
"PhysicalResourceId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0",
"LogicalResourceId": "myteststack"
},
{
"StackId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
"EventId": "S3Bucket-CREATE_COMPLETE-1377219748025",
"ResourceStatus": "CREATE_COMPLETE",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2013-08-23T01:02:28.025Z",
"StackName": "myteststack",
"ResourceProperties": "{\"AccessControl\":\"PublicRead\"}",
"PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w",
"LogicalResourceId": "S3Bucket"
},
{
"StackId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
"EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219746688",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2013-08-23T01:02:26.688Z",
"ResourceStatusReason": "Resource creation Initiated",
"StackName": "myteststack",
"ResourceProperties": "{\"AccessControl\":\"PublicRead\"}",
"PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w",
"LogicalResourceId": "S3Bucket"
},
{
"StackId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
"EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219743862",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2013-08-23T01:02:23.862Z",
"StackName": "myteststack",
"ResourceProperties": "{\"AccessControl\":\"PublicRead\"}",
"PhysicalResourceId": null,
"LogicalResourceId": "S3Bucket"
},
{
"StackId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
"EventId": "a69469e0-0b8f-11e3-8b8a-500150b352e0",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceType": "AWS::CloudFormation::Stack",
"Timestamp": "2013-08-23T01:02:15.422Z",
"ResourceStatusReason": "User Initiated",
"StackName": "myteststack",
"PhysicalResourceId": "arn:aws:cloudformation:aws-region
:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0",
"LogicalResourceId": "myteststack"
}
]
}
Os eventos mais recentes são relatados primeiro. A tabela a seguir descreve os campos retornados pelo comando describe-stack-events:
Campo | Descrição |
---|---|
EventId |
Identificador de eventos. |
StackName |
Nome da pilha a qual o evento corresponde. |
StackId |
Identificador pilha ao qual o evento corresponde. |
LogicalResourceId |
Identificador do recurso lógico. |
PhysicalResourceId |
Identificador do recurso físico. |
ResourceProperties |
Propriedades do recurso. |
ResourceType |
Tipo de recurso. |
Timestamp |
Hora em que o evento ocorreu. |
ResourceStatus |
O status do recurso, que pode ser um dos seguintes códigos de status: O status |
DetailedStatus |
O status detalhado da pilha. Se |
ResourceStatusReason |
Mais informações sobre o status. |
Códigos de status da pilha
A tabela a seguir descreve os códigos de status da pilha:
Status da pilha e status detalhado opcional | Descrição |
---|---|
|
Criação bem-sucedida de uma ou mais pilhas. |
|
Criação contínua de uma ou mais pilhas. |
|
Criação malsucedida de uma ou mais pilhas. Visualize os eventos da pilha para ver as mensagens de erro associadas. As possíveis razões para uma falha na criação incluem permissões insuficientes para trabalhar com todos os recursos na pilha, valores de parâmetro rejeitados por um produto da AWS ou um tempo limite durante a criação de recursos. |
|
Exclusão bem-sucedida de uma ou mais pilhas. As pilhas excluídas serão retidas e poderão ser visualizadas por 90 dias. |
|
Exclusão malsucedida de uma ou mais pilhas. Como a exclusão falhou, alguns recursos ainda poderão estar em execução. No entanto, não é possível trabalhar com a pilha, tampouco atualizá-la. Exclua a pilha novamente ou visualize os eventos de pilha para ver as mensagens de erro associadas. |
|
Remoção contínua de uma ou mais pilhas. |
|
Criação contínua de uma ou mais pilhas com um StackId esperado, mas sem modelos ou recursos.ImportanteUma pilha com este código de status conta contra o número máximo possível de pilhas. |
|
Remoção bem-sucedida de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. A pilha retorna ao estado operacional anterior. Quaisquer recursos criados durante a ação de criação da pilha serão excluídos. Esse status ocorre somente após uma falha de criação de uma pilha. Ele significa que todas as operações da pilha parcialmente criada foram adequadamente limpas. Ao entrar nesse estado, a única operação possível é a exclusão. |
|
Remoção malsucedida de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. Exclua a pilha ou visualize os eventos de pilha para ver as mensagens de erro associadas. |
|
Remoção contínua de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. |
|
Atualização bem-sucedida de uma ou mais pilhas. |
|
Remoção contínua de recursos antigos para uma ou mais pilhas após uma atualização bem-sucedida da pilha. Para atualizações de pilha que exigem a substituição de recursos, o CloudFormation cria os novos recursos primeiro e, em seguida, exclui os recursos antigos para ajudar a reduzir as interrupções com a pilha. Nesse estado, a pilha foi atualizado e é utilizável, mas o CloudFormation ainda está excluindo os recursos antigos. |
|
Atualização bem-sucedida de uma ou mais pilhas. Visualize os eventos da pilha para ver as mensagens de erro associadas. |
|
Atualização contínua de uma ou mais pilhas. |
|
Retorno bem-sucedido de uma ou mais pilhas para um estado de trabalho anterior após uma falha na atualização da pilha. |
|
Remoção contínua de recursos novos para uma ou mais pilhas após uma atualização falha da pilha. Nesse estado, a pilha foi revertida para seu estado de trabalho anterior e é utilizável, mas o CloudFormation ainda está excluindo os recursos novos criados durante a atualização da pilha. |
|
Retorno malsucedido de uma ou mais pilhas para um estado de trabalho anterior após uma falha na atualização da pilha. Quando estiver neste estado, você pode excluir a pilha ou continuar a reversão. Talvez você precise corrigir erros para que a pilha possa retornar a um estado operacional. Se preferir, entre em contato com o AWS Support para restaurar a pilha para um estado utilizável. |
|
Retorno contínuo de uma ou mais pilhas para o estado de trabalho anterior após falha na atualização da pilha. |
|
A operação de importação está em andamento. |
|
A operação de importação foi concluída com êxito para todos os recursos da pilha que oferecem suporte a |
|
A importação será revertida para a configuração do modelo anterior. |
|
Houve uma falha na operação de reversão de importação para pelo menos um recurso na pilha. Os resultados serão disponibilizados para os recursos importados com êxito pelo CloudFormation. |
|
A importação foi revertida com êxito para a configuração de modelo anterior. |