Création d'un ensemble de modifications - 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.

Création d'un ensemble de modifications

Pour créer un ensemble de modifications pour une pile en cours d'exécution, soumettez les modifications que vous souhaitez apporter en fournissant un modèle modifié, de nouvelles valeurs de paramètres d'entrée, ou les deux. CloudFormation génère un ensemble de modifications en comparant votre pile aux modifications que vous avez soumises.

Vous pouvez modifier un modèle avant de créer le jeu de modifications ou lors de la création du jeu de modifications.

Create a change set (console)
Pour créer un ensemble de modifications

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

  2. Dans la barre de navigation en haut de l'écran, choisissez votre Région AWS.

  3. Sur la page Stacks, choisissez la pile courante pour laquelle vous souhaitez créer un ensemble de modifications.

  4. Dans le volet des détails de la pile, choisissez Stack actions (Actions de pile), puis choisissez Créer un jeu de modifications pour la pile actuelle.

  5. Sur le paramètre Créer une modification défini pour stack-namepage, effectuez l'une des opérations suivantes pour modifier les valeurs des paramètres d'entrée, spécifier l'emplacement d'un modèle mis à jour ou modifier le modèle :

    Tâche Action
    Pour modifier les valeurs des paramètres d'entrée Choisissez Utiliser un modèle existant, puis cliquez sur Suivant pour saisir ou modifier les valeurs des paramètres d'entrée.
    Pour spécifier l'emplacement d'un modèle mis à jour

    Si vous avez modifié le modèle, choisissez Remplacer le modèle existant, puis effectuez l'une des opérations suivantes :

    • Pour un modèle stocké dans un compartiment Amazon S3, choisissez Amazon S3 URL. Entrez ou collez le code URL correspondant au modèle, puis choisissez Next.

      Si vous avez un modèle dans un compartiment activé pour la gestion des versions, vous pouvez spécifier une version spécifique du modèle en l'ajoutant ?versionId=version-id au. URL Pour plus d'informations, consultez la section Utilisation d'objets dans un compartiment activé pour la gestion des versions dans le guide de l'utilisateur d'Amazon Simple Storage Service.

    • Pour un modèle stocké localement sur votre ordinateur, choisissez Upload a template file (Charger un fichier de modèle). Choisissez Choose File (Choisir un fichier) pour accéder au fichier et le sélectionner, puis choisissez Suivant.
    Pour modifier le modèle Si vous n'avez pas modifié le modèle, choisissez Modifier le modèle dans Infrastructure Composer, puis sélectionnez Modifier dans Infrastructure Composer. Vous êtes redirigé vers AWS Infrastructure Composer. Une fois que vous avez modifié le modèle, choisissez Créer un ensemble de modifications, puis Confirmer et continuer CloudFormation pour revenir au set de création de modifications pour stack-namepage, puis choisissez Next.

  6. Sur la page Spécifier les détails de la pile, spécifiez le nom de l'ensemble de modifications et spécifiez éventuellement une description de l'ensemble de modifications pour identifier son objectif dans la section Vue d'ensemble. Si votre modèle contient des paramètres, sur la page Specify stack details (Spécifier les détails de la pile), entrez ou modifiez les valeurs des paramètres d'entrée applicables, puis choisissez Suivant.

    Si vous réutilisez le modèle de la pile, CloudFormation renseignez chaque paramètre avec la valeur actuelle de la pile, à l'exception des paramètres déclarés avec l'NoEchoattribut. Pour utiliser les valeurs existantes pour ces paramètres, sélectionnez Utiliser valeur existante.

    Pour plus d'informations sur l'utilisation NoEcho pour masquer des informations sensibles et sur l'utilisation de paramètres dynamiques pour gérer les secrets, consultez les N'incorporez pas d'informations d'identification dans vos modèles meilleures pratiques.

  7. Sur la page Configurer les options de la pile, mettez à jour les balises de la pile, le rôle de IAM service, la politique de la pile, la configuration de restauration, le sujet de SNS notification Amazon (le cas échéant) ou les ensembles de modifications.

    Note

    Les ensembles de modifications pour les piles imbriquées sont Activés par défaut, ce qui crée des ensembles de modifications pour toutes les piles imbriquées spécifiées dans votre modèle. Pour créer un ensemble de modifications pour la pile active uniquement, choisissez Désactivé. Pour plus d'informations sur les ensembles de modifications pour les piles imbriquées, consultez. Modifier les ensembles pour les piles imbriquées

  8. Si le modèle inclut des IAM ressources, pour Capacités, sélectionnez Je reconnais que cela CloudFormation pourrait créer IAM des ressources. IAMles ressources peuvent modifier les autorisations de votre AWS compte ; passez en revue ces ressources pour vous assurer que vous n'autorisez que les actions que vous souhaitez. Pour de plus amples informations, veuillez consulter Confirmation des ressources IAM dans les modèles CloudFormation.

  9. Choisissez Next (Suivant) pour continuer.

  10. À propos de la révision stack-namepage, passez en revue les modifications apportées à cet ensemble de modifications.

  11. Sélectionnez Envoyer.

    Vous êtes redirigé vers l'onglet Modifications de la page des détails du jeu de modifications. Lors de CloudFormation la génération de l'ensemble de modifications, le statut de l'ensemble de modifications estCREATE_PENDING. Après avoir créé l'ensemble de modifications, CloudFormation définit le statut surCREATE_COMPLETE. Dans la section Modifications, CloudFormation répertorie toutes les modifications qu'il apportera à votre pile. Pour de plus amples informations, veuillez consulter Afficher un ensemble de modifications.

    Choisissez Afficher les détails dans la colonne Modifications au niveau de la propriété pour afficher les modifications apportées au niveau de la propriété.

    Si vous CloudFormation ne parvenez pas à créer l'ensemble de modifications (FAILEDétat des rapports), corrigez l'erreur affichée dans le champ État, puis recréez le jeu de modifications.

  12. Après avoir confirmé que les modifications semblent correctes, choisissez Execute change set

