Remplacer les valeurs des paramètres sur les piles de votre CloudFormation StackSet - AWS CloudFormation
Remplacer les paramètres sur les piles (console)Remplacer les paramètres sur les piles (AWS CLI)

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.

Remplacer les valeurs des paramètres sur les piles de votre CloudFormation StackSet

Dans certains cas, vous pouvez souhaiter que les piles de certaines régions ou certains comptes aient des valeurs de propriété différentes de celles spécifiées dans le StackSet lui-même. Par exemple, vous pourriez spécifier une autre valeur pour un paramètre donné selon l'objectif de développement ou de production d'un compte. Dans ces situations, CloudFormation vous permet de remplacer les valeurs des paramètres dans les piles par compte et par région. Vous pouvez remplacer les valeurs des paramètres du modèle lors de la création initiale des piles, et vous pouvez remplacer les valeurs des paramètres pour les piles existantes. Vous ne pouvez rétablir les paramètres que vous avez précédemment remplacés dans les piles qu’aux valeurs spécifiées dans le StackSet.

Les remplacements de valeurs de paramètres s’appliquent aux piles dans les comptes et les régions que vous sélectionnez. Lors des mises à jour StackSet, les valeurs des paramètres remplacées pour une pile ne sont pas mises à jour, mais conservent leur valeur remplacée.

Vous ne pouvez remplacer que les valeurs des paramètres spécifiés dans le StackSet ; pour ajouter ou supprimer un paramètre, vous devez mettre à jour le modèle StackSet. Si vous ajoutez un paramètre à un modèle StackSet, vous devez d’abord mettre à jour toutes les piles avec le nouveau paramètre et la nouvelle valeur spécifiés dans le StackSet avant de pouvoir remplacer la valeur de ce paramètre dans une pile. Une fois que toutes les piles ont été mises à jour avec le nouveau paramètre, vous pouvez alors remplacer la valeur du paramètre dans les piles individuelles comme vous le souhaitez.

Pour savoir comment remplacer les valeurs des paramètres StackSet lors de la création de piles, consultez Ajouter des piles à des StackSets.

Remplacer les paramètres sur les piles (console)

