Installer Terragrunt avec mise

Vous voulez utiliser Terragrunt sur votre poste mais vous ne l'avez pas encore installe ? Cette page va droit au but : installer Terragrunt avec mise, vérifier que la commande fonctionne et s'assurer que votre environnement est prêt. La version utilisée dans les exemples de cette section est Terragrunt 1.0.0.

Ce que vous allez apprendre

• Installer Terragrunt avec mise en quelques commandes
• Vérifier que l'outil fonctionne correctement sur votre poste
• Comprendre pourquoi Terragrunt a aussi besoin de Terraform ou OpenTofu
• Préparer votre environnement pour les exercices pratiques qui suivent

Pourquoi cette méthode ?

mise est un gestionnaire de versions d'outils simple et rapide. Il permet de fixer la version exacte de Terragrunt a utiliser, ce qui évite les surprises entre postes de développement.

Ce que vous installez exactement

Terragrunt n'est pas le moteur qui cree les ressources. C'est une couche qui pilote Terraform ou OpenTofu. Il faut donc retenir ceci :

• Terragrunt orchestre les modules et les units ;
• Terraform ou OpenTofu exécutent le vrai plan, apply et destroy.

Autrement dit, installer Terragrunt seul ne suffit pas pour suivre toute la section. Il faudra aussi avoir OpenTofu ou Terraform disponible.

Etape 1 : installer mise si ce n'est pas déjà fait

Si mise est déjà installe sur votre poste, passez directement a l'étape 2. Sinon, prenez la variante correspondant a votre shell.

Bash

sudo apt install -y extrepo && sudo extrepo enable mise
sudo apt update && sudo apt install -y mise
echo 'eval "$(mise activate bash)"' >> ~/.bashrc
source ~/.bashrc

Zsh

sudo apt install -y extrepo && sudo extrepo enable mise
sudo apt update && sudo apt install -y mise
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
source ~/.zshrc

Verification :

mise --version

La commande doit afficher un numéro de version, pas une erreur command not found.

Etape 2 : tester Terragrunt sans rien installer globalement

Avant d'écrire quoi que ce soit dans votre configuration globale, vous pouvez vérifier que Terragrunt fonctionne avec un test ponctuel :

mise x terragrunt@1.0.0 -- terragrunt --version

Verification : la sortie attendue est terragrunt version v1.0.0.

Cette etape est utile parce qu'elle valide tout de suite deux choses :

• mise sait bien récupérer l'outil ;
• Terragrunt s'exécute correctement sur votre poste.

Etape 3 : installer Terragrunt de façon persistante

Quand le test ponctuel passe, vous pouvez installer la version retenue dans votre configuration globale mise :

mise use -g terragrunt@1.0.0
terragrunt --version

Verification : la deuxième commande doit afficher terragrunt version v1.0.0.

Si la commande terragrunt n'est toujours pas trouvee

Le problème vient souvent du shell qui n'a pas recharge l'activation de mise. Ouvrez un nouveau terminal ou rechargez votre fichier ~/.bashrc ou ~/.zshrc selon votre shell.

Etape 4 : vérifier aussi l'engine IaC

Les guides Terragrunt de cette section s'appuient sur OpenTofu ou Terraform. Vérifiez qu'au moins un des deux est disponible :

tofu --version

ou :

terraform --version

Verification : au moins une des deux commandes doit afficher une version.

Check rapide avant le premier exercice

Avant de passer au premier guide pratique, vous devez pouvoir confirmer ceci :

• mise --version fonctionne ;
• terragrunt --version fonctionne ;
• tofu --version ou terraform --version fonctionne ;
• vous savez quel shell vous utilisez, donc quel fichier de configuration vous rechargez.

Erreurs fréquentes

Symptôme	Cause probable	Solution
mise: command not found	mise n'est pas encore active dans le shell	Recharger ~/.bashrc ou ~/.zshrc, ou ouvrir un nouveau terminal
terragrunt: command not found après mise use -g	Le shell n'a pas recharge l'activation de mise	Recharger le shell puis relancer terragrunt --version

Glissez pour voir

• tofu ou terraform introuvable | L'engine IaC n'est pas installe | Installer OpenTofu ou Terraform avant de commencer les exercices | | Mauvaise version de Terragrunt | Une autre version est déjà presente sur le PATH | Vérifier la sortie de terragrunt --version et harmoniser la version via mise |

A retenir

• La méthode retenue ici pour installer Terragrunt est mise.
• La version utilisée dans cette section est Terragrunt 1.0.0.
• Vous pouvez tester l'outil sans installation globale avec mise x ....
• Pour suivre les exercices, il faut aussi OpenTofu ou Terraform.
• Le premier vrai test réussi est toujours terragrunt --version.

Prochaine étape

Premier projet Terragrunt Passer ensuite a un premier unit minimal pour vérifier que votre installation sert vraiment a quelque chose.

×

📖 Voir la documentation →