Afficher un jeu de modifications pour une pile CloudFormation - AWS CloudFormation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Afficher un jeu de modifications pour une pile CloudFormation

Après avoir créé un jeu de modifications, vous pouvez afficher les modifications proposées avant de les exécuter. Vous pouvez utiliser la console CloudFormation, l'AWS CLI ou l'API CloudFormation pour afficher les jeux de modifications. La console CloudFormation propose un récapitulatif des modifications, ainsi qu'une liste détaillée des modifications au format JSON. La AWS CLI et l'API AWS CloudFormation renvoient une liste détaillée des modifications au format JSON.

View a change set (console)
Pour afficher un jeu de modifications

  1. Ouvrez la console CloudFormation, à l’adresse https://console.aws.amazon.com/cloudformation.

  2. Dans la barre de navigation, en haut de l’écran, sélectionnez votre Région AWS.

  3. Sur la page Piles, sélectionnez le nom de la pile contenant le jeu de modifications que vous voulez afficher.

  4. Dans le volet de navigation, choisissez Jeux de modifications pour afficher la liste des jeux de modifications de la pile.

  5. Choisissez le nom de l’ensemble de modifications que vous souhaitez afficher.

    La console CloudFormation vous renvoie vers la page de détails du jeu de modifications. Cette dernière indique l'heure à laquelle il a été créé, son statut, l'entrée utilisée pour générer ce jeu de modifications et un résumé des modifications.

    Dans la section Modifications , chaque ligne représente une ressource que CloudFormation va ajouter, modifier ou retirer.

    • Ajouter : – CloudFormationcrée une ressource lorsque vous en ajoutez une au modèle de la pile.

    • Modifier – CloudFormationmodifie une ressource lorsque vous modifiez les propriétés d'une ressource dans le modèle de la pile.

    • Retirer : – CloudFormation supprime une ressource lorsque vous en supprimez une du modèle de la pile.

    Note

    Une modification peut entraîner l'interruption ou le remplacement (ou la recréation) de la ressource. Pour plus d'informations sur les mises à jour de ressources, consultez Comprendre les comportements de mise à jour des ressources d’une pile.

    Pour cibler des modifications spécifiques, utilisez la vue filtre. Par exemple, filtrez un type de ressource spécifique, tel que AWS::EC2::Instance. Pour filtrer une ressource spécifique, spécifiez son ID physique ou logique, tel que myWebServer ou i-123abcd4.

  6. Dans la section Modifications, sélectionnez Afficher les détails dans la colonne Modifications au niveau des propriétés pour afficher les modifications apportées aux valeurs des propriétés de votre ressource.

  7. La console CloudFormation vous redirige vers la page des modifications au niveau des propriétés d’une ressource, où vous pouvez voir la configuration du modèle de la ressource avant l’exécution d’un jeu de modifications et à quoi ressemblera la configuration du modèle après l’exécution du jeu de modifications.

    Le tableau de la section Modifications au niveau des propriétés affiche le Chemin d’accès, le Type de modification, la Valeur avant, et la Valeur après pour les propriétés concernées. Dans le tableau, cochez la case correspondant à chaque modification que vous voulez mettre en évidence dans les vues Avant et Après de votre modèle afin de voir les modifications qui seront apportées au niveau des propriétés.

    • Ajouter : les propriétés ajoutées sont surlignées en vert.

    • Modifier : les propriétés modifiées sont surlignées en bleu.

    • Supprimer : les propriétés supprimées sont mises en évidence en rouge.

