Importez automatiquement AWS des ressources dans une CloudFormation pile - 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 AWS des ressources dans une CloudFormation pile

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

Lorsque vous lancez l'importation automatique, CloudFormation vérifiez si les ressources existantes correspondent à votre modèle et les importez 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, veuillez consulter Détectez la dérive sur l'ensemble d'une CloudFormation pile.

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 CloudFormation pile.

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

  • L’ID principal du type de ressource doit figurer dans le modèle. Les propriétés principales IDs dotées de propriétés en lecture seule ne sont pas prises 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 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