Concepts StackSets

Pour créer un StackSet, vous devez spécifier un modèle CloudFormation à utiliser pour créer les piles et les comptes cibles dans lesquels créer les piles, puis identifier les Régions AWS dans lesquelles les piles doivent être déployées dans les comptes cibles. Un StackSet assure le déploiement cohérent des mêmes ressources de pile, avec les mêmes paramètres, dans tous les comptes de destination spécifiés et dans les régions que vous choisissez.

Lorsque vous mettez à jour un StackSet, vous envoyez les modifications dans les piles du StackSet. Vous pouvez mettre à jour un StackSet de l’une des manières suivantes. Les mises à jour du modèle affectent toujours toutes les piles. Vous ne pouvez pas mettre à jour le modèle de façon sélective pour certaines piles du StackSet et pas pour les autres.

Lorsque vous supprimez des piles, vous supprimez chaque pile et toutes les ressources qui lui sont associées des comptes de destination dans les régions que vous spécifiez. Pour supprimer des piles, vous pouvez procéder de différentes façons.

Vous ne pouvez supprimer votre StackSet que s’il ne contient aucune instance de pile.

Ce paramètre, disponible dans les flux de travail de création, de mise à jour et de suppression, permet de spécifier le nombre ou le pourcentage maximal de comptes cibles dans lequel une opération est effectuée simultanément. Un nombre ou pourcentage faible signifie qu'une opération est effectuée dans peu de comptes de destination à la fois. Les opérations sont effectuées dans une seule région à la fois, dans l'ordre spécifié dans la zone Deployment order (Ordre de déploiement). Par exemple, si vous déployez des piles dans 10 comptes cibles dans deux régions et que vous définissez Maximum concurrent accounts (Nombre maximal de comptes en parallèle) sur 50 et By percentage (Par pourcentage), le logiciel déploie les piles dans cinq comptes dans la première région, puis dans les cinq comptes suivants dans la première région, avant de passer à la région suivante et de lancer le déploiement dans les cinq premiers comptes cibles.

Lorsque vous choisissez By percentage (Par pourcentage), si le pourcentage spécifié ne correspond pas à un nombre entier de comptes spécifiés, CloudFormation arrondit la valeur. Par exemple, si vous déployez des piles dans 10 comptes de destination et que vous définissez Maximum concurrent accounts (Nombre maximal de comptes en parallèle) sur 25 et By percentage (Par pourcentage), CloudFormation arrondit le déploiement simultané de 2,5 piles (qui serait impossible) à 2 piles.

Notez que ce paramètre vous permet de spécifier la valeur maximale pour les opérations. Pour les déploiements importants, dans certaines circonstances, le nombre réel de comptes traités simultanément peut être inférieur en raison de la limitation de service.

Le nombre maximal de comptes simultanés peut dépendre de la valeur de la tolérance aux pannes en fonction de votre mode de simultanéité. Si votre mode de simultanéité est défini sur Tolérance stricte aux pannes, le nombre maximal de comptes simultanés peut être supérieur d’au plus un au paramètre de tolérance aux pannes.

Ce paramètre, disponible dans les workflows de création, de mise à jour et de suppression, vous permet de choisir le comportement du niveau de concurrence pendant les opérations StackSet. Pour de plus amples informations, consultez Choix du mode simultané pour les StackSets CloudFormation.

Ce paramètre, disponible dans les flux de travail de création, de mise à jour et de suppression, permet de spécifier le nombre ou le pourcentage maximal d'échecs d'opérations de pile par région, au-delà duquel le service CloudFormation arrête une opération automatiquement. Si le nombre ou le pourcentage est faible, l'opération est effectuée sur peu de piles, mais vous pouvez commencer plus rapidement à résoudre les problèmes d'échec des opérations. Par exemple, si vous mettez à jour 10 piles dans 10 comptes de destination dans trois régions, et que vous définissez Failure tolerance (Tolérance aux pannes) sur 20 et By percentage (Par pourcentage), cela signifie que l'opération peut se poursuivre si le nombre d'échecs de mises à jour de pile ne dépasse pas deux échecs. Si une troisième pile échoue dans la même région, le service CloudFormation arrête l'opération. Si une pile n'a pas pu être mise à jour dans la première région, l'opération de mise à jour continue dans cette région, puis passe à la région suivante. Si deux piles ne peuvent pas être mises à jour dans la deuxième région, la tolérance aux pannes de 20 % est atteinte. Si la mise à jour d'une troisième pile échoue dans la région, le service CloudFormation arrête l'opération de mise à jour et ne passe pas aux régions suivantes.

