Remplacez les valeurs des paramètres à l'aide du ou AWS Management ConsoleAWS CLI

Dans certains cas, il se peut que vous voulez empiler des instances dans certaines régions ou certains comptes afin d'avoir différentes valeurs de propriété que celles définies dans l'ensemble de piles 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. AWS CloudFormation vous permet désormais de remplacer des valeurs de paramètres par compte et par région dans les instances de piles pour ces situations. Vous pouvez substituer les valeurs des paramètres de modèle lorsque vous créez les instances de piles pour la première fois. Vous pouvez également substituer les valeurs des paramètres pour les instances de piles existantes. Vous pouvez uniquement définir des paramètres que vous avez précédemment remplacés dans les instances de pile par des valeurs spécifiées dans l'ensemble de piles.

Le remplacement des valeurs de paramètres s'applique aux instances de piles des comptes et régions que vous avez sélectionné. Lors de mises à jour d'un ensemble de piles, les valeurs de paramètres remplacées pour une instance de piles ne sont pas mises à jour, mais maintiennent leur valeur remplacée.

Vous ne pouvez remplacer que les valeurs spécifiées dans l'ensemble de piles. Pour ajouter ou supprimer un paramètre lui-même, vous devez mettre à jour le modèle d'ensemble de piles. Si vous ajoutez un paramètre à un modèle d'ensemble de piles, vous devez d'abord mettre à jour toutes les instances de piles avec le nouveau paramètre et la valeur spécifiés dans l'ensemble de piles avant de pouvoir remplacer cette valeur de paramètre dans une instance de piles. Une fois toutes les instances de piles mises à jour avec le nouveau paramètre, vous pouvez remplacer la valeur du paramètre dans les instances de piles individuelles à votre guise.

Pour savoir comment remplacer les valeurs des paramètres d'ensembles de piles lorsque vous créez des instances de piles, reportez-vous à la section Ajoutez des instances de pile à l'aide du AWS Management Console ou AWS CLI.

Remplacez les paramètres des instances de pile à l'aide du AWS Management Console

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

2. Dans le volet de navigation, choisissez StackSets. Sur la StackSets page, sélectionnez l'ensemble de piles dans lequel vous avez crééCréez un ensemble de piles à l'aide du AWS Management Console ou AWS CLI. Dans cet exemple, nous avons créé un ensemble de piles nommé my-awsconfig-stackset.

3. Une fois l'ensemble de piles sélectionné, choisissez Remplacer StackSet les paramètres dans le menu Actions.

4. Sur la page Set deployment options (Définir les options de déploiement), indiquez les comptes et régions pour les instances de piles dont vous souhaitez remplacer les paramètres.

   AWS CloudFormation déploiera des piles dans les comptes spécifiés au sein de la première région, puis passera à la suivante, et ainsi de suite, à condition que les échecs de déploiement d'une région ne dépassent pas la tolérance d'échec spécifiée.

   1. [Autorisations autogérées] Pour les Cibles de déploiement, choisissez Déployer les piles dans les comptes. Collez une partie ou la totalité du compte cible IDs que vous avez utilisé pour créer votre stack setCréez un ensemble de piles à l'aide du AWS Management Console ou AWS CLI.

      [Autorisations gérées par le service] Pour les Cibles de déploiement, choisissez les comptes de votre organisation vers lesquels déployer.

      • Choisissez Déployer vers les unités organisationnelles (OUs). Sélectionnez une ou plusieurs cibles OUs que vous avez utilisées pour créer votre ensemble de pilesCréez un ensemble de piles à l'aide du AWS Management Console ou AWS CLI. Les valeurs des paramètres remplacées s'appliquent uniquement aux comptes actuellement enregistrés dans la cible OUs et à leur enfant. OUs Les comptes ajoutés à la cible OUs et à son enfant OUs à l'avenir utiliseront les valeurs par défaut définies dans la pile et non les valeurs remplacées.

      • Choisissez Déployer sur les comptes. Collez une partie ou la totalité de l'unité d'IDsorganisation ou du compte cible IDs que vous avez utilisé pour créer votre ensemble de pilesCréez un ensemble de piles à l'aide du AWS Management Console ou AWS CLI.

   2. Pour Régions de déploiement, ajoutez une ou plusieurs des régions dans lesquelles vous avez déployé des instances de piles pour cet ensemble de piles.

      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 Deployment options (Options de déploiement) :

      • Pour Maximum concurrent accounts (Nombre maximal de comptes en parallèle), conservez les valeurs par défaut Number (Nombre) et 1.

        Cela signifie que votre stack est AWS CloudFormation déployé dans un seul compte à la fois.

      • Pour Failure tolerance (Tolérance aux pannes), conservez les valeurs par défaut Number (Nombre) et 0.

        Cela signifie qu'un déploiement de pile au maximum peut échouer dans l'une des régions que vous avez spécifiées avant d' AWS CloudFormation arrêter le déploiement dans la région actuelle et d'annuler le déploiement dans les régions restantes.

      Choisissez Suivant.

