Amélioration section syntaxe

This commit is contained in:
whirigoyen 2024-01-15 18:15:37 +01:00
parent a7b33fd59d
commit 2f647f9809

View file

@ -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.