Vagrant

Pour initialiser un dossier, vous devez sélectionner le dossier et exécuter la commande vagrant init. Un fichier nommé "Vagrantfile" est généré et placé dans le dossier des exemples et des explications. En ajoutant vagrant init --minimal une version minimale des Vagrantfiles est générée sans exemple, ni explication.

La commande vagrant init prend deux paramètres optionnels vagrant init [box-name] [box-url]. En spécifiant un "box-name" on génère un Vagrantfile depuis un modèle approprié ("Box"). L'option "box-url" est l'URL indiquée où la "Box" peut être téléchargée. Ces informations peuvent également être configurées dans le Vagrantfile.

Ce fichier peut ensuite être modifié avec n'importe quel éditeur de texte.

Les Box sont des machines virtuelles préconfigurées (templates). Cela devrait accélérer le processus de développement et la distribution de logiciels. Chaque box qui a été utilisée par l'utilisateur est stockée sur l'ordinateur et n'a donc pas besoin d'être re-téléchargée depuis Internet. Les boîtes peuvent être ajoutées via les commandes vagrant box add [box-name] et vagrant box add [box-url]. On supprime une boîte au moyen de la commande vagrant box remove [box-name]. Un "box-name" est constuit, par convention, comme suit : "développeur / Box", par exemple "hashicorp/precise32". Vagrant Cloud sert de plateforme d'échange pour trouver des boîtes et y déposer ses propres boîtes.

Exemple de démarrage rapide:

# on recupere un vagrantfile definissant la box
vagrant init "ubuntu/xenial64"
# on crée la machine avec virtualbox
vagrant up --provider=virtualbox
# on se connecte à la machine en ssh
vagrant ssh

# on detruit la box
vagrant destroy

Toute la configuration se fait dans un Vagrantfile. La syntaxe est similaire à Ruby.

Un exemple de syntaxe:

Vagrant.configure("2") do |config|
  config.vm.box = "hashicorp/precise32"
end

Avec Vagrant, il est possible d'utiliser les outils de Provisioning suivants : File, Shell, Ansible, CFEngine, Chef Solo, Chef Client, Docker, Puppet Apply, Puppet Agent et Salt.

Exemple de syntaxe:

Vagrant.configure("2") do |config|
 config.vm.box = "hashicorp/precise32"
 config.vm.provision "shell", path: "script.sh"
end

Ceci résulte du script shell "script.sh".

Une variété d'approvisionneur peut être exécutée dans un fichier. Exemple de syntaxe utilisant plusieurs approvisionneurs :

Vagrant.configure("2") do |config|
 config.vm.box = "hashicorp/precise32"
 config.vm.provision "shell", path: "script.sh"
 config.vm.provision "file", source: "~/.gitconfig", destination: ".gitconfig"
 config.vm.provision "ansible" do |ansible|    ansible.playbook = "playbook.yml"
 end
end

Depuis la version 1.7 de décembre 2014 le déploiement en utilisant la commande vagrant push par Heroku, SFTP et FTP, en écrivant vos propres scripts de ligne de commande est possible.

Exemple de syntaxe d'une poussée de FTP:

config.push.define "ftp" do |push|
 push.host = "ftp.test.com"
 push.username = "utilisateur1"
 push.password = "mot de passe"
 push.secure = false
 push.destination = "/"
 push.dir = "/"
end

Cette section montre un exemple utilisant le protocole FTP sur le serveur avec l'adresse "ftp.test.com" avec l'utilisateur "user1" et le mot de passe "password1". push.secure indique si le protocole SFTP doit être utilisé, par défaut il est a false. push.destination contient le chemin de destination (sur le serveur), où les fichiers doivent être envoyés, push.dir contient le chemin local pour les fichiers à télécharger. Tous les chemins sont liés au Vagrantfile. Des fichiers et des dossiers peuvent être exclus avec exclude ou inclus avec include.

Pour démarrer la machine virtuelle, on utilise la commande vagrant up. Puis une session SSH peut être démarrée avec vagrant ssh.

La machine virtuelle peut être terminée de différente manière. La machine peut-être intégralement supprimée avec toutes ses dépendances via la commandevagrant destroy. On peut également l’arrêter via la commande vagrant halt ou la suspendre avec vagrant suspend. Il est aussi possible de la redémarrer avec vagrant reload.

Avec Vagrant, plusieurs machines virtuelles peuvent fonctionner simultanément, leurs statuts peuvent être consultés avec la commande vagrant global-status.