
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, verifier que la commande fonctionne et s’assurer que votre environnement est pret. La version utilisee dans les exemples de cette section est Terragrunt 1.0.0.
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »- Installer Terragrunt avec mise en quelques commandes
- Verifier que l’outil fonctionne correctement sur votre poste
- Comprendre pourquoi Terragrunt a aussi besoin de Terraform ou OpenTofu
- Preparer votre environnement pour les exercices pratiques qui suivent
Ce que vous installez exactement
Section intitulée « 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 executent le vrai
plan,applyetdestroy.
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 deja fait
Section intitulée « Etape 1 : installer mise si ce n’est pas deja fait »Si mise est deja installe sur votre poste, passez directement a l’etape 2. Sinon, prenez la variante correspondant a votre shell.
curl https://mise.run | shecho 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrcsource ~/.bashrccurl https://mise.run | shecho 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrcsource ~/.zshrcVerification :
mise --versionLa commande doit afficher un numero de version, pas une erreur command not found.
Etape 2 : tester Terragrunt sans rien installer globalement
Section intitulée « Etape 2 : tester Terragrunt sans rien installer globalement »Avant d’ecrire quoi que ce soit dans votre configuration globale, vous pouvez verifier que Terragrunt fonctionne avec un test ponctuel :
mise x terragrunt@1.0.0 -- terragrunt --versionVerification : 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 recuperer l’outil ;
- Terragrunt s’execute correctement sur votre poste.
Etape 3 : installer Terragrunt de facon persistante
Section intitulée « Etape 3 : installer Terragrunt de facon persistante »Quand le test ponctuel passe, vous pouvez installer la version retenue dans votre configuration globale mise :
mise use -g terragrunt@1.0.0terragrunt --versionVerification : la deuxieme commande doit afficher terragrunt version v1.0.0.
Etape 4 : verifier aussi l’engine IaC
Section intitulée « Etape 4 : verifier aussi l’engine IaC »Les guides Terragrunt de cette section s’appuient sur OpenTofu ou Terraform. Verifiez qu’au moins un des deux est disponible :
tofu --versionou :
terraform --versionVerification : au moins une des deux commandes doit afficher une version.
Check rapide avant le premier exercice
Section intitulée « Check rapide avant le premier exercice »Avant de passer au premier guide pratique, vous devez pouvoir confirmer ceci :
mise --versionfonctionne ;terragrunt --versionfonctionne ;tofu --versionouterraform --versionfonctionne ;- vous savez quel shell vous utilisez, donc quel fichier de configuration vous rechargez.
Erreurs frequentes
Section intitulée « Erreurs frequentes »| Symptome | 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 apres mise use -g | Le shell n’a pas recharge l’activation de mise | Recharger le shell puis relancer terragrunt --version |
tofuouterraformintrouvable | L’engine IaC n’est pas installe | Installer OpenTofu ou Terraform avant de commencer les exercices | | Mauvaise version de Terragrunt | Une autre version est deja presente sur le PATH | Verifier la sortie deterragrunt --versionet harmoniser la version via mise |
A retenir
Section intitulée « A retenir »- La methode retenue ici pour installer Terragrunt est mise.
- La version utilisee 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 reussi est toujours
terragrunt --version.