Mettre à jour AWS CloudFormation StackSets - 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.

Mettre à jour AWS CloudFormation StackSets

Vous pouvez effectuer la mise à jour à l' StackSet aide de la CloudFormation console ou du AWS CLI.

Pour ajouter et supprimer des comptes et des régions dans un StackSet, consultez Ajoutez des piles à StackSets etSupprimer des piles de StackSets. Pour remplacer les valeurs des paramètres d'une pile, consultezRemplacer les paramètres sur les piles.

Mettez à jour votre StackSet (console)

Pour mettre à jour un StackSet
  1. Connectez-vous à la AWS CloudFormation console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/cloudformation.

  2. Dans la barre de navigation en haut de l'écran, choisissez le StackSet dans lequel Région AWS vous l'avez créé.

  3. Dans le volet de navigation, choisissez StackSets.

  4. Sur la StackSetspage, sélectionnez celui que StackSet vous souhaitez mettre à jour.

  5. Lorsque cette option est StackSet sélectionnée, choisissez Modifier StackSet les détails dans le menu Actions.

  6. Sur la page Choisissez un modèle, mettez à jour la section Autorisations selon vos besoins ou passez à l'étape suivante.

  7. Dans Prérequis - Préparer le modèle, choisissez Utiliser le modèle actuel pour utiliser le modèle actuel ou Remplacer le modèle actuel pour spécifier une URL S3 vers un autre modèle ou télécharger un nouveau modèle.

  8. Choisissez Suivant.

  9. Sur la page Spécifier StackSet les détails, pour la StackSet description, mettez à jour la description StackSet selon les besoins.

  10. Pour Paramètres, mettez à jour les valeurs des paramètres selon vos besoins.

  11. Choisissez Suivant.

  12. Sur la page des StackSet options de configuration, pour les balises, modifiez les balises selon vos besoins. Vous pouvez ajouter, mettre à jour ou supprimer des balises. Pour plus d'informations sur la manière dont les balises sont utilisées AWS, consultez la section Organisation et suivi des coûts à l'aide des balises de répartition des AWS coûts dans le Guide de AWS Billing and Cost Management l'utilisateur.

  13. Pour la configuration d'exécution, vous pouvez mettre à jour la configuration d'exécution selon vos besoins.

    Note

    N'oubliez pas que vous ne pouvez pas modifier les paramètres d'exécution lorsque des opérations sont en cours ou en file d'attente.

  14. Si votre modèle contient des ressources IAM, dans Fonctionnalités, sélectionnez Je reconnais que ce modèle peut créer des ressources IAM pour spécifier que vous souhaitez utiliser des ressources IAM dans le modèle. Pour de plus amples informations, veuillez consulter Confirmation des ressources IAM dans les modèles CloudFormation.

  15. Choisissez Suivant.

  16. Sur la page Définir les options de déploiement, indiquez les comptes et les régions pour la mise à jour.

    CloudFormation déploiera les mises à jour de la pile dans les comptes spécifiés au sein de 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épassent pas la tolérance d'échec spécifiée.

    1. [Autorisations autogérées] Pour les comptes et les emplacements de déploiement, choisissez Déployer des piles dans les comptes. Collez le compte cible IDs que vous avez utilisé pour créer le vôtre StackSet dans la zone de texte, en séparant les nombres par des virgules.

      [Autorisations gérées par le service] Effectuez l'une des opérations suivantes :

      • Choisissez Déployer vers les unités organisationnelles (OUs). Entrez la cible OUs que vous avez utilisée pour créer votre StackSet.

      • Choisissez Déployer sur les comptes. Collez l'unité d'organisation IDs ou le compte cible IDs que vous avez utilisé pour créer votre StackSet.

    2. Pour Spécifier les régions, spécifiez l'ordre dans lequel vous souhaitez CloudFormation déployer vos mises à jour.

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

      • Pour le 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 le mode de traitement des régions : séquentiel (une région à la fois) ou 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 défaillances : réduit le niveau de simultanéité des comptes en cas de défaillance, tout en respectant la tolérance aux défaillances +1.

        • Tolérance souple aux défaillances : maintient le niveau de simultanéité que vous avez spécifié (la valeur du nombre maximal de comptes simultanés) indépendamment des défaillances.

    4. Choisissez Next (Suivant) pour continuer.

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

  18. Lorsque vous êtes prêt à continuer, choisissez Soumettre.

    CloudFormation commence à appliquer vos mises à jour à votre StackSet et affiche l'onglet Opérations de la page de StackSet détails. Vous pouvez afficher la progression et le statut des opérations de mise à jour dans l'onglet Operations.

Mettez à jour votre StackSet (AWS CLI)

Note

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

  1. Pour mettre à jour un StackSet

    Utilisez la update-stack-setcommande pour apporter des modifications à votre StackSet.

    Dans les exemples suivants, nous mettons à jour l'--parametersoption StackSet en utilisant. Plus précisément, 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. Comme nous utilisons toujours le modèle actuel, nous ajoutons --use-previous-template cette option.

    Définissez le traitement simultané des comptes et les autres préférences de déploiement à l'aide de --operation-preferences cette option. Ces exemples utilisent des paramètres basés sur le décompte. Notez que cela ne MaxConcurrentCount doit pas dépasser FailureToleranceCount +1. Pour les paramètres basés sur des pourcentages, utilisez FailureTolerancePercentage ou à la place. MaxConcurrentPercentage

    [Autorisations autogérées] Pour --accounts cette option, indiquez le compte que IDs vous souhaitez cibler par votre mise à jour.

    aws cloudformation update-stack-set --stack-set-name my-stackset \ --use-previous-template \ --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \ --accounts account_ID_1 account_ID_2 \ --regions us-west-2 us-east-1 \ --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

    [Autorisations gérées par le service] Pour --deployment-targets cette option, indiquez l'ID racine de l'organisation ou l'unité organisationnelle (UO) que IDs vous souhaitez cibler par votre mise à jour.

    aws cloudformation update-stack-set --stack-set-name my-stackset \ --use-previous-template \ --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \ --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5j1lwo,ou-rcuk-slr5lh0a \ --regions us-west-2 us-east-1 \ --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

    Pour plus d’informations, consultez UpdateStackSet dans la Référence d’API AWS CloudFormation .

  2. Vérifiez que vous avez bien StackSet été mis à jour en exécutant la describe-stack-set-operation commande 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-set.

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