5. Sur la page Spécifier les remplacements, vérifiez le paramètre Fréquence, puis choisissez Remplacer StackSet la valeur dans le menu Modifier la valeur de remplacement.

6. Dans Remplacer les valeurs des StackSet paramètres, sélectionnez 6 heures pour le paramètre Fréquence, puis sélectionnez Enregistrer les modifications. Vous indiquez à AWS CloudFormation de remplacer la valeur du paramètre Frequency (Fréquence) et d'utiliser 6hours (6 heures) pour toutes les instances de piles des comptes spécifiés dans les régions spécifiées. Choisissez Suivant.

   Note

   Pour rétablir les paramètres remplacés en utilisant la valeur spécifiée dans le jeu de piles, vérifiez tous les paramètres et choisissez Définir sur la valeur dans le menu Modifier la StackSet valeur de remplacement. Cela supprime toutes les valeurs remplacées une fois les instances de piles mise à jour.

7. Sur la page Vérification, vérifiez vos choix. Notez que le paramètre Frequency (Fréquence) affiche une valeur dans la colonne Override value (Valeur de remplacement), ce qui indique que sa valeur a été remplacée au niveau des piles.

   Avant de pouvoir remplacer les paramètres de ces instances de pile, vous devez cocher la case dans la zone Fonctionnalités pour reconnaître que certaines des ressources que vous créez avec le stack set peuvent nécessiter de nouvelles IAM ressources et autorisations. Pour plus d'informations sur les autorisations potentiellement requises, consultezConfirmation des ressources IAM dans les modèles CloudFormation. Lorsque vous êtes prêt, choisissez Submit (Soumettre).

8. AWS CloudFormation commence à mettre à jour vos instances de stack. Vous pouvez afficher la progression et le statut des instances de piles dans la page de détails de l'ensemble de piles qui s'ouvre lorsque vous choisissez Submit (Soumettre).

Remplacez les paramètres des instances de pile à l'aide du AWS CLI

Lorsque vous agissez en tant qu'administrateur délégué, vous devez définir le --call-as paramètre à DELEGATED_ADMIN chaque fois que vous exécutez une StackSets commande.

--call-as DELEGATED_ADMIN

Exécutez la update-stack-instances AWS CLI commande en spécifiant--parameter-overrides. Pour plus d'informations sur la spécification--parameter-overrides, reportez-vous Parameterà la section AWS CloudFormation API Référence et update-stack-instancesà la Référence des AWS CLI commandes.

Dans l'exemple de commande présenté ici, nous changeons la fréquence de diffusion des instantanés par défaut pour la configuration du canal de diffusion de TwentyFour_Hours à Twelve_Hours pour les instances de pile spécifiées.

1. Exécutez la commande suivante. Pour--stack-set-name, spécifiez le nom du stack set my-awsconfig-stackset.

   Spécifiez la tolérance aux pannes et le nombre maximal de comptes en parallèle en définissant FailureToleranceCount sur 0 et MaxConcurrentCount sur 1 dans le paramètre --operation-preferences, comme indiqué dans l'exemple suivant. Pour appliquer des pourcentages au lieu de nombres, utilisez FailureTolerancePercentage ou MaxConcurrentPercentage. Pour cette procédure pas à pas, nous utilisons le nombre, pas le pourcentage.

   Note

   La valeur de MaxConcurrentCount dépend de la valeur de FailureToleranceCount. FailureToleranceCount est au maximum supérieur à MaxConcurrentCount.

   [Autorisations autogérées] Indiquez le compte IDs pour lequel vous souhaitez remplacer les valeurs des paramètres sur les instances de pile.

   aws cloudformation update-stack-instances --stack-set-name my-awsconfig-stackset --parameter-overrides ParameterKey=MaximumExecutionFrequency,ParameterValue=TwentyFour_Hours\\,Twelve_Hours --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1 --accounts '["012345678901"]' --regions '["eu-west-1", "us-west-2"]'

   [Autorisations gérées par le service] Fournissez l'ID racine de l'organisation, l'unité IDs d'organisation ou le AWS Organizations compte IDs pour lequel vous souhaitez remplacer les paramètres sur les instances de pile. Dans cet exemple, nous remplaçons les valeurs des paramètres pour les instances de pile de tous les comptes de l'unité d'organisation par le ou-rcuk-1x5j1lwo IDENTIFIANT.

   Les valeurs des paramètres remplacées s'appliquent uniquement aux comptes qui se trouvent actuellement dans l'unité d'organisation cible et à son enfant. OUs Les comptes ajoutés à l'unité d'organisation cible et OUs à son enfant à l'avenir utiliseront les valeurs par défaut du stack set et non les valeurs remplacées.

   aws cloudformation update-stack-instances --stack-set-name my-awsconfig-stackset --parameter-overrides ParameterKey=MaximumExecutionFrequency,ParameterValue=TwentyFour_Hours\\,Twelve_Hours --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1 --deployment-targets OrganizationalUnitIds='["ou-rcuk-1x5j1lwo"]' --regions '["eu-west-1", "us-west-2"]'

2. Vérifiez que vos valeurs de paramètres ont été remplacées avec succès sur les instances de pile 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