Anzeigen eines Änderungssatzes für einen CloudFormation-Stack - AWS CloudFormation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Anzeigen eines Änderungssatzes für einen CloudFormation-Stack

Nach dem Erstellen eines Änderungssatzes können Sie die vorgeschlagenen Änderungen vor der Ausführung anzeigen. Verwenden Sie die CloudFormation-Konsole, AWS CLI oder CloudFormation-API, um Änderungssätze anzuzeigen. Die CloudFormation-Konsole enthält eine Zusammenfassung der Änderungen und eine detaillierte Liste der Änderungen im JSON-Format. Die AWS CLI und AWS CloudFormation-API geben eine detaillierte Liste der Änderungen im JSON-Format zurück.

View a change set (console)
So zeigen Sie einen Änderungssatz an

  1. Öffnen Sie die CloudFormation-Konsole unter https://console.aws.amazon.com/cloudformation.

  2. Wählen Sie in der Navigationsleiste am oberen Rand des Bildschirms Ihren AWS-Region.

  3. Wählen Sie auf der Seite Stapel den Namen des Stapels, der den Änderungssatz enthält, den Sie ansehen möchten.

  4. Wählen Sie im Navigationsbereich die Option Change Sets (Änderungssätze) aus, um eine Liste der Änderungssätze des Stack anzuzeigen.

  5. Wählen Sie den Namen des Änderungssatzes aus, den Sie anzeigen möchten.

    Die CloudFormation-Konsole leitet Sie zur Detailseite des Änderungssatzes weiter, auf der Sie den Zeitpunkt sehen können, zu dem der Änderungssatz erstellt wurde, sowie dessen Status, die Eingaben, die für die Erstellung des Änderungssatzes verwendet wurden und eine Zusammenfassung der Änderungen.

    Im Abschnitt Changes (Änderungen) stellt jede Zeile eine Ressource dar, die von CloudFormation hinzugefügt, geändert oder entfernt wird.

    • Hinzufügen – CloudFormation erstellt eine Ressource, sobald Sie der Stack-Vorlage eine Ressource hinzufügen.

    • Ändern – CloudFormation ändert eine Ressource, wenn Sie die Eigenschaften einer Ressource in der Stack-Vorlage ändern.

    • Entfernen – CloudFormation löscht eine Ressource, sobald Sie eine vorhandene Ressource aus der Stack-Vorlage löschen.

    Anmerkung

    Eine Änderung kann dazu führen, dass die Ressource unterbrochen oder ersetzt (neu erstellt) werden muss. Weitere Informationen zum Verhalten von Ressourcenaktualisierungen finden Sie unter Verstehen des Aktualisierungsverhaltens von Stack-Ressourcen.

    Um bestimmte Änderungen anzuzeigen, verwenden Sie die Filteransicht. Filtern Sie beispielsweise nach einem bestimmten Ressourcentyp, z. B. AWS::EC2::Instance. Geben Sie zum Filtern nach einer bestimmten Ressource die logische oder physische ID an, z. B. myWebServer oder i-123abcd4.

  6. Wählen Sie im Abschnitt Änderungen die Option Details anzeigen in der Spalte Änderungen auf Eigenschaftsebene um die an Ihrer Ressource vorgenommenen Änderungen der Eigenschaftswerte anzuzeigen.

  7. Die CloudFormation-Konsole leitet Sie auf die Seite mit den Änderungen auf Eigenschaftsebene für eine Ressource weiter, wo Sie die Vorlagenkonfiguration der Ressource vor der Ausführung eines Änderungssatzes sehen können und wie die Vorlagenkonfiguration nach der Ausführung des Änderungssatzes aussehen wird.

    Die Tabelle im Abschnitt Änderungen auf Grundstücksebene zeigt den Pfad, Änderungstyp, Vorwertund Nachwert für die betroffenen Grundstücke. Aktivieren Sie in der Tabelle das Kontrollkästchen für jede Änderung, die Sie in den Ansichten Vor und Nach Ihrer Vorlage hervorheben möchten, um zu sehen, welche Änderungen auf der Ebene der Eigenschaften vorgenommen werden.

    • Hinzufügen- Hinzugefügte Eigenschaften werden grün hervorgehoben.

    • Ändern- Geänderte Eigenschaften werden blau hervorgehoben.

    • Entfernen- Entfernte Eigenschaften werden rot hervorgehoben.

