Debuter avec Terraform

Pourquoi Terraform ?

Terraform est un outil open-source développé par HashiCorp qui permet de provisionner et de gérer l'infrastructure en tant que code (IaC). Il est particulièrement utile pour les développeurs qui souhaitent :

• Automatiser la création, la configuration et la gestion de leurs infrastructures cloud
• Améliorer la productivité et la cohérence dans le déploiement d'applications
• Assurer une meilleure versionning et collaboration entre les équipes techniques

Un cas d'usage concret est l'automatisation du déploiement d'une application web sur un fournisseur de cloud comme AWS, GCP ou Azure. Terraform permet de définir toutes les ressources nécessaires (serveurs, bases de données, stockages) dans un fichier de configuration déclaratif, ce qui facilite la mise à jour et le scaling de l'infrastructure.

Prerequis

Pour commencer avec Terraform, vous avez besoin des éléments suivants :

• Une connaissance de base en programmation (langages comme Python, Go ou JavaScript)
• Un compte sur un fournisseur cloud (AWS, GCP, Azure, etc.)
• L'installation d'un environnement de développement (IDE) qui supporte la syntaxe Terraform

Les outils que vous devez installer sont :

• Terraform : La version recommandée est la dernière stable. Vous pouvez télécharger le binaire depuis le site officiel de HashiCorp et suivre les instructions pour l'installation sur votre système.

  # Exemple d'installation sous Linux
  wget https://releases.hashicorp.com/terraform/1.5.7/terraform_1.5.7_linux_amd64.zip
  unzip terraform_1.5.7_linux_amd64.zip
  sudo mv terraform /usr/local/bin/
  

• Un provider cloud : Terraform nécessite un plugin pour interagir avec le fournisseur de votre choix. Par exemple, si vous utilisez AWS, vous devrez installer le plugin aws.

  # Installation du provider AWS
  terraform init
  terraform provider add hashicorp/aws v3.46.0
  

Concepts fondamentaux

1. Provider

Un provider est un module Terraform qui comprend les ressources et les données spécifiques à un fournisseur de cloud (AWS, Azure, GCP, etc.).

## Exemple de configuration d'un provider AWS
provider "aws" {
  region = "us-west-2"
}

2. Resource

Une resource est une ressource spécifique que Terraform va créer, modifier ou supprimer. Par exemple, un serveur EC2 dans AWS.

## Exemple de création d'une instance EC2
resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
}

3. Data Source

Un data source permet de récupérer des données existantes et les utiliser dans votre configuration Terraform. Par exemple, obtenir l'ID d'un groupe de sécurité.

## Exemple d'utilisation d'une data source AWS security group
data "aws_security_group" "allow_web_traffic" {
  name = "web-traffic"
}

resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
  security_groups = [data.aws_security_group.allow_web_traffic.id]
}

4. Variable

Les variables vous permettent de rendre votre configuration plus flexible et réutilisable.

## Exemple d'utilisation d'une variable
variable "instance_type" {
  description = "Type of EC2 instance"
  default     = "t2.micro"
}

resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = var.instance_type
}

5. Output

Les outputs permettent de retourner des valeurs à partir de votre configuration Terraform.

## Exemple d'utilisation d'un output
output "instance_public_ip" {
  value = aws_instance.example.public_ip
}

Mise en pratique : projet fil rouge

Nous allons créer un simple projet qui déploie une machine virtuelle sur AWS. Voici les étapes à suivre :

1. Initialisation de Terraform

   # Créer un nouveau répertoire pour le projet et initialiser Terraform
   mkdir my_first_terraform_project
   cd my_first_terraform_project
   terraform init
   

2. Configuration du provider AWS

   # file: main.tf
   provider "aws" {
     region = "us-west-2"
   }
   

3. Définition d'une instance EC2

   # file: main.tf
   resource "aws_instance" "example" {
     ami           = "ami-0c55b159cbfafe1f0"
     instance_type = "t2.micro"
   }
   

4. Ajout d'un output pour afficher l'adresse IP publique

   # file: main.tf
   output "instance_public_ip" {
     value = aws_instance.example.public_ip
   }
   

5. Exécution de la configuration

   # Planifier et appliquer la configuration
   terraform plan
   terraform apply
   

6. Suppression de l'infrastructure

   # Supprimer l'infrastructure déployée
   terraform destroy
   

Erreurs frequentes et debugging

1. Error: provider registry.terraform.io/hashicorp/aws v3.46.0: no available version meets the constraint ">= 3.46.0"

Code incorrect :

provider "aws" {
  region = "us-west-2"
}

Code correct :

## Installer le bon provider AWS
terraform init
terraform provider add hashicorp/aws v3.46.0

2. `Error: Error applying plan: 1 error(s) occurred:

• aws_instance.example (aws_instance.example): failed to launch instance: InsufficientInstanceCapacity`

Code incorrect :

resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
}

Code correct :

## Changer l'instance type si nécessaire
resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
}

3. `Error: Error applying plan: 1 error(s) occurred:

• aws_instance.example (aws_instance.example): failed to launch instance: Invalid AMI ID`

Code incorrect :

resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
}

Code correct :

## Vérifier l'AMI ID et le région AWS
terraform state show aws_ami.example

Pour aller plus loin

1. Variables et interpolation

Apprenez à utiliser les variables et l'interpolation pour rendre votre configuration flexible.

• Documentation officielle : Variables
• Documentation officielle : Expressions

2. Modules

Découvrez comment organiser votre code en modules réutilisables.

• Documentation officielle : Modules

3. Backend et State Management

Explorez les options de stockage pour le state Terraform et leur impact sur la collaboration dans l'équipe.

• Documentation officielle : Backends
• Documentation officielle : State management

Défi pratique :

Créez un module pour déployer une application web sur AWS, qui comprend les ressources suivantes :

• Un groupe de sécurité
• Une instance EC2 avec un système d'exploitation et des logiciels nécessaires installés
• Un volume EBS persistant

Commencez par créer une structure de répertoire appropriée pour votre module et définissez les variables, ressources et outputs nécessaires. Ensuite, utilisez ce module dans votre projet principal et déployez l'infrastructure.