Lorsque vous choisissez By percentage (Par pourcentage), si le pourcentage spécifié ne correspond pas à un nombre entier de piles dans chaque région, le service CloudFormation arrondit la valeur au nombre entier inférieur. Par exemple, si vous déployez des piles dans 10 comptes de destination dans trois régions et que vous définissez Failure tolerance (Tolérance aux pannes) sur 25 et By percentage (Par pourcentage), le service CloudFormation arrondit la tolérance aux pannes de 2,5 piles (qui serait impossible) à 2 piles par région.

Ce paramètre, disponible dans les flux de travail de suppression de pile, vous permet de laisser les piles et leurs ressources s’exécuter même après avoir été supprimées du StackSet. Lorsque vous conservez les piles, CloudFormation laisse intactes les piles placées dans des comptes et régions individuels. Les piles sont dissociées du StackSet, mais enregistrent la pile et ses ressources. Une fois que l'opération de suppression des piles est terminée, vous gérez les piles conservées dans CloudFormation, dans le compte cible (et non le compte d'administrateur) qui a créé les piles.

Ce paramètre, disponible dans Create, update, and delete workflows (Créer, mettre à jour et supprimer des flux de travail), vous permet de choisir le mode de déploiement de StackSets dans les régions.

Sequential (Séquentiel) : déployez l'opération StackSets dans une région à la fois, tel que spécifié par la zone Deployment order (Ordre de déploiement) régionale, tant que les échecs de déploiement d'une région ne dépassent pas une tolérance d'échec spécifiée. Le déploiement séquentiel est la sélection par défaut.

Parallèle : déployez simultanément les opérations StackSets dans toutes les régions spécifiées tant que les défaillances de déploiement d'une région ne dépassent pas une tolérance aux pannes spécifiée.

L'opération est actuellement en cours.

L'opération s'est terminée sans dépasser la tolérance aux pannes autorisée pour l'opération.

Le nombre de piles sur lesquelles l'opération a échoué a dépassé le seuil de tolérance aux pannes défini par l'utilisateur. La valeur de tolérance aux pannes que vous avez définie pour une opération est appliquée pour chaque région lors de la création et de la mise à jour des piles. Si le nombre de piles en échec dans une région dépasse la valeur de tolérance aux pannes, l'état de l'opération dans la région passe à FAILED. L'état de l'opération globale est également défini sur FAILED. Le service CloudFormation annule l'opération dans les régions restantes.

[Service-managed permissions] Pour les déploiements automatiques nécessitant une séquence d'opérations, l'opération est mise en file d'attente afin d'être exécutée. Par exemple :

L'opération est en cours d'arrêt, à la demande de l'utilisateur.

L'opération s'est arrêtée à la demande de l'utilisateur.

La pile est à jour avec le StackSet.

La pile n’est pas à jour avec le StackSet pour l’une des raisons suivantes.

Une opération DeleteStackInstances a échoué et a laissé la pile dans un état instable. Les piles affichant cet état sont exclues des opérations UpdateStackSet suivantes. Vous devrez peut-être effectuer une opération DeleteStackInstances, avec RetainStacks défini sur true, pour supprimer l’instance de pile, puis supprimer la pile manuellement.

L'opération dans le compte et la région spécifiés a été annulée. Cela se produit, soit car un utilisateur a arrêté l’opération du StackSet, soit parce que la tolérance aux échecs des opérations de StackSet a été dépassée.

Échec de l'opération dans le compte et la région spécifiés. Si l’opération StackSet échoue dans suffisamment de comptes au sein d’une région, la tolérance d’échec de l’opération StackSet dans son ensemble peut être dépassée.

L’importation de l’instance de pile dans le compte et la région spécifiés a échoué et a laissé la pile dans un état instable. Une fois les problèmes à l’origine de l’échec résolus, l’opération d’importation peut être réessayée. Si un nombre suffisant d’opérations StackSet échouent dans un nombre suffisant de comptes au sein d’une région, la tolérance aux pannes pour l’opération StackSet dans son ensemble pourrait être dépassée.

L'opération dans le compte et la région spécifiés n'a pas encore démarré.

L'opération dans le compte et la région spécifiés est en cours.

L'opération dans le compte et la région spécifiés a été ignorée, car le compte était suspendu au moment de l'opération.

L'opération dans le compte et la région spécifiés s'est déroulée avec succès.