View a change set for nested stack (console)
So zeigen Sie einen Änderungssatz für verschachtelte Stacks an (Konsole)

  1. Öffnen Sie die CloudFormation-Konsole unter https://console.aws.amazon.com/cloudformation.

  2. Wählen Sie in der Navigationsleiste am oberen Rand des Bildschirms Ihren AWS-Region.

  3. Wählen Sie auf der Seite Stapel den Namen des Stapels, der den Änderungssatz enthält, den Sie ansehen möchten.

  4. Wählen Sie im Navigationsbereich Änderungssätze um eine Liste der Änderungssätze des Stapels anzuzeigen.

  5. Wählen Sie den Namen des Änderungssatzes aus, den Sie anzeigen möchten.

    Die CloudFormation-Konsole leitet Sie zur Detailseite des Änderungssatzes weiter, auf der Sie den Zeitpunkt sehen können, zu dem der Änderungssatz erstellt wurde, sowie dessen Status, die Eingaben, die für die Erstellung des Änderungssatzes verwendet wurden und eine Zusammenfassung der Änderungen.

    Im Abschnitt Changes (Änderungen) steht jede Zeile für eine Ressource, die CloudFormation hinzufügen, ändern oder entfernen wird oder die den Status „Dynamisch“ anzeigen wird.

    • Hinzufügen – CloudFormation erstellt eine Ressource, sobald Sie der Stack-Vorlage eine Ressource hinzufügen.

    • Ändern – CloudFormation ändert eine Ressource, wenn Sie die Eigenschaften einer Ressource in der Stack-Vorlage ändern.

    • Entfernen – CloudFormation löscht eine Ressource, sobald Sie eine vorhandene Ressource aus der Stack-Vorlage löschen.

    • Dynamisch – CloudFormation kann die exakte Ressourcenänderungsaktion aus der Vorlage des verschachtelten Stacks nicht bestimmen.

    Anmerkung

    Eine Änderung kann dazu führen, dass die Ressource unterbrochen oder ersetzt (neu erstellt) werden muss. Weitere Informationen zum Verhalten von Ressourcenaktualisierungen finden Sie unter Verstehen des Aktualisierungsverhaltens von Stack-Ressourcen.

    Um bestimmte Änderungen anzuzeigen, verwenden Sie die Filteransicht. Filtern Sie beispielsweise nach einem bestimmten Ressourcentyp, z. B. AWS::CloudFormation::Stack. Geben Sie zum Filtern nach einer bestimmten Ressource die logische oder physische ID an, z. B. DeadLetterQueue oder NestedStack.

  6. Wählen Sie im Abschnitt Änderungen die Option Verschachtelten Änderungssatz anzeigen des verschachtelten Änderungssatzes, den Sie anzeigen möchten.

    Die CloudFormation-Konsole leitet Sie zur Detailseite des verschachtelten Änderungssatzes weiter. Sie können Zu Root-Änderungssatz gehen wählen, um den Root-Änderungssatz anzuzeigen, oder Sie können Übergeordneten Änderungssatz anzeigen wählen, um den übergeordneten Änderungssatz anzuzeigen. Für weitere Informationen siehe Änderungssätze für verschachtelte Stacks.

    Anmerkung

    CloudFormation-Änderungssätze auf Eigenschaftsebene lösen stapelübergreifende Referenzen nicht auf, wenn Sie Änderungssätze für verschachtelte Stapel erstellen. Änderungssätze können Ressourcen in einem Child-Stack für eine bedingte Ersetzung markieren, wenn sie auf die Ausgabe eines Parent-Stacks verweisen und der Parent-Stack geändert wurde.

So zeigen Sie einen Änderungssatz an (AWS CLI)

  1. Um die ID des Änderungssatzes abzurufen, führen Sie den Befehl change-sets aus.

    Geben Sie den Namen des Stapels an, der den Änderungssatz enthält, den Sie anzeigen möchten, wie im folgenden Beispiel gezeigt:

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

    CloudFormation gibt eine Liste der Änderungssätze ähnlich der folgenden Liste zurück:

    {
    "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. Führen Sie den Befehl describe-change-set aus, der die ID des Änderungssatzes enthält, den Sie anzeigen möchten. Zum Beispiel:

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

    CloudFormation gibt Informationen über den angegebenen Änderungssatz zurück.

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

    Verwenden Sie --include-property-values mit describe-change-set, um die Änderungen auf Eigenschaftsebene aufzulisten.

    Der Changes-Schlüssel listet Änderungen an Ressourcen auf. Wenn Sie diese Änderungssatz ausführen würden, würde CloudFormation die Tags der i-1abc23d4-EC2-Instance aktualisieren. Eine Beschreibung der einzelnen Felder finden Sie unter dem Datentyp Change in der AWS CloudFormation API-Referenz.

    Weitere Beispiele von Änderungssätzen finden Sie unter Beispiel für Änderungssätze für CloudFormation Stapel.

So zeigen Sie Änderungen auf Eigenschaftsebene in einem Änderungssatz (AWS CLI) an

  • Der folgende Befehl listet die Änderungen auf Eigenschaftsebene auf, die mit einem Änderungssatz für eine AWS::EC2::NetworkInterface-Ressource verbunden sind, der die Ipv4Prefixes-Eigenschaft entfernt, die Description-Eigenschaft für die Ressource ändert und eine Taghinzufügt:

    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

    Es folgt eine Beispielausgabe.

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