Terraform • Syspirit

Terraform est un outil d’infrastructure as code pour créer, modifier et versionner l’infrastructure de manière sécurisée et efficace sur tous les providers cloud.

🚀 Installation

📌 Plateforme	🧠 Commande
🐧 Ubuntu/Debian	`wget -O- https://apt.releases.hashicorp.com/gpg \| sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg`
🎩 CentOS/RHEL	`sudo yum install -y yum-utils && sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo`
🍺 macOS	`brew tap hashicorp/tap && brew install terraform`
🪟 Windows	`choco install terraform`
📦 Binary direct	Télécharger depuis releases.hashicorp.com

⚙️ Commandes essentielles

📌 Action	🧠 Commande	💡 Description
🏁 Initialiser	`terraform init`	Initialise le projet et télécharge les providers
📋 Planifier	`terraform plan`	Affiche les changements qui seront appliqués
✅ Appliquer	`terraform apply`	Applique les changements à l’infrastructure
💥 Détruire	`terraform destroy`	Supprime toutes les ressources gérées
🔍 Valider	`terraform validate`	Vérifie la syntaxe des fichiers
📊 État	`terraform show`	Affiche l’état actuel
🔄 Refresh	`terraform refresh`	Met à jour l’état avec la réalité

📊 Gestion de l’état

📌 Action	🧠 Commande
📋 Lister ressources	`terraform state list`
👁️ Voir une ressource	`terraform state show aws_instance.web`
🔄 Importer ressource	`terraform import aws_instance.web i-1234567890abcdef0`
🗑️ Supprimer du state	`terraform state rm aws_instance.web`
📍 Déplacer ressource	`terraform state mv aws_instance.web aws_instance.web2`
💾 Pull state	`terraform state pull`
📤 Push state	`terraform state push terraform.tfstate`

🎯 Options utiles

📌 Option	🧠 Exemple	💡 Usage
🎯 Target	`terraform apply -target=aws_instance.web`	Applique seulement à une ressource
🔄 Auto-approve	`terraform apply -auto-approve`	Pas de confirmation interactive
📁 Var-file	`terraform apply -var-file="prod.tfvars"`	Utilise un fichier de variables
🔧 Var	`terraform apply -var="instance_count=3"`	Passe une variable
💾 State	`terraform apply -state=custom.tfstate`	Utilise un fichier state custom
🗂️ Plan file	`terraform plan -out=plan.out`	Sauvegarde le plan

📝 Structure de fichiers

Organisation recommandée

terraform-project/
├── main.tf              # Configuration principale
├── variables.tf         # Déclaration des variables
├── outputs.tf          # Sorties
├── terraform.tfvars    # Valeurs des variables
├── versions.tf         # Versions providers
└── modules/            # Modules réutilisables
    ├── vpc/
    ├── ec2/
    └── rds/

Fichier main.tf exemple

terraform {
  required_version = ">= 1.0"
  required_providers {
    vsphere = {
      source  = "hashicorp/vsphere"
      version = "~> 2.0"
    }
  }
}
 
provider "vsphere" {
  user           = var.vsphere_user
  password       = var.vsphere_password
  vsphere_server = var.vsphere_server
  
  # Si certificat auto-signé
  allow_unverified_ssl = true
}
 
# Datasources pour récupérer les infos vSphere
data "vsphere_datacenter" "datacenter" {
  name = "Datacenter"
}
 
data "vsphere_datastore" "datastore" {
  name          = "datastore1"
  datacenter_id = data.vsphere_datacenter.datacenter.id
}
 
data "vsphere_compute_cluster" "cluster" {
  name          = "cluster1"
  datacenter_id = data.vsphere_datacenter.datacenter.id
}
 
data "vsphere_network" "network" {
  name          = "VM Network"
  datacenter_id = data.vsphere_datacenter.datacenter.id
}
 
data "vsphere_virtual_machine" "template" {
  name          = "ubuntu-20.04-template"
  datacenter_id = data.vsphere_datacenter.datacenter.id
}
 
# VM
resource "vsphere_virtual_machine" "web" {
  name             = "${var.vm_name}-web"
  resource_pool_id = data.vsphere_compute_cluster.cluster.resource_pool_id
  datastore_id     = data.vsphere_datastore.datastore.id
  
  num_cpus = 2
  memory   = 4096
  guest_id = data.vsphere_virtual_machine.template.guest_id
  
  scsi_type = data.vsphere_virtual_machine.template.scsi_type
  
  network_interface {
    network_id   = data.vsphere_network.network.id
    adapter_type = data.vsphere_virtual_machine.template.network_interface_types[0]
  }
  
  disk {
    label            = "disk0"
    size             = data.vsphere_virtual_machine.template.disks.0.size
    eagerly_scrub    = data.vsphere_virtual_machine.template.disks.0.eagerly_scrub
    thin_provisioned = data.vsphere_virtual_machine.template.disks.0.thin_provisioned
  }
  
  clone {
    template_uuid = data.vsphere_virtual_machine.template.id
    
    customize {
      linux_options {
        host_name = "${var.vm_name}-web"
        domain    = "example.com"
      }
      
      network_interface {
        ipv4_address = "192.168.1.100"
        ipv4_netmask = 24
      }
      
      ipv4_gateway = "192.168.1.1"
      dns_server_list = ["8.8.8.8", "8.8.4.4"]
    }
  }
}

