# Référence rapide Terraform

*Fournisseurs, ressources, variables, état, modules*

> Source: Terraform Documentation (developer.hashicorp.com/terraform) · MIT

## Bases

### Flux de travail principal

```
terraform init      # install providers & modules
terraform plan      # preview changes
terraform apply     # apply changes
terraform destroy   # tear down all resources
```

### Commandes essentielles

| Command | Description |
|---------|-------------|
| `terraform init` | Initialiser le répertoire de travail, télécharger les fournisseurs |
| `terraform plan` | Afficher le plan d'exécution sans appliquer |
| `terraform apply` | Appliquer les modifications à l'infrastructure |
| `terraform destroy` | Détruire toutes les ressources gérées |
| `terraform fmt` | Formater les fichiers `.tf` selon le style canonique |
| `terraform validate` | Vérifier la syntaxe de la configuration |
| `terraform show` | Afficher l'état actuel ou le plan |
| `terraform output` | Afficher les valeurs de sortie |

## Fournisseurs

### Configuration du fournisseur

```
terraform {
  required_providers {
    aws = { source = "hashicorp/aws", version = "~> 5.0" }
  }
}
provider "aws" {
  region = "us-east-1"
}
```

### Notes sur les fournisseurs

| Command | Description |
|---------|-------------|
| `source` | Adresse du registre (`hashicorp/aws`, `hashicorp/google`) |
| `version` | Contrainte de version (`~> 5.0`, `>= 3.0, < 4.0`) |
| `.terraform.lock.hcl` | Fichier de verrouillage — à valider dans le contrôle de version |
| `alias` | Utiliser plusieurs configurations pour le même fournisseur |

## Ressources

### Blocs de ressources

```
resource "aws_instance" "web" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
  tags = { Name = "web-server" }
}
```

### Meta-arguments de ressource

| Command | Description |
|---------|-------------|
| `depends_on` | Dépendance explicite envers une autre ressource |
| `count` | Créer plusieurs instances (`count = 3`) |
| `for_each` | Créer des instances depuis une map ou un ensemble |
| `provider` | Sélectionner un alias de fournisseur non par défaut |
| `lifecycle` | Personnaliser le comportement de création/mise à jour/destruction |

### Référencer les ressources

```
# type.name.attribute
aws_instance.web.id
aws_instance.web.public_ip
aws_vpc.main.cidr_block
```

## Variables

### Déclarer des variables

```
variable "region" {
  type    = string
  default = "us-east-1"
}
variable "instance_count" {
  type        = number
  description = "Number of instances"
}
```

### Définir les valeurs de variables

| Command | Description |
|---------|-------------|
| `-var 'region=us-west-2'` | Option en ligne de commande |
| `-var-file=prod.tfvars` | Charger depuis un fichier `.tfvars` |
| `terraform.tfvars` | Chargé automatiquement si présent |
| `TF_VAR_region` | Variable d'environnement |
| `Interactive prompt` | Demandé au plan/apply si pas de valeur par défaut |

### Types de variables

| Command | Description |
|---------|-------------|
| `string` | `"us-east-1"` |
| `number` | `42` |
| `bool` | `true` / `false` |
| `list(string)` | `["a", "b"]` |
| `map(string)` | `{ key = "val" }` |
| `object({...})` | Type structuré avec attributs nommés |

## Sorties

### Définir des sorties

```
output "instance_ip" {
  value       = aws_instance.web.public_ip
  description = "Public IP of the web server"
}
output "db_password" {
  value     = random_password.db.result
  sensitive = true
}
```

### Commandes de sortie

| Command | Description |
|---------|-------------|
| `terraform output` | Afficher toutes les sorties |
| `terraform output instance_ip` | Afficher une sortie spécifique |
| `terraform output -json` | Format JSON pour les scripts |
| `sensitive = true` | Masquer la valeur dans la sortie CLI |
| `module.vpc.vpc_id` | Accéder aux sorties d'un module enfant |

## État

### Backend distant

```
terraform {
  backend "s3" {
    bucket = "my-tf-state"
    key    = "prod/terraform.tfstate"
    region = "us-east-1"
  }
}
```

### Commandes d'état

| Command | Description |
|---------|-------------|
| `terraform state list` | Lister toutes les ressources dans l'état |
| `terraform state show <addr>` | Afficher les attributs d'une ressource |
| `terraform state mv <src> <dst>` | Renommer / déplacer une ressource dans l'état |
| `terraform state rm <addr>` | Supprimer une ressource de l'état (garder l'infra) |
| `terraform state pull` | Télécharger l'état distant vers stdout |
| `terraform import <addr> <id>` | Importer une infra existante dans l'état |

## Modules

### Utiliser des modules

```
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.0"
  cidr    = "10.0.0.0/16"
}
```

### Sources de modules

| Command | Description |
|---------|-------------|
| `"./modules/vpc"` | Chemin local |
| `"terraform-aws-modules/vpc/aws"` | Registre Terraform |
| `"github.com/org/repo//module"` | Dépôt GitHub |
| `"s3::https://bucket/module.zip"` | Compartiment S3 |

### Structure d'un module

```
modules/vpc/
  main.tf          # resources
  variables.tf     # input variables
  outputs.tf       # output values
```

## Sources de données

### Lire des ressources existantes

```
data "aws_ami" "ubuntu" {
  most_recent = true
  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd/*"]
  }
  owners = ["099720109477"]
}
```

### Sources de données courantes

| Command | Description |
|---------|-------------|
| `data.aws_ami` | Rechercher une AMI par filtres |
| `data.aws_vpc` | Rechercher un VPC existant |
| `data.aws_caller_identity` | Identifiant de compte AWS actuel |
| `data.aws_region` | Région AWS actuelle |
| `data.terraform_remote_state` | Lire les sorties d'un autre fichier d'état |
| `data.external` | Exécuter un programme externe pour des données |

## Cycle de vie

### Règles de cycle de vie

```
resource "aws_instance" "web" {
  lifecycle {
    create_before_destroy = true
    prevent_destroy       = true
    ignore_changes        = [tags]
  }
}
```

### Options de cycle de vie

| Command | Description |
|---------|-------------|
| `create_before_destroy` | Créer le remplacement avant de détruire l'ancien |
| `prevent_destroy` | Erreur si `terraform destroy` cible cette ressource |
| `ignore_changes` | Ne pas détecter la dérive sur les attributs listés |
| `replace_triggered_by` | Forcer le remplacement quand la ressource référencée change |
| `precondition` | Valider les hypothèses avant l'application |
| `postcondition` | Valider les résultats après l'application |

## Modèles courants

### Boucles et conditions

```
# for_each with a map
resource "aws_iam_user" "users" {
  for_each = toset(["alice", "bob"])
  name     = each.value
}
# conditional resource
count = var.create_db ? 1 : 0
```

### Fonctions utiles

| Command | Description |
|---------|-------------|
| `file("key.pub")` | Lire le contenu d'un fichier |
| `join(", ", list)` | Joindre une liste en chaîne |
| `lookup(map, key, default)` | Recherche dans une map avec valeur par défaut |
| `length(list)` | Nombre d'éléments |
| `toset(["a", "b"])` | Convertir une liste en ensemble (pour for_each) |
| `try(expr, fallback)` | Retourner la valeur de repli si expr échoue |
| `templatefile(path, vars)` | Rendre un fichier template |