Visualizzare un set di modifiche per uno stack CloudFormation - AWS CloudFormation

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Visualizzare un set di modifiche per uno stack CloudFormation

Dopo aver creato un set di modifiche, è possibile visualizzare le modifiche proposte prima della loro esecuzione. Per visualizzare i set di modifiche puoi utilizzare la console CloudFormation, la AWS CLI o l'API CloudFormation. La console CloudFormation fornisce un riepilogo delle modifiche e un elenco dettagliato delle modifiche in formato JSON. AWS CLI e l'API AWS CloudFormation restituiscono un elenco dettagliato delle modifiche in formato JSON.

View a change set (console)
Per visualizzare un set di modifiche

  1. Apri la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.

  2. Nella barra di navigazione nella parte superiore dello schermo, scegli la Regione AWS.

  3. Nella pagina Stack, scegli il nome dello stack che contiene il set di modifiche che desideri visualizzare.

  4. Nel riquadro di navigazione, selezionare Change Sets (Set di modifiche) per visualizzare un elenco del set di modifiche dello stack.

  5. Selezionare il nome del set di modifiche che si desidera visualizzare.

    La console CloudFormation indirizza alla pagina dei dettagli del set di modifiche, dove è possibile vedere l'ora in cui il set di modifiche è stato creato, il relativo stato, l'input utilizzato per generare il set di modifiche e un riepilogo delle modifiche.

    Nella sezione Changes (Modifiche) ogni riga rappresenta una risorsa che CloudFormation aggiungerà, modificherà o rimuoverà.

    • Add (Aggiungi) – CloudFormation crea una risorsa quando si aggiunge una risorsa al modello dello stack.

    • Modify (Modifica) – CloudFormation modifica una risorsa quando si modificano le proprietà di una risorsa nel modello dello stack.

    • Remove (Elimina) – CloudFormation elimina una risorsa quando si elimina una risorsa dal modello dello stack.

    Nota

    Una modifica può causare l'interruzione o la sostituzione (nuova creazione) della risorsa. Per ulteriori informazioni sui comportamenti di aggiornamento delle risorse, consulta Comprendere l’aggiornamento dei comportamenti delle risorse stack.

    Per concentrarsi sulle modifiche specifiche, utilizzare la visualizzazione filtro. Ad esempio, il filtro per un determinato tipo di risorsa, ad esempio AWS::EC2::Instance. Per filtrare una risorsa specifica, specificare l'ID logico o fisico, ad esempio myWebServer o i-123abcd4.

  6. Nella sezione Modifiche, scegli Visualizza dettagli nella colonna Modifiche a livello di proprietà per visualizzare le modifiche apportate ai valori di proprietà della risorsa.

  7. La console CloudFormation ti reindirizza alla pagina delle modifiche a livello di proprietà di una risorsa, dove puoi visualizzare la configurazione del modello della risorsa prima di eseguire un set di modifica e come sarà la configurazione dopo l’esecuzione.

    La sezione della tabella Modifiche a livello di proprietà mostra i dettagli Percorso, Tipo di modifica, Prima del valore e Dopo il valore per le proprietà interessate. Nella tabella, seleziona la casella di controllo per ogni modifica che desideri evidenziare nelle viste Prima e Dopo del modello per visualizzare quali modifiche saranno apportate a livello di proprietà.

    • Aggiungi: le proprietà aggiunte sono evidenziate in blu.

    • Modifica: le proprietà modificate sono evidenziate in verde.

    • Rimuovi: le proprietà rimosse sono evidenziate in rosso.

