Importation de pile gérée par le service pour CloudFormation StackSets - AWS CloudFormation
Importer une pile gérée par le service dans un nouveau StackSet (console)Créer et importer une pile gérée par le service dans un StackSet existant (console)Importer une pile gérée par le service dans un StackSet existant (console)Importer une pile gérée par le service dans un StackSet (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.

Importation de pile gérée par le service pour CloudFormation StackSets

L’opération d’importation de pile CloudFormation permet d’importer des piles existantes dans des StackSets nouveaux ou existants, de sorte que vous pouvez migrer des piles existantes vers un StackSet en une seule opération. StackSets étend les fonctionnalités des piles en vous permettant de créer, de mettre à jour ou de supprimer des piles dans plusieurs comptes et régions en une seule opération.

Considérations relatives aux importations de piles gérées par le service

  • L'opération d'importation de pile nécessite un compte de gestion ou un compte administrateur délégué dans lequel vous pouvez gérer les AWS Organizations associés tels que l'activation de l'accès de confiance avec StackSets.

  • Les comptes cibles doivent être membres des AWS Organizations gérées par le compte de gestion ou le compte administrateur délégué.

  • La pile cible quitte l'une des unités d'organisation cibles.

  • Le compte cible doit être membre de AWS Organizations.

  • L'accès à AWS Organizations doit se trouver à l'état ACTIVATED pour les organisations.

  • Les piles importées doivent être présentes dans l'un des comptes membres, et non dans le compte de gestion.

Importer une pile gérée par le service dans un nouveau StackSet (console)

Importation d’une pile dans un nouveau StackSet à l’aide de la AWS Management Console

Pour importer une nouvelle pile dans un StackSet, identifiez une pile qui contient la ressource que vous voulez importer.

  1. Connectez-vous à la AWS Management Console et ouvrez la console CloudFormation à l’adresse https://console.aws.amazon.com/cloudformation.

  2. Choisissez StackSets dans le volet de navigation.

  3. En haut de la page StackSets, choisissez Create StackSet (Créer un ensemble de piles).

  4. Sur la page Choisir un modèle, procédez comme suit :

    1. Pour Modèle d’autorisation StackSet, sélectionnez Autorisations gérées par le service.

    2. Pour Prérequis – Préparer le modèle, sélectionnez Le modèle est prêt, puis choisissez votre modèle à l’aide de l’une des options suivantes :

      • Pour URL Amazon S3, saisissez votre URL Amazon S3 dans le champ URL Amazon S3.

      • Pour Charger un fichier modèle, sélectionnez un modèle CloudFormation sur votre ordinateur local.

    Acceptez vos paramètres et choisissez Next (Suivant).

  5. Sur la page Spécifier les détails de StackSet, procédez comme suit :

    1. Saisissez un nom de StackSet dans la zone Nom du StackSet.

    2. (Facultatif) Saisissez une description dans la section Description du StackSet.

    Sur la page Configurer les options du StackSet, examinez vos choix et choisissez Suivant.

  6. Sur la page Définir les options de déploiement, procédez comme suit :

    1. Pour Ajouter des piles au jeu de piles, sélectionnez Importer des piles dans le jeu de piles.

    2. Pour Stacks to import (Piles à importer), choisissez la méthode d'importation de votre pile.

      1. Pour Stack ID (ID de la pile), saisissez l'ID de votre pile.

      2. Pour URL de la pile, saisissez l’URL Amazon S3.

  7. Sous Associer des unités organisationnelles, procédez comme suit :

    1. Sélectionnez Associer à l’organisation pour utiliser l’unité organisationnelle racine.

    2. Sélectionnez Associer à des unités organisationnelles (UO) pour saisir les ID des unités organisationnelles parentes pour les piles à importer. Par exemple, si Stack 1 et Stack 2 sont sous OU1, et si Stack 3 est sous OU2, saisissez OU1 et OU2.

    Acceptez vos paramètres et choisissez Next (Suivant).

  8. Sur la page Révision, passez en revue vos paramètres et choisissez Submit (Soumettre).

Créer et importer une pile gérée par le service dans un StackSet existant (console)

Pour importer une pile existante dans un nouvel StackSet, identifiez une pile qui contient la ressource que vous voulez importer.

Pour créer un StackSet et importer une pile

  1. Connectez-vous à la AWS Management Console et ouvrez la console CloudFormation à l’adresse https://console.aws.amazon.com/cloudformation.

  2. Choisissez StackSets dans le volet de navigation.

  3. En haut de la page StackSets, choisissez Create StackSet (Créer un ensemble de piles).

  4. Sur la page Choisir un modèle, procédez comme suit :

    1. Pour Modèle d’autorisation StackSet, sélectionnez Autorisations gérées par le service.

    2. Pour Prérequis – Préparer le modèle, sélectionnez Le modèle est prêt, puis choisissez votre modèle à l’aide de l’une des options suivantes :

      • Pour URL Amazon S3, saisissez votre URL Amazon S3 dans le champ URL Amazon S3.

      • Pour Charger un fichier modèle, sélectionnez un modèle CloudFormation sur votre ordinateur local.

    Acceptez vos paramètres et choisissez Next (Suivant).

  5. Sur la page Spécifier les détails de StackSet, procédez comme suit :

    1. Saisissez un nom de StackSet dans la zone Nom du StackSet.

    2. (Facultatif) Saisissez une description dans la section Description du StackSet.

    Sur la page Configurer les options du StackSet, examinez vos choix et choisissez Suivant.

  6. Sur la page Définir les options de déploiement, procédez comme suit :

    1. Pour Add stacks to stack set (Ajouter des piles à un ensemble de piles), sélectionnez Deploy new stacks (Déployer de nouvelles piles).

  7. Dans la section Associer des unités organisationnelles, procédez comme suit :

    1. Sélectionnez Associer à l’organisation pour utiliser l’unité organisationnelle racine.

    2. Sélectionnez Associer à des unités organisationnelles (UO) pour saisir les ID des unités organisationnelles parentes pour les piles à importer. Par exemple, si Stack 1 et Stack 2 sont sous OU1, et si Stack 3 est sous OU2, saisissez OU1 et OU2.

  8. Pour Specify regions (Spécifier des régions) et Deployment options (Options de déploiement), vérifiez vos choix.

    Acceptez vos paramètres et choisissez Next (Suivant).

  9. Sur la page Révision, passez en revue vos paramètres et choisissez Submit (Soumettre).

Importer une pile gérée par le service dans un StackSet existant (console)

Sélectionnez votre StackSet et identifiez la pile que vous voulez importer.

Pour importer une pile dans un StackSet existant

  1. Connectez-vous à la AWS Management Console et ouvrez la console CloudFormation à l’adresse https://console.aws.amazon.com/cloudformation.

  2. Choisissez StackSets dans le volet de navigation.

  3. Sélectionnez le StackSet dans lequel vous voulez importer une pile, puis sélectionnez Ajouter des piles au StackSet dans le menu déroulant Actions.

  4. Sur la page Définir les options de déploiement, procédez comme suit :

    1. Pour Ajouter des piles au jeu de piles, sélectionnez Importer des piles dans le jeu de piles.

    2. Sous Piles à importer, procédez comme suit

      1. Pour Stack ID (ID de la pile), saisissez l'ID de votre pile.

      2. Pour URL de la pile, saisissez l’URL Amazon S3.

    3. Sous Associer des unités organisationnelles, procédez comme suit :

      1. Sélectionnez Associer à l’organisation pour utiliser l’unité organisationnelle racine.

      2. Sélectionnez Associer à des unités organisationnelles (UO) pour saisir les ID des unités organisationnelles parentes pour les piles à importer. Par exemple, si Stack 1 et Stack 2 sont sous OU1, et si Stack 3 est sous OU2, saisissez OU1 et OU2.

      Acceptez vos paramètres et choisissez Next (Suivant).

  5. Vérifiez la page Spécifier des remplacements et choisissez Next (Suivant).

  6. Confirmez et examinez la page Révision et choisissez Submit (Soumettre).

Importer une pile gérée par le service dans un StackSet (AWS CLI)

Une fois qu’un StackSet est créé, vous pouvez importer vos piles en transmettant les ID de pile des piles importées. Vous pouvez également transmettre la liste d'ID d'unité d'organisation à laquelle vous souhaitez le mapper.

CloudFormation importera les piles fournies par l’utilisateur dans ces UO et utilisera ces UO comme cibles de déploiement pour le StackSet. Les ID de pile présentés dans l'entrée seront mappés à l'unité d'organisation la plus proche dans la liste d'ID d'unité d'organisation entrée en interne. Si une pile n'appartient pas à un ID d'unité d'organisation existant dans la liste d'entrée, l'AWS CLI va renvoyer l'erreur StackNotFoundException.

L'opération import-stacks-to-stack-set crée des instances de pile pour les piles dans l'entrée d'ID d'unité d'organisation. Les exemples suivants de l’AWS CLI utilisent l’opération import-stacks-to-stack-set pour importer une pile dans un StackSet.

  • Pour utiliser l'opération import-stacks-to-stack-sets, spécifiez les stack-ids ou stack-ids-url que vous souhaitez importer dans votre ensemble de piles.

    aws cloudformation import-stacks-to-stack-set \
  --stack-set-name ServiceMangedStackSet \
  --stack-ids "arn:123456789012:us-east-1:Stack1" \
  --organizational-unit-ids ou-examplerootid111-exampleouid111
    aws cloudformation import-stacks-to-stack-set \
  --stack-set-name ServiceMangedStackSet \
  --stack-ids-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/file-name.json \
  --organizational-unit-ids ou-examplerootid111-exampleouid111
Note

L'opération import-stacks-to-stack-sets vous oblige à spécifier au moins un ID d'unité d'organisation afin qu'elle puisse associer la pile importée à cette unité d'organisation particulière. Cette opération ne crée pas d'instances de pile pour d'autres comptes membres dans les unités d'organisation associées. Pour mettre à jour les comptes membres pour les unités d'organisation associées, utilisez create-stack-instances ou update-stack-instances.

create-stack-set crée des instances de pile pour tous les comptes sous les UO à l’aide d’un modèle fourni par l’utilisateur, soit à partir d’un chargement direct, soit à partir d’Amazon S3. Les exemples suivants de l’AWS CLI utilisent l’opération create-stack-set pour importer une pile dans un nouvel StackSet.

  • Pour utiliser l’opération create-stack-set, indiquez le nom de votre StackSet et importez une pile dans un StackSet nouvellement créé.

    aws cloudformation create-stack-set \
  --template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/file-name.json \
  --permission-model SERVICE_MANAGED \
  --auto-deployment Enabled=true