Create a change set for nested stacks (console)
Pour créer un ensemble de modifications pour les piles imbriquées

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

  2. Dans la barre de navigation en haut de l'écran, choisissez votre Région AWS.

  3. Sur la page Stacks, sélectionnez la pile courante pour laquelle vous souhaitez créer un ensemble de modifications.

  4. Dans le volet des détails de la pile, choisissez Stack actions (Actions de pile), puis choisissez Créer un jeu de modifications pour la pile actuelle.

  5. Sur le paramètre Créer une modification défini pour stack-namepage, effectuez l'une des opérations suivantes pour modifier les valeurs des paramètres d'entrée, spécifier l'emplacement d'un modèle mis à jour ou modifier le modèle :

    Tâche Action
    Pour modifier les valeurs des paramètres d'entrée Choisissez Utiliser un modèle existant, puis cliquez sur Suivant pour saisir ou modifier les valeurs des paramètres d'entrée.
    Pour spécifier l'emplacement d'un modèle mis à jour

    Si vous avez modifié le modèle, choisissez Remplacer le modèle existant, puis effectuez l'une des opérations suivantes :

    • Pour un modèle stocké dans un compartiment Amazon S3, choisissez Amazon S3 URL. Entrez ou collez le code URL correspondant au modèle, puis choisissez Next.

      Si vous avez un modèle dans un compartiment activé pour la gestion des versions, vous pouvez spécifier une version spécifique du modèle en l'ajoutant ?versionId=version-id au. URL Pour plus d'informations, consultez la section Utilisation d'objets dans un compartiment activé pour la gestion des versions dans le guide de l'utilisateur d'Amazon Simple Storage Service.

    • Pour un modèle stocké localement sur votre ordinateur, choisissez Upload a template file (Charger un fichier de modèle). Choisissez Choose File (Choisir un fichier) pour accéder au fichier et le sélectionner, puis choisissez Suivant.
    Pour modifier le modèle Si vous n'avez pas modifié le modèle, choisissez Modifier le modèle dans Infrastructure Composer, puis sélectionnez Modifier dans Infrastructure Composer. Vous êtes redirigé vers AWS Infrastructure Composer. Une fois que vous avez modifié le modèle, choisissez Créer un ensemble de modifications, puis Confirmer et continuer CloudFormation pour revenir au set de création de modifications pour stack-namepage, puis choisissez Next.

  6. Sur la page Spécifier les détails de la pile, spécifiez le nom de l'ensemble de modifications et spécifiez éventuellement une description de l'ensemble de modifications pour identifier son objectif dans la section Vue d'ensemble. Si votre modèle contient des paramètres, sur la page Specify stack details (Spécifier les détails de la pile), entrez ou modifiez les valeurs des paramètres d'entrée applicables, puis choisissez Suivant.

    Si vous réutilisez le modèle de la pile, CloudFormation renseignez chaque paramètre avec la valeur actuelle de la pile, à l'exception des paramètres déclarés avec l'NoEchoattribut. Pour utiliser les valeurs existantes pour ces paramètres, sélectionnez Utiliser valeur existante.

    Pour plus d'informations sur l'utilisation NoEcho pour masquer des informations sensibles, ainsi que sur l'utilisation de paramètres dynamiques pour gérer les secrets, consultez les N'incorporez pas d'informations d'identification dans vos modèles meilleures pratiques.

  7. Sur la page Configurer les options de la pile, mettez à jour les balises de la pile, le rôle de IAM service, la politique de la pile, la configuration de restauration, le sujet de SNS notification Amazon (le cas échéant) ou les ensembles de modifications.

    Note

    Les ensembles de modifications pour les piles imbriquées sont Activés par défaut, ce qui crée des ensembles de modifications pour toutes les piles imbriquées spécifiées dans votre modèle. Pour plus d'informations sur les ensembles de modifications pour les piles imbriquées, consultez. Modifier les ensembles pour les piles imbriquées

  8. Si le modèle inclut des IAM ressources, pour Capacités, sélectionnez Je reconnais que cela CloudFormation pourrait créer IAM des ressources. IAMles ressources peuvent modifier les autorisations de votre AWS compte ; passez en revue ces ressources pour vous assurer que vous n'autorisez que les actions que vous souhaitez. Pour de plus amples informations, veuillez consulter Confirmation des ressources IAM dans les modèles CloudFormation.

  9. Choisissez Next (Suivant) pour continuer.

  10. À propos de la révision stack-namepage, passez en revue les modifications apportées à cet ensemble de modifications.

  11. Sélectionnez Envoyer.

    Vous êtes redirigé vers l'onglet Modifications de la page des détails du jeu de modifications. Lors de CloudFormation la génération de l'ensemble de modifications, le statut de l'ensemble de modifications estCREATE_PENDING. Après avoir créé l'ensemble de modifications, CloudFormation définit le statut surCREATE_COMPLETE. Dans la section Modifications, CloudFormation répertorie toutes les modifications qu'il apportera à votre pile. Pour de plus amples informations, veuillez consulter Afficher un ensemble de modifications.

    Si vous CloudFormation ne parvenez pas à créer l'ensemble de modifications (FAILEDétat des rapports), corrigez l'erreur affichée dans le champ État, puis recréez le jeu de modifications.

  12. Après avoir confirmé que les modifications semblent correctes, choisissez Execute change set

Pour créer un ensemble de modifications (AWS CLI)

  • Exécutez le create-change-setcommande.

    Vous soumettez vos modifications en tant qu'options de commande. Vous pouvez spécifier de nouvelles valeurs de paramètre, un modèle mis à jour ou les deux. Par exemple, la commande suivante crée un jeu de modifications nommé SampleChangeSet pour la pile SampleStack. Ce jeu de modifications utilise le modèle de la pile actuelle, mais avec une autre valeur pour le paramètre Purpose :

    aws cloudformation create-change-set \
    --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000 \
    --change-set-name SampleChangeSet --use-previous-template \
    --parameters \
      ParameterKey="InstanceType",UsePreviousValue=true ParameterKey="KeyPairName",UsePreviousValue=true ParameterKey="Purpose",ParameterValue="production"