Qu’est-ce que Terraform Import ?

L’importation Terraform est une commande cruciale de la boîte à outils Terraform. Elle permet aux utilisateurs d’intégrer l’infrastructure existante sous la gestion Terraform, ce qui est essentiel pour intégrer Terraform dans les environnements existants sans avoir à reconstruire l’infrastructure à partir de zéro.

Dans cet article, nous examinerons en détail l’importation de Terraform, son importance et comment l’utiliser efficacement pour automatiser et améliorer la cohérence de la gestion de votre infrastructure.

Comprendre l’importation Terraform

L’importation Terraform vous permet de prendre des ressources créées en dehors de Terraform et de les gérer. Ce processus consiste à mapper les ressources d’infrastructure existantes aux configurations Terraform correspondantes. Ce faisant, Terraform peut suivre l’état de ces ressources, y compris leurs attributs et leurs relations, et les gérer parallèlement aux ressources explicitement définies dans votre code Terraform.

Ce processus offre divers avantages, notamment :

• Intégration transparente : L’importation Terraform vous permet d’intégrer l’infrastructure existante à votre flux de travail Terraform sans avoir à tout reconstruire de A à Z. Cela est particulièrement utile pour remplacer les environnements existants ou migrer les charges de travail vers une nouvelle plateforme. Vous pouvez importer des ressources progressivement, ce qui limite les interruptions des opérations en cours.
• Gestion unifiée : Une fois importées, toutes les ressources de l’infrastructure peuvent être gérées via les fichiers de configuration de Terraform. Vous n’avez plus besoin de passer d’un outil ou d’un processus manuel à un autre pour gérer différentes parties de votre infrastructure.
• Cohérence : Terraform applique une approche déclarative de la gestion de l’infrastructure. En important les ressources existantes, vous pouvez vous assurer qu’elles sont toutes définies et gérées de manière cohérente à l’aide des configurations Terraform. Cela améliore la maintenabilité, réduit les erreurs et simplifie les changements d’infrastructure. Imaginez, par exemple, gérer un mélange de machines virtuelles (VM) et de machines virtuelles créées manuellement avec Terraform. L’importation des VM existantes garantit une définition cohérente de toutes les VM, ce qui vous permet d’exploiter les fonctionnalités Terraform telles que le contrôle de version et le provisioning automatisé pour toutes vos VM.

Démarrer avec Terraform Import

L’importation Terraform vous permet d’intégrer l’infrastructure existante sous la gestion Terraform sans avoir à recréer des ressources. Ce court didacticiel vous guidera tout au long du processus d’utilisation de Terraform Import pour gérer une instance AWS EC2 existante. À la fin du guide, vous comprendrez comment importer des ressources dans Terraform et les gérer efficacement.

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

1. Terraform installé : Téléchargez et installez Terraform depuis le site Web officiel de Terraform .
2. AWS CLI installé : Installer et configurer la CLI AWS avec les identifiants appropriés.
3. Instance AWS EC2 existante : Disposer d’une instance EC2 existante que vous souhaitez importer dans la gestion Terraform.

 

Étape 1 : Configuration de votre plateforme

Tout d’abord, créez un répertoire pour votre projet Terraform et accédez-y. Ensuite, créez un nouveau fichier nommé main.tf :

$ mkdir terraform-import-tutorial
 $ cd terraform-import-tutorial
 $ touch main.tf

Étape 2 : Écrire la configuration Terraform

Dans le fichier main.tf, définissez le fournisseur et la ressource que vous prévoyez d’importer. Dans ce didacticiel, nous utiliserons une instance AWS EC2.

provider "aws" {
 region = "us-west-2"
 }
 resource "aws_instance" "example" {
 # The configuration will be filled in after importing the instance.
 }

Étape 3 : Initialiser Terraform

Avant d’utiliser Terraform, initialisez votre répertoire de travail avec les plug-ins nécessaires :

$ terraform init

Étape 4 : Identifier l’instance EC2 à importer

Localisez l’ID d’instance EC2 que vous souhaitez importer. Vous pouvez le trouver dans la console de gestion AWS ou en utilisant la CLI AWS. Supposons par exemple que l'ID d'instance soit i-1234567890abcdef0.

Étape 5 : Importation de l’instance EC2

Utilisez la commande d’importation terraforme pour importer l’instance EC2 existante dans Terraform. Exécutez la commande suivante dans votre terminal :

$ terraform import aws_instance.example i-1234567890abcdef0

Cette commande demande à Terraform d’associer la ressource aws_instance.exemple dans votre configuration à l’instance EC2 existante i-1234567890abcdef0.

Étape 6 : Vérifier l’importation