Variables (variables.tf)

variable "vsphere_server" {
  description = "Serveur vCenter"
  type        = string
  default     = "vcenter.example.com"
}
 
variable "vsphere_user" {
  description = "Utilisateur vSphere"
  type        = string
}
 
variable "vsphere_password" {
  description = "Mot de passe vSphere"
  type        = string
  sensitive   = true
}
 
variable "vm_name" {
  description = "Nom de base des VMs"
  type        = string
  default     = "terraform-vm"
}
 
variable "vm_count" {
  description = "Nombre de VMs à créer"
  type        = number
  default     = 1
}

Outputs (outputs.tf)

output "vm_name" {
  description = "Nom de la VM créée"
  value       = vsphere_virtual_machine.web.name
}
 
output "vm_ip" {
  description = "IP de la VM"
  value       = vsphere_virtual_machine.web.default_ip_address
}
 
output "vm_uuid" {
  description = "UUID de la VM"
  value       = vsphere_virtual_machine.web.uuid
  sensitive   = false
}

📦 Modules

Créer un module

# modules/vm/main.tf
resource "vsphere_virtual_machine" "this" {
  name             = var.vm_name
  resource_pool_id = var.resource_pool_id
  datastore_id     = var.datastore_id
  
  num_cpus = var.num_cpus
  memory   = var.memory
  guest_id = var.guest_id
  
  network_interface {
    network_id = var.network_id
  }
  
  disk {
    label = "disk0"
    size  = var.disk_size
  }
  
  clone {
    template_uuid = var.template_uuid
    
    customize {
      linux_options {
        host_name = var.vm_name
        domain    = var.domain
      }
      
      network_interface {
        ipv4_address = var.ip_address
        ipv4_netmask = 24
      }
      
      ipv4_gateway = var.gateway
    }
  }
}
 
# modules/vm/variables.tf
variable "vm_name" {
  description = "Nom de la VM"
  type        = string
}
 
variable "num_cpus" {
  description = "Nombre de CPUs"
  type        = number
  default     = 2
}
 
variable "memory" {
  description = "Mémoire en MB"
  type        = number
  default     = 4096
}

Utiliser un module

module "web_server" {
  source = "./modules/vm"
  
  vm_name          = "web-01"
  resource_pool_id = data.vsphere_compute_cluster.cluster.resource_pool_id
  datastore_id     = data.vsphere_datastore.datastore.id
  network_id       = data.vsphere_network.network.id
  template_uuid    = data.vsphere_virtual_machine.template.id
  guest_id         = data.vsphere_virtual_machine.template.guest_id
  
  num_cpus    = 4
  memory      = 8192
  ip_address  = "192.168.1.101"
  gateway     = "192.168.1.1"
  domain      = "example.com"
}
 
# Référencer une sortie de module
output "web_server_ip" {
  value = module.web_server.ip_address
}

🎯 Bonnes pratiques

📌 Pratique	💡 Description
📁 Organisation	Séparer par environnement et services
🏷️ Tagging	Utiliser des tags cohérents partout
🔒 État distant	Toujours utiliser un backend distant
🔐 Secrets	Ne jamais hardcoder les secrets
📝 Documentation	Commenter et documenter le code
🧪 Validation	Tester avec `terraform plan`
📦 Modules	Réutiliser avec des modules
🔄 Versioning	Verrouiller les versions providers

🔍 Debugging & Troubleshooting

📌 Debug	🧠 Commande
🐛 Mode debug	`TF_LOG=DEBUG terraform apply`
📝 Logs détaillés	`TF_LOG=TRACE terraform plan`
🔍 Graph	`terraform graph \| dot -Tpng > graph.png`
✅ Format check	`terraform fmt -check -diff`
🔧 Format auto	`terraform fmt -recursive`

Recherche

➤Terraform

➤Terraform

🚀 Installation

⚙️ Commandes essentielles

📊 Gestion de l’état

🎯 Options utiles

📝 Structure de fichiers

Organisation recommandée

Fichier main.tf exemple

Variables (variables.tf)

Outputs (outputs.tf)

📦 Modules

Créer un module

Utiliser un module

🎯 Bonnes pratiques

🔍 Debugging & Troubleshooting

Articles liés

Sommaire