Pour remplacer les paramètres de piles spécifiques

  1. Connectez-vous à la AWS Management Console et 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 l’élément Région AWS dans lequel vous avez créé le StackSet.

  3. Choisissez StackSets dans le volet de navigation. Sur la page StackSets, sélectionnez votre StackSet.

  4. Le StackSet étant sélectionné, choisissez Remplacer les paramètres StackSet dans le menu Actions.

  5. Sur la page Options de déploiement, indiquez les comptes et les régions pour les piles pour lesquelles vous allez créer des remplacements.

    Par défaut, CloudFormation déploiera les piles dans les comptes spécifiés dans la première région, puis passera à la suivante, et ainsi de suite, tant que les échecs de déploiement d’une région ne dépasseront pas la tolérance aux pannes spécifiée.

    1. [Autorisations autogérées] Pour les Emplacements de déploiement, choisissez Déployer les piles dans les comptes. Collez certains ou tous les ID des comptes de destination que vous avez utilisés pour créer votre ensemble de piles dans votre StackSet.

      [Autorisations gérées par le service] Effectuez l’une des méthodes suivantes :

      • Choisissez Déployer vers les unités organisationnelles (UO). Entrez une ou plusieurs des UO cibles que vous avez utilisées pour créer votre StackSet. Les valeurs de paramètre remplacées s'appliquent uniquement aux comptes qui se trouvent actuellement dans les UO cibles et leurs UO enfants. Les comptes ajoutés aux UO cibles et à leurs UO enfants utiliseront les valeurs par défaut du StackSet et non les valeurs remplacées.

      • Choisissez Déployer sur les comptes. Collez certains ou tous les ID d’UO ou ID de compte cibles que vous avez utilisés pour créer votre ensemble de piles dans votre StackSet.

    2. Pour Spécifier les régions, ajoutez une ou plusieurs des régions dans lesquelles vous avez déployé des piles pour ce StackSet.

      Si vous ajoutez plusieurs régions, l'ordre des régions sous Specify regions (Spécifier des régions) détermine l'ordre de leur déploiement.

    3. Pour Options de déploiement, procédez comme suit :

      • Pour Nombre maximal de comptes simultanés, spécifiez le nombre de comptes traités simultanément.

      • Pour Tolérance aux défaillances, spécifiez le nombre maximum de défaillances de compte autorisées par région. L’opération s’arrêtera et ne se poursuivra pas dans d’autres régions une fois cette limite atteinte.

      • Pour la simultanéité des régions, choisissez comment traiter les régions : séquentiellement (une région à la fois) ou en parallèle (plusieurs régions simultanément).

      • Pour le mode simultané, choisissez le comportement de la simultanéité lors de l’exécution de l’opération.

        • Tolérance stricte aux pannes : réduit le niveau de concurrence des comptes en cas de panne, en restant dans les limites de la tolérance aux pannes +1.

        • Tolérance aux pannes légères : maintient le niveau de concurrence spécifié (la valeur du nombre maximal de comptes simultanés) indépendamment des pannes.

    4. Choisissez Suivant.

  6. Sur la page Spécifier les remplacements, cochez les cases correspondant aux paramètres à remplacer, puis sélectionnez Remplacer la valeur StackSet dans le menu Modifier la valeur de remplacement.

  7. Sur la page Valeurs des paramètres StackSet de remplacement, apportez vos modifications, puis sélectionnez Enregistrer les modifications.

    Note

    Pour rétablir la valeur spécifiée dans StackSet pour tous les paramètres remplacés, vérifiez tous les paramètres et sélectionnez Définir la valeur StackSet dans le menu Modifier la valeur de remplacement. Cela supprime toutes les valeurs remplacées une fois que vous avez mis à jour les piles.

  8. Sur la page Vérification, vérifiez vos choix. Pour apporter des modifications, sélectionnez Modifier dans la section correspondante.

  9. Lorsque vous êtes prêt à continuer, sélectionnez Soumettre.

    CloudFormation commence à mettre à jour vos piles. Affichez la progression et l’état des piles dans la page de détails StackSet qui s’ouvre lorsque vous sélectionnez Soumettre.

Remplacer les paramètres sur les piles (AWS CLI)

Note

Lorsque vous agissez en tant qu’administrateur délégué, vous devez inclure --call-as DELEGATED_ADMIN dans la commande.

Pour remplacer les paramètres de piles spécifiques

  1. Utilisez la commande update-stack-instances AWS CLI et spécifiez l’option --parameter-overrides.

    [Autorisations autogérées] Pour cette option --accounts, indiquez les ID de compte pour lesquels vous souhaitez remplacer les valeurs des paramètres sur les piles.

    aws cloudformation update-stack-instances --stack-set-name my-stackset \
  --parameter-overrides ParameterKey=Subnets,ParameterValue=subnet-1baa3351\\,subnet-27b86940 \
  --accounts account_id --regions us-east-1

    [Autorisations gérées par le service] Pour cette option --deployment-targets, indiquez l’ID racine de l’organisation, les ID d’UO ou les ID de compte AWS Organizations pour lesquels vous souhaitez remplacer les paramètres des piles. Dans cet exemple, nous remplaçons les valeurs des paramètres pour les piles dans tous les comptes de l’UO avec l’ID ou-rcuk-1x5j1lwo.

    Les valeurs de paramètre remplacées s'appliquent uniquement aux comptes qui se trouvent actuellement dans l'UO cible et ses UO enfants. Les comptes ajoutés à l’UO cible et à ses UO enfants à l’avenir utiliseront les valeurs par défaut du StackSet et non les valeurs remplacées.

    aws cloudformation update-stack-instances --stack-set-name my-stackset \
  --parameter-overrides ParameterKey=Subnets,ParameterValue=subnet-1baa3351\\,subnet-27b86940 \
  --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5j1lwo \
  --regions us-east-1

  2. Vérifiez que vos valeurs de paramètres ont été remplacées avec succès sur les piles en exécutant la commande describe-stack-set-operation pour afficher l’état et les résultats de votre opération de mise à jour. Pour --operation-id, utilisez l'ID d'opération qui a été renvoyé par la commande update-stack-instances.

    aws cloudformation describe-stack-set-operation --operation-id operation_ID