Après l’importation, Terraform met à jour le fichier d’état avec les informations sur la ressource importée. Cependant, votre fichier main.tf sera toujours incomplet. Pour remplir la configuration, utilisez la commande d’affichage terraforme pour inspecter la ressource importée et mettre à jour main.tf en conséquence :

$ terraform show

Vous verrez les détails de la ressource importée. Mettez à jour main.tf pour qu’elle corresponde à la configuration réelle de la ressource. Voici un exemple de ce à quoi cela pourrait ressembler :

provider "aws" {
 region = "us-west-2"
 }
 resource "aws_instance" "example" {
 ami           = "ami-0c55b159cbfafe1f0"  # Replace with your instance's AMI ID
 instance_type = "t2.micro"                # Replace with your instance type
 key_name      = "my-key-pair"             # Replace with your key pair name
 # Additional attributes as per the `terraform show` output
 }

Étape 7 : Appliquer les modifications de configuration

Maintenant que votre fichier de configuration reflète précisément la ressource importée, vous pouvez le gérer avec Terraform. Exécutez un plan terraforme pour voir les actions planifiées :

$ terraform plan

Si tout vous semble correct, appliquez les modifications suivantes :

$ terraform apply

Étape 8 : Gérer votre infrastructure

Vous pouvez désormais gérer votre ressource importée à l’aide de Terraform. Par exemple, vous pouvez mettre à jour le type d’instance ou d’autres attributs dans main.tf et appliquer les modifications avec terraform apply .

Points à prendre en compte lors de l’utilisation de ressources importées

Bien que l’importation Terraform offre un moyen puissant de gérer l’infrastructure existante, il faut garder à l’esprit certains points essentiels :

• Correspondance de configuration : Terraform s’appuie sur sa configuration pour gérer les ressources. Lors de l’importation d’une ressource, assurez-vous que la configuration Terraform reflète précisément les attributs de la ressource existante. Toute discordance entre la configuration et la ressource réelle peut entraîner des comportements inattendus ou des erreurs pendant l’importation ou la gestion ultérieure.
• Gestion de l’État : Terraform stocke l’état de votre infrastructure, y compris les ressources importées, dans un fichier d’état. Ce fichier est essentiel pour que Terraform puisse suivre les ressources et gérer leur cycle de vie. Voici comment assurer une gestion adéquate de l’état :
  • Sécurisez le fichier d’état : Le fichier d’état contient des informations sensibles sur les ressources de votre infrastructure. Mettre en œuvre des mesures de sécurité appropriées pour la protéger contre tout accès non autorisé. Envisagez de stocker le fichier d’état dans un emplacement sécurisé comme un backend dédié comme Terraform Cloud ou Terraform Enterprise.
  • Sauvegardes régulières : Sauvegardez régulièrement votre fichier d’état pour éviter la perte de données en cas de suppression accidentelle ou de corruption. Une sauvegarde vous permet de restaurer l’état si nécessaire.

Bonnes pratiques de gestion des ressources importées

En suivant ces bonnes pratiques, vous gérez efficacement vos ressources importées ainsi que celles définies dans le code Terraform :

1. Vérification après importation : Après une importation réussie, vérifiez que les attributs de la ressource importée dans l’état Terraform correspondent à la configuration réelle de la ressource. Utilisez la commande d’affichage terraforme pour inspecter la ressource importée et la comparer aux détails obtenus à partir de la console ou de l’API de votre fournisseur de cloud.
2. Mises à jour de la configuration : Les ressources peuvent être modifiées en dehors de Terraform après leur importation. Il est important de mettre à jour la configuration Terraform pour refléter toute modification apportée aux attributs de la ressource. Terraform assure ainsi une représentation précise de votre infrastructure et vous permet de gérer efficacement les ressources à l’aide de Terraform.
3. Importation de la documentation : Conserver une documentation claire pour les ressources importées. Cette documentation doit détailler :
   • Le type de ressource importée (par exemple, instance AWS EC2)
   • L’identifiant de la ressource importée (par exemple, ID d’instance)
   • Les étapes prises pendant le processus d’importation
   • Toutes les considérations ou notes spécifiques liées à l’importation    

Conclusion

L’importation Terraform comble le fossé entre l’infrastructure existante et la puissance de gestion de Terraform. Elle vous permet d’intégrer en toute transparence l’ensemble de votre pile d’infrastructure, quelle que soit la méthode de création. Cette approche unifiée réduit la complexité, améliore la visibilité et rationalise la gestion de l’infrastructure.

À mesure que votre infrastructure évolue, le stockage devient un facteur essentiel. Découvrez les solutions Pure Storage, telles que Portworx® pour les charges de travail conteneurisées et Pure Cloud Block Store™ pour les déploiements cloud, afin d’optimiser la gestion du stockage parallèlement à Terraform. Cette combinaison garantit une infrastructure efficace et évolutive pour vos applications modernes.