Installer Terraform

Ce guide vous permet d’avoir Terraform opérationnel sur Linux en moins de cinq minutes. Il couvre quatre méthodes d’installation avec une recommandation claire selon votre contexte. À la fin, vous lancerez terraform version et serez prêt à déployer votre première infrastructure.

La version de référence utilisée sur ce site est Terraform 1.14.x.

Ce que vous allez apprendre

• Choisir la bonne méthode : mise, tfenv, paquet système ou binaire direct
• Installer via mise : la méthode recommandée pour gérer plusieurs versions
• Vérifier l’installation : terraform version et les variables d’environnement utiles
• Configurer le cache des providers : éviter de retélécharger à chaque projet

Choisir sa méthode d’installation

Méthode	Avantage	Cas d’usage
mise	Multi-versions, intégration mise.toml	DevOps, projets multiples
tfenv	Dédié Terraform, léger	Terraform uniquement
Paquet système	Officiel HashiCorp (apt/dnf) ou dépôt distro	Serveur stable, CI/CD
Binaire direct	Aucune dépendance	Environnement minimal

Glissez pour voir

Méthode 1 — mise (recommandée)

mise est un gestionnaire de versions polyvalent qui remplace nvm, rbenv, pyenv et tfenv en un seul outil.

1. Installer mise

   curl https://mise.run | sh
   echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
   source ~/.bashrc

2. Installer Terraform via mise

   # Dernière version stable
   mise use --global terraform@latest
   
   # Version précise (recommandée pour la reproductibilité)
   mise use --global terraform@1.14.8

3. Vérifier l’installation

   terraform version

   Résultat attendu :

   Terraform v1.14.8
   on linux_amd64

4. Épingler la version par projet

   Dans le répertoire de votre projet Terraform :

   mise use terraform@1.14.8

   Cela crée ou met à jour un fichier mise.toml dans le répertoire courant :

   [tools]
   terraform = "1.14.8"

   Tout collaborateur avec mise installé utilisera automatiquement la même version.

   mise.toml vs .tool-versions

   mise utilise mise.toml comme format par défaut. Il sait aussi lire les fichiers .tool-versions (format hérité de asdf), mais ne les crée plus par défaut.

Méthode 2 — tfenv

tfenv est un gestionnaire de versions dédié à Terraform, léger et simple.

1. Installer tfenv

   git clone --depth=1 https://github.com/tfutils/tfenv.git ~/.tfenv
   echo 'export PATH="$HOME/.tfenv/bin:$PATH"' >> ~/.bashrc
   source ~/.bashrc

2. Lister les versions disponibles

   tfenv list-remote | head -20

3. Installer et activer une version

   tfenv install 1.14.8
   tfenv use 1.14.8

4. Vérifier

   terraform version

5. Épingler par projet

   echo "1.14.8" > .terraform-version

   tfenv utilisera automatiquement cette version dans ce répertoire.

Méthode 3 — Paquet système

Ubuntu / Debian

# Ajouter le dépôt officiel HashiCorp
wget -O - https://apt.releases.hashicorp.com/gpg | \
  sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] \
  https://apt.releases.hashicorp.com $(lsb_release -cs) main" | \
  sudo tee /etc/apt/sources.list.d/hashicorp.list

sudo apt update && sudo apt install terraform

RHEL / CentOS

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
sudo yum install terraform

Fedora

sudo dnf install -y dnf-plugins-core
sudo dnf config-manager addrepo \
  --from-repofile=https://rpm.releases.hashicorp.com/fedora/hashicorp.repo
sudo dnf install terraform

Arch Linux

sudo pacman -S terraform

Paquet non officiel HashiCorp

Sur Arch, le paquet terraform provient du dépôt Extra de la distribution, pas d’un dépôt maintenu par HashiCorp.

Mise à jour automatique

Avec le package système, apt upgrade ou dnf upgrade peut mettre à jour Terraform à une version majeure non planifiée. Pour les projets en production, préférez mise ou tfenv qui fixent la version explicitement.

Méthode 4 — Binaire direct (sans dépendances)

# Télécharger le binaire (adapter la version)
VERSION="1.14.8"
curl -Lo terraform.zip \
  "https://releases.hashicorp.com/terraform/${VERSION}/terraform_${VERSION}_linux_amd64.zip"

# Extraire et installer
unzip terraform.zip
sudo mv terraform /usr/local/bin/
rm terraform.zip

terraform version

Vérifiez l'intégrité du binaire

HashiCorp publie les checksums SHA256 et une signature GPG pour chaque release. Pour une installation manuelle, vérifiez les checksums et la signature avant d’installer le binaire. Les fichiers sont disponibles sur releases.hashicorp.com.

Vérifier l’installation

Quelle que soit la méthode, vérifiez que Terraform est accessible :

terraform version

Résultat attendu :

Terraform v1.14.8
on linux_amd64

Vérifiez aussi que l’autocomplétion fonctionne :

terraform -install-autocomplete
source ~/.bashrc

Configurer le répertoire de cache des providers

Par défaut, Terraform télécharge les providers dans .terraform/ de chaque projet. Pour éviter de re-télécharger à chaque init, configurez un cache global :

mkdir -p ~/.terraform.d/plugin-cache

Créez ou modifiez ~/.terraformrc :

plugin_cache_dir = "$HOME/.terraform.d/plugin-cache"

Alternativement, vous pouvez définir la variable d’environnement TF_PLUGIN_CACHE_DIR au lieu de modifier ~/.terraformrc :

export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache"

Cette configuration réduit significativement le temps d’init sur des projets multiples.

Cache et exécutions concurrentes

Le cache des providers n’est pas conçu pour des terraform init concurrents partageant le même répertoire de cache. En CI/CD parallélisée, chaque job doit avoir son propre cache ou ne pas utiliser de cache partagé.

Désinstaller Terraform

mise

mise uninstall terraform@1.14.8

tfenv

tfenv uninstall 1.14.8

Package système

sudo apt remove terraform
# ou
sudo dnf remove terraform

À retenir

• mise est la méthode recommandée pour les environnements DevOps : elle gère plusieurs versions en parallèle et épingle la version par projet via mise.toml.
• Épingler la version est une bonne pratique : tous les membres de l’équipe utilisent alors la même version.
• Le cache des providers (plugin_cache_dir ou TF_PLUGIN_CACHE_DIR) accélère les inits, mais ne supporte pas les exécutions concurrentes.
• Pour une installation par binaire direct, vérifiez les checksums SHA256 et la signature GPG.
• Terraform 1.14.x est la version de référence utilisée sur ce site.

Prochaines étapes

Providers, resources et data sources Les trois briques de base de tout projet Terraform : provider, resource et data source.

Structure d'un projet Terraform Comment organiser ses fichiers .tf dès le premier projet.

La CLI Terraform Toutes les commandes Terraform avec leurs options et cas d'usage.

×

📖 Voir la documentation →