diff --git a/HowtoVagrant.md b/HowtoVagrant.md index dd479f40..08413ab5 100644 --- a/HowtoVagrant.md +++ b/HowtoVagrant.md @@ -62,6 +62,7 @@ Stopper la box : $ vagrant halt test_vagrant ~~~ + ## Fonctionnement ### Boxes @@ -94,30 +95,25 @@ Les boxes et les images `QCOW2` du provider `libvirt` sont stockées par défaut Par défaut, le volume de stockage est une image au format `QCOW2`, ce qui éviter d'avoir à réserver de l'espace disque. -## Syntaxe - Configuration d'un environnement avec le `Vagrantfile` +## Syntaxe de Vagrant -Le `Vagrantfile` est unique à un projet et doit être situé dans le répertoire racine de ce dernier. +On configure un environnement Vagrant, constitué d'une ou plusieurs boxes, avec un fichier `Vagrantfile`. -Il est écrit en Ruby et décrit le type de machine à démarrer, leurs spécifications et leur configuration initiale (provision). +On peut avoir autant d'environnements qu'on souhaite, tant qu'ils sont dans des répertoires distincts. -Pour vérifier la validité de votre `Vagrantfile` : +Le `Vagrantfile` peut notamment être partagé dans le dépôt d'un projet et permet d'avoir un environnement de test reproductible pour tous les usagers du dépôt. + +La syntaxe est en Ruby et décrit le type de machine à démarrer, leurs spécifications et leur configuration initiale (provision). + + +### Vérifier la validité d'un `Vagrantfile` + +Se positionner dans le répertoire où se trouve le `Vagrantfile` : ~~~ $ vagrant validate ~~~ -Pour éviter que Vagrant crée par défaut un partage NFS, la configuration doit contenir : - -~~~ -config.vm.synced_folder "./", "/vagrant", disabled: true -~~~ - -Sinon, on rencontre l'erreur : - -~~~ -It appears your machine doesn't support NFS, or there is not an adapter to enable NFS on this machine for Vagrant. Please verify that `nfsd` is installed on your machine, and try again. If you're on Windows, NFS isn't supported. If the problem persists, please contact Vagrant support. -~~~ - ### Exemple de `Vagrantfile` avec VirtualBox et provisionnement Ansible @@ -375,6 +371,21 @@ vagrant provision ## FAQ +### Désactiver le partage NFS + +Pour éviter que Vagrant ne crée par défaut un partage NFS, le `Vagrantfile` doit contenir : + +~~~ +config.vm.synced_folder "./", "/vagrant", disabled: true +~~~ + +Sinon, au lancement, on rencontre l'erreur : + +~~~ +It appears your machine doesn't support NFS, or there is not an adapter to enable NFS on this machine for Vagrant. Please verify that `nfsd` is installed on your machine, and try again. If you're on Windows, NFS isn't supported. If the problem persists, please contact Vagrant support. +~~~ + + ### Configurer localement le provider par défaut Si le `Vagrantfile` de l'environnement est partagé entre plusieurs utilisateurs, ceux-ci peuvent souhaiter utiliser différents providers.