Visualizar um conjunto de alterações - AWS CloudFormation

Visualizar um conjunto de alterações

Depois de criar um conjunto de alterações, você pode visualizar as alterações propostas antes da execução. Você pode usar o console do CloudFormation, a AWS CLI ou a API do CloudFormation para exibir conjuntos de alterações. O console do CloudFormation fornece um resumo das alterações e uma lista detalhada delas no formato JSON. A AWS CLI e a API do AWS CloudFormation retornam uma lista detalhada das alterações em formato JSON.

View a change set for nested stack (console)

Para exibir um conjunto de alterações para pilhas aninhadas (console)

  1. No console do AWS CloudFormation, em Stacks (Pilhas), escolha o nome da pilha que contém o conjunto de alterações que deseja exibir.

  2. No painel de navegação, escolha Change Sets (Conjuntos de alterações) para exibir uma lista dos conjuntos de alterações da pilha.

  3. Escolha o nome do conjunto de alterações que deseja exibir.

    O console do CloudFormation direcionará você para a página de detalhes do conjunto de alterações, onde poderá ver o horário em que o conjunto de alterações foi criado, o status, a entrada usada para gerá-lo e um resumo das alterações.

    
                  A página de detalhes do conjunto de alterações.

    Na seção Alterações, cada linha representa um recurso para o qual o CloudFormation vai adicionar, modificar, remover ou exibir o status de dinâmico.

    • Adicionar – O CloudFormation cria um recurso quando você adicionar um recurso ao modelo da pilha.

    • Modificar – O CloudFormationmodifica um recurso quando você altera as propriedades de um recurso no modelo da pilha.

    • Remover – O CloudFormation exclui um recurso quando você exclui um recurso ao modelo da pilha.

    • Dinâmico – O CloudFormation não pode determinar a ação exata de alteração de recurso com base no modelo da pilha aninhada.

    nota

    Uma modificação pode fazer com que o recurso seja interrompido ou substituído (recriado). Para obter mais informações sobre os comportamentos de atualização de recursos, consulte Atualizar comportamentos de recursos da pilha.

    Para se concentrar em alterações específicas, use a visualização com filtro. Por exemplo, filtre por um determinado tipo de recurso, p. ex., AWS::CloudFormation::Stack. Para filtrar por um recurso específico, especifique o ID lógico ou físico, como DeadLetterQueue ou NestedStack.

  4. Na seção Changes (Alterações), escolha View nested change set (Exibir conjunto de alterações aninhadas) do conjunto de alterações aninhadas que deseja exibir.

    O console do CloudFormation direciona você para a página de detalhes do conjunto de alterações aninhadas. Você pode escolher Go to root change set (Acessar o conjunto raiz de alterações) para exibir o conjunto raiz de alterações ou escolher View parent change set (Exibir conjunto pai de alterações) para exibir o conjunto pai de alterações. Para mais informações, consulte Conjuntos de alterações para pilhas aninhadas.

    
                  A página de detalhes do conjunto de alterações aninhadas.
View a change set (console)

Para exibir um conjunto de alterações (console)

  1. No console do AWS CloudFormation, em Stacks (Pilhas), escolha o nome da pilha que contém o conjunto de alterações que deseja exibir.

  2. No painel de navegação, escolha Change Sets (Conjuntos de alterações) para exibir uma lista dos conjuntos de alterações da pilha.

  3. Escolha o nome do conjunto de alterações que deseja exibir.

    O console do CloudFormation direcionará você para a página de detalhes do conjunto de alterações, onde poderá ver o horário em que o conjunto de alterações foi criado, o status, a entrada usada para gerá-lo e um resumo das alterações.

    
                  A página de detalhes do conjunto de alterações.

    Na seção Alterações, cada linha representa um recurso que o CloudFormation vai adicionar, modificar ou remover.

    • Adicionar – O CloudFormation cria um recurso quando você adicionar um recurso ao modelo da pilha.

    • Modificar – O CloudFormationmodifica um recurso quando você altera as propriedades de um recurso no modelo da pilha.

    • Remover – O CloudFormation exclui um recurso quando você exclui um recurso ao modelo da pilha.

    nota

    Uma modificação pode fazer com que o recurso seja interrompido ou substituído (recriado). Para obter mais informações sobre os comportamentos de atualização de recursos, consulte Atualizar comportamentos de recursos da pilha.

    Para se concentrar em alterações específicas, use a visualização com filtro. Por exemplo, filtre por um determinado tipo de recurso, como AWS::EC2::Instance. Para filtrar por um recurso específico, especifique o ID lógico ou físico, como myWebServer ou i-123abcd4.

Para exibir um conjunto de alterações (AWS CLI)

  1. Para obter o ID do conjunto de alterações, execute o comando aws cloudformation list-change-sets.

    Especifique o ID da pilha que contém o conjunto de alterações que você deseja visualizar, como mostrado no exemplo a seguir:

    aws cloudformation list-change-sets --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000

    O CloudFormation retorna uma lista de conjuntos de alterações, semelhante a esta:

    { "Summaries": [ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet", "CreationTime": "2020-11-18T20:44:05.889Z", "StackName": "SampleStack", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000" }, { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet-conditional", "CreationTime": "2020-11-18T21:15:56.398Z", "StackName": "SampleStack", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-conditional/1a2345b6-0000-00a0-a123-00abc0abc000" }, { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet-replacement", "CreationTime": "2020-11-18T21:03:37.706Z", "StackName": "SampleStack", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000" } ] }
  2. Execute o comando aws cloudformation describe-change-set, especificando o ID do conjunto de alterações que você deseja visualizar. Por exemplo:

    aws cloudformation describe-change-set --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000

    O CloudFormation retorna informações sobre o conjunto de alterações especificado:

    { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet-direct", "Parameters": [ { "ParameterValue": "testing", "ParameterKey": "Purpose" }, { "ParameterValue": "ellioty-useast1", "ParameterKey": "KeyPairName" }, { "ParameterValue": "t2.micro", "ParameterKey": "InstanceType" } ], "Changes": [ { "ResourceChange": { "ResourceType": "AWS::EC2::Instance", "PhysicalResourceId": "i-1abc23d4", "Details": [ { "ChangeSource": "DirectModification", "Evaluation": "Static", "Target": { "Attribute": "Tags", "RequiresRecreation": "Never" } } ], "Action": "Modify", "Scope": [ "Tags" ], "LogicalResourceId": "MyEC2Instance", "Replacement": "False" }, "Type": "Resource" } ], "CreationTime": "2020-11-18T23:35:25.813Z", "Capabilities": [], "StackName": "SampleStack", "NotificationARNs": [], "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-direct/9edde307-960d-4e6e-ad66-b09ea2f20255" }

    A chave Changes relaciona as alterações nos recursos. Se você executar esse conjunto de alterações, o CloudFormation poderá atualizar as tags da instância do EC2 i-1abc23d4. Para obter uma descrição de cada campo, consulte o tipo de dados Change, no AWS CloudFormation API Reference.

    Para obter mais exemplos de conjuntos de alterações, consulte Exemplos de conjuntos de alterações.