Visualizar um conjunto de alterações para uma pilha do CloudFormation - AWS CloudFormation

Visualizar um conjunto de alterações para uma pilha do CloudFormation

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 visualizar 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 (console)
Para visualizar um conjunto de alterações

  1. Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na barra de navegação na parte superior da tela, escolha sua Região da AWS.

  3. Na página Pilhas, escolha o nome da pilha que contém o conjunto de alterações que você deseja visualizar.

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

  5. Escolha o nome do conjunto de alterações que deseja visualizar.

    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.

    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 Compreender atualização de 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.

  6. Na seção Alterações, escolha Visualizar detalhes na coluna Alterações no nível da propriedade para visualizar as alterações feitas nos valores das propriedades do recurso.

  7. O console do CloudFormation direciona você para a página das alterações no nível de propriedade de um recurso, onde é possível ver a configuração do modelo do recurso antes da execução de um conjunto de alterações e como ficará a configuração do modelo depois que o conjunto de alterações for executado.

    A tabela da seção Alterações no nível da propriedade mostra o Caminho, o Tipo de alteração, o Valor antes e o Valor depois das propriedades afetadas. Na tabela, escolha a caixa de seleção de cada alteração que você desejar realçar nas visualizações Antes e Depois do seu modelo para ver quais alterações serão feitas no nível da propriedade.

    • Adicionar: as propriedades adicionadas são realçadas em verde.

    • Modificar: as propriedades modificadas são realçadas em azul.

    • Remover: as propriedades removidas são realçadas em vermelho.

View a change set for nested stack (console)
Para visualizar um conjunto de alterações para pilhas aninhadas (console)

  1. Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na barra de navegação na parte superior da tela, escolha sua Região da AWS.

  3. Na página Pilhas, escolha o nome da pilha que contém o conjunto de alterações que você deseja visualizar.

  4. No painel de navegação, escolha Conjuntos de alterações para visualizar uma lista dos conjuntos de alterações da pilha.

  5. Escolha o nome do conjunto de alterações que deseja visualizar.

    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.

    Na seção Changes (Alterações), cada linha representa um recurso para o qual o CloudFormation vai adicionar, modificar, remover ou mostrar 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 Compreender atualização de 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::CloudFormation::Stack. Para filtrar por um recurso específico, especifique o ID lógico ou físico, como DeadLetterQueue ou NestedStack.

  6. 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 visualizar.

    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 visualizar o conjunto raiz de alterações ou escolher View parent change set (Exibir conjunto pai de alterações) para visualizar o conjunto pai de alterações. Para obter mais informações, consulte Conjuntos de alteração para pilhas aninhadas.

    nota

    Os conjuntos de alterações no nível da propriedade do CloudFormation não resolvem referências entre pilhas quando você cria conjuntos de alterações para pilhas aninhadas. Os conjuntos de alterações poderão marcar recursos em uma pilha subordinada para substituição condicional se eles referenciarem a saída de uma pilha superior e ela tiver sido modificada

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

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

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

    aws cloudformation list-change-sets --stack-name MyStack

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

    {
    "Summaries": [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/MyStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet",
            "CreationTime": "2020-11-18T20:44:05.889Z",
            "StackName": "MyStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/MyStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-conditional",
            "CreationTime": "2020-11-18T21:15:56.398Z",
            "StackName": "MyStack",
            "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/MyStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-replacement",
            "CreationTime": "2020-11-18T21:03:37.706Z",
            "StackName": "MyStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000"
        }
    ]
}

  2. Execute o comando 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/MyStack/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": "MyStack",
    "NotificationARNs": [],
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-direct/9edde307-960d-4e6e-ad66-b09ea2f20255"
}

    Use --include-property-values com describe-change-set para listar as alterações no nível da propriedade.

    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, na Referência de APIs do AWS CloudFormation.

    Para obter mais exemplos de conjuntos de alterações, consulte Exemplos de conjuntos de alterações para pilhas do CloudFormation.

Para visualizar as alterações no nível da propriedade em um conjunto de alterações (AWS CLI)

  • O comando a seguir lista as alterações no nível da propriedade relacionadas a um conjunto de alterações de um recurso AWS::EC2::NetworkInterface que removerá a propriedade Ipv4Prefixes, modificará a Description do recurso e adicionará uma Tag:

    aws cloudformation describe-change-set --include-property-values \
  --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841

    O seguinte é um exemplo de saída.

    "ChangeSetName": "ExampleChangeSet",
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:803642222207:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841",
    "StackId": "arn:aws:cloudformation:us-east-1:803642222207:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",
    "StackName": "ExampleStack",
    "Description": null,
    "Parameters": null,
    "CreationTime": "2024-04-09T18:04:59.935000+00:00",
    "ExecutionStatus": "AVAILABLE",
    "Status": "CREATE_COMPLETE",
    "StatusReason": null,
    "NotificationARNs": [],
    "RollbackConfiguration": {
        "RollbackTriggers": []
    },
    "Capabilities": [],
    "Tags": null,
    "ParentChangeSetId": null,
    "IncludeNestedStacks": true,
    "RootChangeSetId": null,
    "OnStackFailure": null,
 {
    "Changes": [
        {
            "Type": "Resource",
            "ResourceChange": {
                "Action": "Modify",
                "LogicalResourceId": "EC2NetworkInterface00eni067fd35b649a05b7100Tpyls",
                "PhysicalResourceId": "eni-067fd35b649a05b71",
                "ResourceType": "AWS::EC2::NetworkInterface",
                "Replacement": "False",
                "Scope": [
                    "Properties",
                    "Tags"
                ],
                "Details": [
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Ipv4Prefixes",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Ipv4Prefixes",
                            "BeforeValue": "[]",
                            "AttributeChangeType": "Remove"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    },
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Description",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Description",
                            "BeforeValue": "",
                            "AfterValue": "Description",
                            "AttributeChangeType": "Modify"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    },
                    {
                        "Target": {
                            "Attribute": "Tags",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Tags/0",
                            "AfterValue": "{\"Key\":\"Test\",\"Value\":\"Test\"}",
                            "AttributeChangeType": "Add"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    }
                ],
                "BeforeContext": "{\"Properties\":{\"Description\":\"\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4Prefixes\":[],\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}",
                "AfterContext": "{\"Properties\":{\"Description\":\"Description\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[{\"Value\":\"Test\",\"Key\":\"Test\"}]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}"
            }
        }
    ],
    "ChangeSetName": "ExampleChangeSet",
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841",
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",