View a change set for nested stack (console)
Pour afficher un ensemble de modifications pour les piles imbriquées (console)

  1. Ouvrez la console CloudFormation, à l’adresse https://console.aws.amazon.com/cloudformation.

  2. Dans la barre de navigation, en haut de l’écran, sélectionnez votre Région AWS.

  3. Sur la page Piles, sélectionnez le nom de la pile contenant le jeu de modifications que vous voulez afficher.

  4. Dans le volet de navigation, choisissez Jeux de modifications pour afficher la liste des jeux de modifications de la pile.

  5. Choisissez le nom de l’ensemble de modifications que vous souhaitez afficher.

    La console CloudFormation vous renvoie vers la page de détails du jeu de modifications. Cette dernière indique l'heure à laquelle il a été créé, son statut, l'entrée utilisée pour générer ce jeu de modifications et un résumé des modifications.

    Dans la section Modifications , chaque ligne représente une ressource que CloudFormation va ajouter, modifier ou retirer ou dont il affichera l'état de dynamique.

    • Ajouter : – CloudFormationcrée une ressource lorsque vous en ajoutez une au modèle de la pile.

    • Modifier – CloudFormationmodifie une ressource lorsque vous modifiez les propriétés d'une ressource dans le modèle de la pile.

    • Retirer : – CloudFormation supprime une ressource lorsque vous en supprimez une du modèle de la pile.

    • Dynamique : – CloudFormation ne peut déterminer l'action exacte de modification de ressource à partir du modèle de la pile imbriquée.

    Note

    Une modification peut entraîner l'interruption ou le remplacement (ou la recréation) de la ressource. Pour plus d'informations sur les mises à jour de ressources, consultez Comprendre les comportements de mise à jour des ressources d’une pile.

    Pour cibler des modifications spécifiques, utilisez la vue filtre. Par exemple, filtrez un type de ressource spécifique, tel que AWS::CloudFormation::Stack. Pour filtrer une ressource spécifique, spécifiez son ID physique ou logique, tel que DeadLetterQueue ou NestedStack.

  6. Dans la section Modifications , choisissez Afficher l’ensemble de modifications imbriqué de l’ensemble de modifications imbriqué que vous souhaitez afficher.

    La console CloudFormation vous dirige vers la page d’informations de l’ensemble de modifications imbriqué. Vous pouvez choisir Accéder à l’ensemble de modifications racine pour afficher l’ensemble de modifications racine ou choisissez Afficher l’ensemble de modifications parent pour afficher l’ensemble de modifications parent. Pour plus d’informations, consultez Modifier les ensembles pour les piles imbriquées.

    Note

    Les jeux de modifications au niveau des propriétés CloudFormation ne résolvent pas les références entre piles lorsque vous créez des jeux de modifications pour des piles imbriquées. Les jeux de modifications peuvent marquer les ressources d’une pile enfant pour un remplacement conditionnel si elles font référence à la sortie d’une pile parent et que la pile parent a été modifiée.

Pour afficher un ensemble de modifications (AWS CLI)

  1. Pour obtenir l'ID du jeu de modifications, exécutez la commande change-sets.

    Indiquez le nom de la pile qui contient le jeu de modifications que vous voulez afficher, comme illustré dans l’exemple suivant :

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

    CloudFormation renvoie une liste de jeux de modifications, qui se présente de la manière suivante :

    {
    "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. Exécutez la commande describe-change-set, en spécifiant l'ID du jeu de modifications que vous souhaitez afficher. Par exemple :

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

    CloudFormation renvoie des informations sur le jeu de modifications spécifié.

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

    Utilisez --include-property-values avec describe-change-set pour répertorier les modifications au niveau des propriétés.

    La clé Changes répertorie les modifications apportées aux ressources. Si vous décidez d'exécuter ce jeu de modifications, CloudFormation mettra à jour les balises de l'instance EC2 i-1abc23d4. Pour obtenir une description de chaque champ, consultez le type de données Change dans la Référence d’API AWS CloudFormation.

    Pour obtenir des exemples supplémentaires de jeux de modifications, consultez la page Exemples d'ensembles de modifications pour les CloudFormation piles.

Pour afficher les modifications au niveau des propriétés dans un jeu de modifications (AWS CLI)

  • La commande suivante répertorie les modifications au niveau des propriétés liées à un jeu de modifications pour une ressource AWS::EC2::NetworkInterface qui supprimera la propriété Ipv4Prefixes, modifiera le Description pour la ressource et ajoutera 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

    Voici un exemple de sortie.

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