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 stack autogérée pour CloudFormation StackSets
L'opération d'importation de CloudFormation piles peut importer des piles existantes dans des piles nouvelles ou existantes StackSets, afin que vous puissiez migrer des piles existantes vers une opération 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 de l'ensemble de piles 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 compte 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 être **AWSCloudFormationStackSetsExectionRole**autorisé **AWSCloudFormationStackSetAdministrationRole**.
**Topics**
+ [Importer une pile existante dans une nouvelle StackSet (console)](#import-stacks-to-stack-set)
+ [Importer une pile existante dans une pile existante StackSet (console)](#import-stack-to-existing-stackset)
+ [Importer une pile dans un StackSet (AWS CLI)](#importing-stack-to-stackset.cli)
## Importer une pile existante dans une nouvelle StackSet (console)
Avant de commencer, identifiez la pile que vous voulez importer.
1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)
1. Dans le volet de navigation, choisissez **StackSets**.
1. En haut de la **StackSets**page, choisissez **Create StackSet**.
1. 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.
1. Sur la page **Spécifier StackSet les détails**, entrez le nom du StackSet fichier que vous souhaitez créer et choisissez **Suivant**.
(Facultatif) Entrez une description du StackSet.
1. Sur la page des ** StackSet options de configuration**, passez en revue vos choix et choisissez **Suivant**.
1. Sur la page **Définir les options de déploiement**, sélectionnez **Importer des piles dans le StackSet**.
1. 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.
1. Vérifiez vos options de déploiement et sélectionnez **Suivant**.
1. Sur la page **Révision**, passez en revue vos choix et vos StackSet propriétés. Lorsque vous êtes prêt à importer votre pile dans votre StackSet, choisissez **Soumettre**.
**Résultats** : La pile importée est désormais une instance de pile de la pile spécifiée StackSet. Pour en savoir plus sur l’état de l’importation de la pile, consultez [StackSets codes de statut](stacksets-concepts.md#stackset-status-codes).
## Importer une pile existante dans une pile existante StackSet (console)
Avant de commencer, identifiez la pile que vous voulez importer.
1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)
1. Dans le volet de navigation, choisissez **StackSets**.
1. Sur la **StackSets**page, choisissez StackSet celui dans lequel vous souhaitez importer une pile.
1. Lorsque cette option est StackSet sélectionnée, choisissez **Ajouter des piles à** dans le StackSet menu **Actions**.
1. 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.
1. Choisissez **Suivant**.
1. Sur la page **Spécifier les remplacements**, vérifiez vos choix et sélectionnez **Suivant**.
1. Sur la page **Révision**, passez en revue vos choix et vos StackSet propriétés. Lorsque vous êtes prêt à créer votre StackSet, choisissez **Soumettre**.
**Résultats** : La pile importée est désormais une instance de pile de la pile spécifiée StackSet. Pour en savoir plus sur l’état de l’importation de la pile, consultez [StackSets codes de statut](stacksets-concepts.md#stackset-status-codes).
## Importer une pile dans un StackSet (AWS CLI)
**Pour importer une pile existante dans une nouvelle StackSet**
La `create-stack-set` commande suivante crée 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 une pile existante StackSet**
La `import-stacks-to-stack-sets` commande suivante importe la pile spécifiée dans le *MyStackSet* StackSet. 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 `create-stack-instances` commande 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"]'
```