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.
Commencez avec StackSets à l’aide d’un exemple de modèle
Ce didacticiel vous aidera à vous familiariser avec StackSets à l’aide du AWS Management Console. Il vous guide tout au long de la création d’un StackSet à l’aide d’un exemple de modèle. Vous apprendrez à déployer des stacks dans plusieurs régions, à surveiller les opérations StackSet et à consulter les résultats.
Dans ce didacticiel, vous allez créer un StackSet qui active AWS Config dans votre Compte AWS au sein de la région USA Ouest (Oregon) (us-west-2) et USA Est (Virginie du Nord) (us-east-1). Avec StackSets, vous pouvez créer, mettre à jour ou supprimer des piles sur plusieurs comptes et régions en une seule opération, ce qui en fait une solution idéale pour gérer une infrastructure à grande échelle. Bien que ce didacticiel utilise un seul compte pour plus de simplicité, il démontre efficacement les capacités multi-régionales de StackSets.
Le modèle d’exemple est disponible dans le compartiment S3 suivant : https://s3.amazonaws.com/cloudformation-stackset-sample-templates-us-east-1/EnableAWSConfig.yml
Note
StackSets est gratuit, mais les ressources AWS que vous créez avec cet outil, comme AWS Config dans ce didacticiel, vous seront facturées. Pour plus d’informations, consultez Tarification d’AWS Config
Rubriques
Prérequis
Avant de commencer ce didacticiel, assurez-vous d’avoir rempli les conditions préalables suivantes :
-
Vous devez avoir configuré les rôles IAM requis pour les autorisations autogérées. Pour créer un StackSet et déployer des piles au sein d’un seul compte, vous devez disposer des rôles suivants dans votre compte :
-
AWSCloudFormationStackSetAdministrationRole -
AWSCloudFormationStackSetExecutionRole
Pour obtenir des instructions détaillées sur la configuration de ces rôles, consultez Accorder des autorisations autogérées.
-
Créez un StackSet avec un exemple de modèle depuis la console
Pour créer un StackSet qui permet AWS Config
-
Ouvrez la console CloudFormation
. -
Dans la barre de navigation en haut de l’écran, sélectionnez la Région AWS à partir de laquelle vous souhaitez gérer StackSet.
Vous pouvez choisir n’importe quelle région prenant en charge StackSets. La région que vous sélectionnez n’a aucune incidence sur les régions dans lesquelles vous pouvez effectuer le déploiement avec votre StackSet.
-
Choisissez StackSets dans le volet de navigation.
-
En haut de la page StackSets, choisissez Créer un StackSet.
-
Sous Autorisations, sélectionnez Autorisations en libre-service, puis choisissez les rôles IAM que vous avez créés dans les prérequis.
-
Pour le rôle d’administrateur IAM, choisissez AWSCloudFormationStackSetAdministrationRole.
-
Pour le nom du rôle d’exécution IAM, choisissez AWSCloudFormationStackSetExecutionRole.
-
-
Sous Prerequisite - Prepare template (Prérequis - Préparer le modèle), choisissez Use a sample template (Utiliser un exemple de modèle).
-
Sous Sélectionner un modèle d’exemple, choisissez le modèle Activer AWS Config. Ensuite, choisissez Suivant.
Ce modèle crée les ressources nécessaires à activer AWS Config dans votre compte, notamment un enregistreur de configuration et un canal de diffusion.
-
Sur la page Spécifier les détails du StackSet, entrez
my-awsconfig-stacksetdans le champ Nom du StackSet. -
Pour la description de StackSet, entrez
A StackSet that enables Config across multiple Regions. -
Sous Paramètres, configurez les paramètres AWS Config comme suit :
-
Pour Support de tous les types de ressources, conservez la valeur par défaut, true, pour enregistrer tous les types de ressources pris en charge.
-
Pour Inclure les types de ressources globaux, conservez la valeur par défaut, false, pour exclure les ressources globales telles que les rôles IAM.
-
Laissez la liste des types de ressources si tous ne sont pas pris en charge définie sur <All>.
-
Pour la région contenant la ressource de rôle liée au service Config, remplacez <DeployToAnyRegion> avec
us-west-2.Cela signifie que le rôle lié au service nommé
AWSServiceRoleForConfigne sera créé que si une pile est déployée dans la région USA Ouest (Oregon). Vous choisirez les régions de déploiement plus tôt lors de cette procédure. -
Pour la fréquence d’enregistrement de l’enregistreur de configuration, choisissez l’enregistrement QUOTIDIEN.
-
-
Choisissez Next (Suivant) pour continuer.
-
Sur la page Configurer les options StackSet, sélectionnez Ajouter une nouvelle balise et ajoutez une balise en spécifiant une paire clé-valeur :
-
Pour Clé, entrez
Stage. -
Pour le champ Value (Valeur), entrez
Test.
Les balises que vous appliquez aux StackSets sont appliquées aux ressources créées par vos piles.
-
-
Pour la configuration de l’exécution, choisissez Active pour activer la gestion optimisée des opérations par CloudFormation :
-
Les opérations non conflictuelles s’exécutent simultanément pour accélérer les temps de déploiement.
-
Les opérations en conflit sont automatiquement mises en file d’attente et traitées dans l’ordre dans lequel elles ont été demandées.
Pendant que les opérations sont en cours d’exécution ou en attente, CloudFormation met en file d’attente toutes les opérations entrantes, même si elles ne sont pas conflictuelles. Vous ne pouvez pas modifier les paramètres d’exécution pendant cette période.
-
-
Choisissez Suivant.
-
Sur la page Options de déploiement, sous Ajouter des piles à StackSet, sélectionnez Déployer de nouvelles piles.
-
Pour Accounts (Comptes), choisissez Deploy stacks in accounts (Déployer des piles dans des comptes).
-
Dans la zone de texte, entrez votre identifiant Compte AWS.
-
Pour Spécifier les régions, sélectionnez les régions suivantes dans cet ordre :
-
Région USA Ouest (Oregon) (
us-west-2) -
Région USA Est (Virginie du Nord) (
us-east-1)
Utilisez la flèche vers le haut à côté de la région USA Ouest (Oregon) pour la déplacer en haut de la liste si nécessaire. L’ordre des régions détermine leur ordre de déploiement.
-
-
Pour les options de déploiement, configurez les paramètres suivants :
-
Pour Maximum concurrent accounts (Nombre maximal de comptes en parallèle), conservez les valeurs par défaut Number (Nombre) et 1.
Pour les déploiements multi-comptes, ce paramètre signifie que CloudFormation déploie votre pile 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 maximum de zéro déploiement de pile peut échouer dans l’une des régions que vous avez spécifiées avant que CloudFormation n’arrête le déploiement dans la région actuelle et n’annule les déploiements dans les régions restantes.
-
Pour la simultanéité des régions, choisissez Séquentiel (par défaut).
Ce paramètre garantit que CloudFormation effectue les déploiements dans une région avant de passer à la suivante.
-
Pour le mode simultané, conservez la valeur par défaut de tolérance stricte aux défaillances.
Pour les déploiements multicomptes, cela réduit le niveau de simultanéité des comptes en cas de défaillance, tout en respectant la tolérance de défaillance +1.
-
-
Choisissez Suivant.
-
Sur la page Vérification, vérifiez vos choix. Pour apporter des modifications, sélectionnez Modifier dans la section correspondante.
-
Lorsque vous êtes prêt à créer votre StackSet, sélectionnez Soumettre.
Surveiller la création de StackSet
Une fois que vous avez sélectionné Soumettre, CloudFormation commence à créer votre StackSet et à déployer des piles dans les régions spécifiées de votre compte. La page détaillée du StackSet s’ouvre automatiquement, où vous pouvez surveiller la progression de l’opération.
Pour surveiller la création du StackSet
-
Sur la page de détails StackSet, l’onglet Opérations s’affiche par défaut et indique l’opération en cours.
-
Le statut de l’opération doit être initialement
RUNNING. CloudFormation crée des piles dans les régions que vous avez spécifiées en fonction des options de déploiement que vous avez configurées. -
Pour afficher plus de détails sur l’opération, sélectionnez l’ID d’opération dans la liste.
-
Sur la page Détails des opérations, vous pouvez afficher l’état des instances de piles créées dans chaque région.
-
Attendez que l’état de l’opération passe à
SUCCEEDED, ce qui indique que le StackSet et toutes ses instances de pile ont été créés avec succès.
Afficher les résultats StackSet
Une fois la création du StackSet terminée, vous pouvez afficher les instances de pile déployées et vérifier que AWS Config a été activé dans votre compte dans les régions spécifiées.
Pour afficher les résultats du StackSet
-
Sur la page de détails de StackSet, choisissez l’onglet Stack instances.
-
Vous devriez voir une liste des instances de stack créées dans votre compte dans les régions spécifiées. Chaque instance de pile doit avoir un état de
SUCCEEDED, indiquant qu’elle a été déployée avec succès. -
Pour vérifier que AWS Config est activé dans votre compte, vous pouvez consulter la console AWS Config dans chacune des régions déployées.
Mettre à jour votre StackSet
Après avoir créé votre StackSet, vous souhaiterez peut-être le mettre à jour pour modifier les valeurs des paramètres ou ajouter d’autres régions. Cette section explique comment mettre à jour le paramètre de fréquence d’enregistrement AWS Config.
Pour mettre à jour votre StackSet
-
Sur la page StackSets, sélectionnez votre
my-awsconfig-stackset. -
Une fois le StackSet sélectionné, sélectionnez Modifier les détails du StackSet dans le menu Actions.
-
Sur la page Choisir un modèle, pour Condition préalable – Préparer le modèle, sélectionnez Utiliser le modèle actuel.
-
Choisissez Suivant.
-
Sur la page Détails de StackSet, sous Paramètres, recherchez Fréquence d’enregistrement de l’enregistreur de configuration et remplacez QUOTIDIEN par CONTINU.
-
Choisissez Suivant.
-
Sur la page Configurer les options StackSet, laissez les paramètres tels quels et sélectionnez Suivant.
-
Sur la page Définir les options de déploiement, spécifiez votre identifiant de compte et les mêmes régions que celles que vous avez utilisées lors de la création du StackSet.
-
Pour les options de déploiement, conservez les mêmes paramètres qu’auparavant.
-
Choisissez Suivant.
-
Sur la page Vérification, vérifiez vos choix et choisissez Soumettre.
-
CloudFormation démarre la mise à jour de votre StackSet. Vous pouvez suivre la progression dans l’onglet Opérations de la page de détails de StackSet.
Ajout des piles à un StackSet
Vous pouvez ajouter d’autres piles à votre StackSet en le déployant dans des régions supplémentaires. Cette section explique comment ajouter des piles dans une nouvelle région.
Pour ajouter des piles à votre StackSet
-
Sur la page StackSets, sélectionnez votre
my-awsconfig-stackset. -
Une fois le StackSet sélectionné, sélectionnez Ajout de piles à StackSet dans le menu Actions.
-
Sur la page Options de déploiement, sous Ajouter des piles à StackSet, sélectionnez Déployer de nouvelles piles.
-
Pour les comptes, choisissez Déployer des piles dans les comptes et entrez votre identifiant de compte.
-
Pour Spécifier les régions, sélectionnez une nouvelle région, telle que Europe (Irlande) (
eu-west-1). -
Pour les options de déploiement, conservez les mêmes paramètres qu’auparavant.
-
Choisissez Suivant.
-
Sur la page Spécifier les remplacements, laissez les valeurs des propriétés telles qu’elles sont spécifiées et sélectionnez Suivant.
-
Sur la page Vérification, vérifiez vos choix et choisissez Submit (Soumettre).
-
CloudFormation commence à créer de nouvelles piles dans la région spécifiée. Vous pouvez suivre la progression dans l’onglet Opérations de la page de détails de StackSet.
Nettoyage
Pour éviter d’engager des frais pour des ressources AWS Config indésirables, vous devez procéder au nettoyage en supprimant les piles de votre StackSet, en supprimant le StackSet lui-même et en supprimant les rôles IAM que vous avez créés pour ce didacticiel. Toutes les ressources étant déployées au sein de votre compte, le nettoyage est simple.
Pour supprimer des piles de votre StackSet
-
Sur la page StackSets, sélectionnez votre
my-awsconfig-stackset. -
Une fois le StackSet sélectionné, sélectionnez Supprimer des piles de l’ensemble de piles dans le menu Actions.
-
Sur la page Options de déploiement, sous Comptes, sélectionnez Déployer les piles dans les comptes et entrez votre ID de compte.
-
Pour Spécifier les régions, sélectionnez toutes les régions dans lesquelles vous avez déployé des piles.
-
Pour les options de déploiement, conservez les paramètres par défaut.
-
Assurez-vous que l’option Conserver les piles n’est pas activée, afin que les piles et leurs ressources soient supprimées.
-
Choisissez Suivant.
-
Sur la page Vérification, vérifiez vos choix et choisissez Submit (Soumettre).
-
CloudFormation commence à supprimer les piles de votre StackSet. Vous pouvez suivre la progression dans l’onglet Opérations de la page de détails de StackSet.
Pour supprimer votre StackSet
-
Une fois que toutes les piles ont été supprimées, sur la page StackSets, sélectionnez votre
my-awsconfig-stackset. -
Une fois le StackSet sélectionné, sélectionnez Supprimer le StackSet dans le menu Actions.
-
Lorsque vous êtes invité à confirmer, sélectionnez Supprimer.
Suppression des rôles du service IAM
Comme vous n’avez déployé que sur votre compte, vous n’avez qu’à supprimer les rôles IAM de ce seul compte, ce qui simplifie considérablement le nettoyage par rapport aux déploiements multi-comptes.
-
Ouvrez la console IAM
. -
Dans le volet de navigation, choisissez Rôles.
-
Dans la zone de recherche, saisissez
AWSCloudFormationStackSetpour trouver les rôles que vous avez créés pour ce didacticiel. -
Cochez la case en regard de AWSCloudFormationStackSetAdministrationRole.
-
En haut de la page, choisissez Supprimer.
-
Dans le champ de confirmation, entrez
delete, puis choisissez Supprimer. -
Répétez le même processus pour supprimer le AWSCloudFormationStackSetExecutionRole.
Après avoir supprimé le StackSet, un compartiment Amazon S3 restera dans chaque Région AWS en raison de l’attribut DeletionPolicy de la ressource AWS::S3::Bucket. Cela préserve vos données d’historique AWS Config. Si vous n’avez plus besoin de ces données, vous pouvez supprimer le compartiment manuellement en toute sécurité. Avant de pouvoir supprimer un compartiment, vous devez d’abord supprimer son contenu. Vider un compartiment supprime tous les objets qu’il contient.
Pour vider et supprimer les compartiments Amazon S3
-
Ouvrez la console Amazon S3
. -
Dans le volet de navigation situé sur le côté gauche de la console, choisissez Compartiments.
-
Dans la liste des compartiments, vous verrez des compartiments créés pour ce StackSet dans chaque région où vous l’avez déployé. Sélectionnez l’option en regard du nom du compartiment créé pour ce StackSet, puis choisissez Vider.
-
Sur la page Vider le compartiment, confirmez que vous souhaitez vider le compartiment en saisissant
permanently deletedans le champ de texte, puis choisissez Vider. -
Surveillez la progression du processus de vidage du compartiment sur la page Vider le compartiment : état.
-
Pour revenir à votre liste de compartiments, choisissez Quitter.
-
Sélectionnez l’option en regard du nom du compartiment, puis choisissez Supprimer.
-
Lorsque vous êtes invité à confirmer, saisissez le nom du compartiment, puis sélectionnez Supprimer le compartiment.
-
Surveillez la progression du processus de suppression des compartiments à partir de la liste Compartiments. Lorsque Amazon S3 a terminé la suppression du compartiment, il le supprime de la liste.
-
Répétez ce processus pour chaque compartiment créé par le StackSet dans les différentes régions.
Étapes suivantes
Félicitations ! Vous avez créé avec succès un StackSet à l’aide d’un modèle d’exemple, déployé des piles dans plusieurs régions de votre compte, mis à jour le StackSet, ajouté d’autres piles et nettoyé vos ressources. En vous concentrant sur le déploiement d’un seul compte, vous avez simplifié le processus de nettoyage tout en continuant à découvrir les fonctionnalités multirégionales essentielles de StackSets.
Pour en savoir plus sur les StackSets, explorez les rubriques suivantes :
-
Remplacer les valeurs des paramètres sur les piles de votre CloudFormation StackSet : découvrez comment remplacer les valeurs des paramètres pour des comptes et des régions spécifiques.
-
Créez CloudFormation StackSets avec des autorisations gérées par le service : découvrez comment créer des StackSets pour les déploiements multi-comptes avec AWS Organizations.