Importez automatiquement des ressources AWS dans une pile CloudFormation - AWS CloudFormation
Résolution des problèmes

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.

Importez automatiquement des ressources AWS dans une pile CloudFormation

Vous pouvez désormais importer automatiquement des ressources nommées lors de la création ou de la mise à jour de piles CloudFormation. Une ressource nommée est une ressource dotée d’un nom personnalisé. Pour plus d’informations, consultez la section Type de nom dans la référence du modèle CloudFormation.

Lorsque vous lancez l’importation automatique, CloudFormation recherche les ressources existantes qui correspondent à votre modèle et les importe pendant le déploiement. Pour les piles imbriquées, créez l’ensemble de modifications à partir de la pile racine.

Une fois l'importation terminée et avant d'effectuer les opérations de pile suivantes, nous vous conseillons d'exécuter la détection de l'écart sur les ressources importées. La détection de l'écart garantit que la configuration du modèle correspond à la configuration réelle. Pour de plus amples informations, consultez Détection de l'écart sur une pile CloudFormation complète.

Pour importer une ressource, ils doivent vous conformer aux exigences suivantes :

  • La ressource doit avoir un nom personnalisé statique défini dans votre modèle. Les noms dynamiques (utilisant !Ref ou d’autres fonctions) ne sont actuellement pas pris en charge.

  • La ressource doit avoir une DeletionPolicy de Retain ouRetainExceptOnCreate.

  • La ressource ne doit pas déjà appartenir à une autre pile CloudFormation.

  • Le type de ressource doit prendre en charge les opérations d’importation CloudFormation. Pour de plus amples informations, consultez Prise en charge des types de ressources.

  • L’ID principal du type de ressource doit figurer dans le modèle. Les identifiants principaux dotés de propriétés en lecture seule ne sont pas pris en charge. Pour savoir quel est l’ID principal d’un type, recherchez la propriété primaryIdentifier dans le schéma de ressource. Pour plus d’informations sur la propriété, consultez PrimaryIdentifier.

Exemple d’importation automatique

L’exemple suivant utilise un ensemble de modifications, CreateChangeSet pour créer une pile appelée my-stack basée sur un fichier modèle, template.yaml, et importe automatiquement les ressources correspondantes.

aws cloudformation create-change-set \
  --stack-name my-stack \
  --change-set-name CreateChangeSet \
  --change-set-type CREATE \
  --template-body file://template.yaml \
  --import-existing-resources

Résolution des problèmes

Si l’importation automatique échoue, procédez comme suit pour résoudre le problème :

  • Vérifiez que le nom de la ressource dans votre modèle correspond exactement au nom de la ressource

  • Vérifiez que la ressource n’est pas déjà gérée par une autre pile

  • Assurez-vous que le type de ressource prend en charge les opérations d’importation

  • Vérifiez que votre modèle inclut toutes les propriétés requises pour le type de ressource