View a change set for nested stack (console)
Per visualizzare un set di modifiche per gli stack nidificati (console)

  1. Apri la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.

  2. Nella barra di navigazione nella parte superiore dello schermo, scegli la Regione AWS.

  3. Nella pagina Stack, scegli il nome dello stack che contiene il set di modifiche che desideri visualizzare.

  4. Nel riquadro di navigazione, scegli Set di modifiche per visualizzare un elenco dei set di modifiche dello stack.

  5. Selezionare il nome del set di modifiche che si desidera visualizzare.

    La console CloudFormation indirizza alla pagina dei dettagli del set di modifiche, dove è possibile vedere l'ora in cui il set di modifiche è stato creato, il relativo stato, l'input utilizzato per generare il set di modifiche e un riepilogo delle modifiche.

    Nella sezione Changes (Modifiche), ogni riga rappresenta una risorsa che CloudFormation consente di aggiungere, modificare, rimuovere o visualizzare lo stato di dinamica.

    • Add (Aggiungi) – CloudFormation crea una risorsa quando si aggiunge una risorsa al modello dello stack.

    • Modify (Modifica) – CloudFormation modifica una risorsa quando si modificano le proprietà di una risorsa nel modello dello stack.

    • Remove (Elimina) – CloudFormation elimina una risorsa quando si elimina una risorsa dal modello dello stack.

    • Dynamic (Dinamico) – CloudFormation non può determinare l'esatta azione di modifica delle risorse dal modello dello stack nidificato.

    Nota

    Una modifica può causare l'interruzione o la sostituzione (nuova creazione) della risorsa. Per ulteriori informazioni sui comportamenti di aggiornamento delle risorse, consulta Comprendere l’aggiornamento dei comportamenti delle risorse stack.

    Per concentrarsi sulle modifiche specifiche, utilizzare la visualizzazione filtro. Ad esempio, il filtro per un determinato tipo di risorsa, ad esempio AWS::CloudFormation::Stack. Per filtrare una risorsa specifica, specificare l'ID logico o fisico, ad esempio DeadLetterQueue o NestedStack.

  6. Nella sezione Modificazioni scegliere Visualizza set di modifiche nidificato del set di modifiche nidificato che si desidera visualizzare.

    La console CloudFormation indirizza l'utente alla pagina dei dettagli del set di modifiche nidificato. È possibile scegliere Vai al set di modifiche root per visualizzare il set di modifiche root oppure scegliere Visualizza set di modifiche padre per visualizzare il set di modifiche padre. Per ulteriori informazioni, consulta Set di modifiche per stack nidificati.

    Nota

    I set di modifiche a livello di proprietà di CloudFormation non risolvono i riferimenti tra stack quando crei set di modifiche per stack nidificati. I set di modifiche possono contrassegnare le risorse in uno stack secondario per la sostituzione condizionale se fanno riferimento all’output di uno stack padre e tale stack è stato modificato.

Per visualizzare un set di modifiche (AWS CLI)

  1. Per ottenere l'ID del set di modifiche, eseguire il comando change-sets.

    Specifica il nome dello stack che dispone del set di modifiche che desideri visualizzare, come nel seguente esempio:

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

    CloudFormation restituisce un elenco di set di modifiche, in modo analogo a quanto segue:

    {
    "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. Eseguire il comando describe-change-set, specificando l'ID del set di modifiche che si desidera visualizzare. Ad esempio:

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

    CloudFormation restituisce informazioni sui set di modifiche specificato.

    {
    "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"
}

    Usa --include-property-values con describe-change-set per elencare le modifiche a livello di proprietà.

    La chiave Changes elenca le modifiche apportate alle risorse. Se si esegue questo set di modifiche, CloudFormation aggiorna i tag dell'istanza EC2 i-1abc23d4. Per una descrizione di ogni campo, consulta il tipo di dati Change nella Documentazione di riferimento all’API AWS CloudFormation.

    Per ulteriori esempi di set di modifiche, consulta Esempi di set di modifiche per le CloudFormation pile.

Per visualizzare le modifiche a livello di proprietà in un set di modifiche (AWS CLI)

  • Il seguente comando elenca le modifiche a livello di proprietà relative a un set di modifiche per una risorsa AWS::EC2::NetworkInterface che rimuove la proprietà Ipv4Prefixes, modifica la Description della risorsa e aggiunge un 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

    Di seguito è riportato un output di esempio.

    "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",