Importation de pile autogérée pour les StackSets CloudFormation - 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.

Importation de pile autogérée pour les StackSets CloudFormation

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. En utilisant l'importation de pile, vous évitez les temps d'arrêt et les pannes sans supprimer et recréer ces ressources. Une fois la pile importée dans un StackSet, la pile d’origine devient une instance de pile du StackSet spécifié.

Considérations relatives à l’importation de piles autogérées
  • L’opération d’importation de piles nécessite un compte administrateur dans lequel vous créez un StackSet et un compte cible contenant une pile.

  • Le compte de destination doit être autorisé à utiliser l'opération GetTemplate avec l'entrée de l'ID de pile ou de l'ARN. Pour cette raison, votre compte administrateur doit disposer des autorisations AWSCloudFormationStackSetAdministrationRole ou AWSCloudFormationStackSetsExectionRole.

Importer une pile existante dans un nouveau StackSet (console)

Avant de commencer, identifiez la pile 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, spécifiez un modèle à l’aide de l’une des options suivantes et sélectionnez Suivant.

    • Choisissez Amazon S3 URL (URL Amazon S3), puis spécifiez l'URL de votre modèle dans la zone de texte.

    • Choisissez Upload a template file (Charger un fichier de modèle), puis recherchez votre modèle.

    • Choisissez From stack ID (Depuis l'ID de la pile) et saisissez l'ID de votre pile.

  5. Sur la page Spécifier les détails du StackSet, entrez le nom du StackSet que vous voulez créer et sélectionnez Suivant.

    (Facultatif) Entrez une description du StackSet.

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

  7. Sur la page Définir les options de déploiement, sélectionnez Importer des piles dans le StackSet.

  8. Saisissez l'ID de la pile que vous souhaitez importer dans le champ Stacks to import (Piles à importer). Par exemple, arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786.

    (Facultatif) Sélectionnez Ajouter un autre ID de pile et saisissez l’ID d’une autre pile que vous voulez importer. Vous pouvez ajouter jusqu'à 10 piles par opération d'importation de pile.

  9. Vérifiez vos options de déploiement et sélectionnez Suivant.

  10. Sur la page Vérifier, vérifiez vos choix et les propriétés de votre StackSet. Lorsque vous êtes prêt à importer votre pile dans votre StackSet, sélectionnez Soumettre.

Résultats : la pile importée est désormais une instance de pile du StackSet spécifié. Pour en savoir plus sur l’état de l’importation de la pile, consultez StackSets codes de statut.

Importer une pile existante dans un StackSet existant (console)

Avant de commencer, identifiez la pile 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. Sur la page StackSets, sélectionnez le StackSet dans lequel vous voulez importer une pile.

  4. Une fois le StackSet sélectionné, sélectionnez Ajout de piles à StackSet dans le menu Actions.

  5. Sur la page Définir les options de déploiement, sélectionnez Importer des piles dans le StackSet et saisissez l’ID de la pile que vous voulez importer dans le champ Piles à importer. Par exemple, arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786.

    (Facultatif) Sélectionnez Ajouter un autre ID de pile et saisissez l’ID d’une autre pile que vous voulez importer. Vous pouvez ajouter jusqu'à 10 piles par opération d'importation de pile.

  6. Choisissez Suivant.

  7. Sur la page Spécifier les remplacements, vérifiez vos choix et sélectionnez Suivant.

  8. Sur la page Vérifier, vérifiez vos choix et les propriétés de votre StackSet. Lorsque vous êtes prêt à créer votre StackSet, sélectionnez Soumettre.

Résultats : la pile importée est désormais une instance de pile du StackSet spécifié. Pour en savoir plus sur l’état de l’importation de la pile, consultez StackSets codes de statut.

Importer une pile dans un StackSet (AWS CLI)

Pour importer une pile existante dans un nouveau StackSet

La commande create-stack-set suivante crée un StackSet et importe la pile spécifiée. La pile à importer est identifiée par son ARN. Remplacez chaque espace réservé par vos propres informations.

aws cloudformation create-stack-set \ --stack-set-name MyStackSet \ --stack-id arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/466df9e0-0dff-08e3-8e2f-5088487c4896 \ --administration-role-arn arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole \ --execution-role-name AWSCloudFormationStackSetExecutionRole
Pour importer une pile existante dans un StackSet existant

La commande import-stacks-to-stack-sets suivante importe la pile spécifiée dans le StackSet MyStackSet. La pile à importer est identifiée par son ARN. Remplacez chaque espace réservé par vos propres informations.

aws cloudformation import-stacks-to-stack-set \ --stack-set MyStackSet \ --stack-ids arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786

Pour spécifier plusieurs piles, veuillez utiliser le format suivant pour la valeur de l’option --stack-ids.

--stack-ids "arn_1" "arn_2"
Pour cloner la pile importée dans d’autres régions et comptes

La commande create-stack-instances suivante ajoute des instances de pile à votre StackSet. Remplacez chaque espace réservé par vos propres informations.

aws cloudformation create-stack-instances \ --stack-set-name MyStackSet \ --accounts '["account_ID_1","account_ID_2"]' \ --regions '["region_1","region_2"]'