Importer des ressources existantes

Vous disposez parfois de ressources cloud créées manuellement ou par d’autres outils. L’importation Terraform vous permet de placer ces ressources existantes sous la gestion de Terraform.

Terraform pourra alors suivre leur état, et les modifications futures pourront être appliquées via vos fichiers de configuration. Il s’agit d’une étape essentielle pour adopter l’infrastructure as code (IaC) dans un environnement « brownfield ».

L’importation est utile dans plusieurs situations :

• Migrer une infrastructure existante : intégrer à votre processus IaC des ressources créées en dehors de Terraform.
• Adopter Terraform progressivement : commencer avec les ressources existantes plutôt que tout recréer.
• Récupérer après une perte d’état : réassocier Terraform aux ressources si votre fichier d’état est perdu (bien que cela soit rare avec un état distant).

La structure de base de la commande terraform import est simple. Elle indique à Terraform de rechercher une ressource existante chez votre fournisseur cloud et de l’ajouter à votre fichier d’état, en l’associant à un bloc de ressource dans votre configuration.

Elle nécessite deux informations principales : l’adresse Terraform de la ressource et l’ID de cette ressource chez le fournisseur cloud.

L’adresse de ressource est la manière dont Terraform identifie une ressource donnée dans votre configuration. Elle suit le modèle resource_type.resource_name.

• resource_type : le type de ressource (par exemple aws_s3_bucket, azurerm_resource_group).
• resource_name : le nom local que vous attribuez à la ressource dans votre configuration Terraform (par exemple my_bucket, web_app).

Cette adresse doit déjà exister dans vos fichiers .tf.

Chaque ressource chez un fournisseur cloud (comme AWS, Azure ou GCP) possède un identifiant unique, souvent appelé ID. Vous aurez besoin de cet ID pour indiquer à Terraform quelle ressource existante précise importer.

Vous pouvez trouver cet ID dans la console du fournisseur cloud, via son CLI ou au moyen de son API. Par exemple, l’ID d’un compartiment AWS S3 est son nom, tandis qu’une instance EC2 possède un identifiant d’instance tel que i-0abcdef1234567890.

Étape essentielle : avant d’exécuter terraform import, vous devez avoir défini un bloc de ressource correspondant dans vos fichiers de configuration Terraform (fichiers .tf).

Ce bloc indique à Terraform le type de ressource attendu et les attributs qu’elle doit posséder. Terraform utilise cette définition pour comprendre le schéma de la ressource pendant l’importation.

Supposons que vous disposiez d’un compartiment AWS S3 existant nommé my-existing-coddykit-bucket-123. Commencez par définir un bloc de ressource pour celui-ci dans votre main.tf :

Maintenant que vous disposez de la définition HCL, vous pouvez exécuter la commande terraform import. Remplacez my-existing-coddykit-bucket-123 par le nom ou l’ID réel de votre compartiment existant.

Assurez-vous d’avoir déjà exécuté terraform init dans votre répertoire !

Après une importation réussie, Terraform aura ajouté la ressource à votre fichier d’état. Vous pouvez le vérifier avec terraform state show, qui affiche les attributs de la ressource importée tels que Terraform les voit.

Il est ensuite essentiel d’exécuter terraform plan pour vérifier qu’il n’existe aucune différence inattendue entre votre HCL et l’état réel de la ressource importée.

Vous souhaitez importer une instance AWS EC2 existante dans Terraform. Laquelle des étapes suivantes MUST être terminée avant d’exécuter la commande terraform import ?

Vous avez appris à placer des ressources cloud existantes sous la gestion de Terraform avec terraform import.

• Commencez par définir le bloc de ressource dans votre HCL.
• Identifiez ensuite l’ID de ressource fourni par le fournisseur cloud.
• Enfin, exécutez terraform import ADDRESS ID.
• Exécutez toujours ensuite terraform plan pour résoudre les éventuelles différences.

Cette commande puissante contribue à combler l’écart entre une infrastructure gérée manuellement et un environnement entièrement piloté par l’IaC.