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
DeletionPolicydeRetainouRetainExceptOnCreate. -
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 ou un identifiant supplémentaire pour le type de ressource doit figurer dans le modèle. Les identifiants principaux IDs ou supplémentaires dotés de propriétés en lecture seule ne sont pas pris en charge. Pour savoir quel est l'ID principal ou les identifiants supplémentaires d'un type, recherchez les
additionalIdentifierspropriétésprimaryIdentifieret dans le schéma de ressource. Pour plus d'informations à ce sujet, consultez le schéma de définition du type de ressource.
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-namemy-stack\ --change-set-nameCreateChangeSet\ --change-set-type CREATE \ --template-bodyfile://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 l'importation automatique
Vérifiez que votre modèle inclut toutes les propriétés requises pour le type de ressource
Types de ressources pris en charge
Le tableau suivant répertorie les types de AWS ressources actuellement compatibles avec l'importation automatique.