Skip to content

Le fonctionnement de Vagrant

Vagrant est un logiciel anciennement libre et open-source pour la création et la configuration des environnements de développement virtuels. Il peut être considéré comme un wrapper autour de logiciels de virtualisation comme VirtualBox. Depuis la version 1.1, Vagrant n'impose plus VirtualBox, mais fonctionne également avec d'autres logiciels de virtualisation tels que VMware. Depuis la version 1.62 Vagrant prend nativement en charge les conteneurs Docker à l'exécution, au lieu d'un système d'exploitation entièrement virtualisé. Cela permet de réduire la charge en ressources puisque Docker utilise des conteneurs Linux légers.

Les "box":

Vagrant utilise des "box" qui fonctionne comme un registry, c'esy-à'dire qu'au lieu de repartir de 0 en recréant une machine de A à Z il va chercher dans les différentes "box dans le catalogue d'HashiCorp.

Fichiers synchronisé : Vagrant synchronise automatiquement les fichiers vers et depuis la machine invitée.

Le partage d'environnement :

Vagrant Share est un plugin qui vous permet de partager l'environnement Vagrant avec n’importe qui autour de la monde entier avec une connexion Internet. Il vous donnera une URL qui sera acheminée directement à votre environnement Vagrant à partir de n’importe quel appareil dans le monde connecté à Internet.

Les providers

Un provider est l'emplacement dans lequel l'environnement virtuel s'exécute. Il peut être local (la valeur par défaut est d'utiliser VirtualBox) ou distant.

Les provisions / Aprovisionement

Un approvisionneur est un outil pour configurer l'environnement virtuel. Il peut être aussi simple qu'un script shell, mais en variante, un outil plus avancé comme Chef, Puppet ou Ansible peut être utilisé.

Les approvisionneurs de Vagrant vous permettent d'installer automatiquement des logiciels, de modifier les configurations et plus encore sur la machine dans le processus de démarrage.

Prérequis

Pour utiliser vagrant, il faut avoir des moyens de virtualisations sur son PC tel que :

  • HyperV
  • VirtualBox
  • Docker

Activer HyperV en commande powershell

nable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Installation de Vagrant

Tout d'abord, il faudra vous rendre sur le site de vagrant

Il faudra choisir le packages correspondant a votre système d'exploitation (MacOs,Windows,Linux)

exemple de packages

Plus qu'a télécharger !!

Crée son environemment

Tout d'abord créé un dossier dans l'emplacement de votre choix

Ensuite il vous faudra ouvrir un invite de commande et se positionner sur le dossier crée

Une fois cela fait il faudra fait la commande suivante : 


vagrant init

Cette commande va ainsi vous créer un fichier VagrantFile qui va vous permettre de génerer et gérer vos vm dans votre environnement

Le fichier Vagrantfile

Ce fichier va vous permettre de configurer votre environnement

Ceci est un exemple de fichier que j'ai pu réaliser :

# -*- mode: ruby -*-
# vi: set ft=ruby :

require 'yaml'

# Chargez les informations depuis le fichier config.yml
config_data = YAML.load_file('config.yml')

Vagrant.configure("2") do |config|
  config.vm.box = "generic/ubuntu2204"



  config.vm.define 'srv-test' do |node|
    node.vm.hostname = 'srv-test'
  end


    # Spécifie le fournisseur pour la machine virtuelle (Hyper-V)
    config.vm.provider "hyperv" do |h|
      h.vmname = "srv-test"
      h.enable_virtualization_extensions = true
      h.linked_clone = true

    end

    # Configuration du proxy pour l'environnement
    config.proxy.http     = "http://172.16.20.90:8080"
    config.proxy.https    = "http://172.16.20.90:8080"
    config.proxy.no_proxy = "localhost,127.0.0.1"

    # Provisionnement en utilisant un script shell directement dans le Vagrantfile
    config.vm.provision "shell", inline: <<-SHELL
      echo "nameserver 172.16.20.160" | sudo tee /etc/resolv.conf
      echo "nameserver 172.16.20.18" | sudo tee -a /etc/resolv.conf
    SHELL

    # Script d'installation d'Ansible
    config.vm.provision "shell", inline: <<-SHELL

      # Mise à jour de la liste des dépôts APT
      sudo apt update

      # Installation de software-properties-common pour gérer les dépôts
      sudo apt install -y software-properties-common

      # Ajout du repository Ansible
      sudo apt-add-repository --yes --update ppa:ansible/ansible

      # Installation d'Ansible
      sudo apt install -y ansible
    SHELL

end

Quelques manipulations avant de lancer votre fichier si besoin !

Configuration Proxy

Le proxy risque de vous pose problèmes pour aller chercher des box, ou faire des apt-update etc...

C'est pour cela qui faudra effectuer quelques commandes avant de lancer votre environnement :

Tout d'abord il faudra que vous ouvrez un cmd en admin

et ensuite faire c'est trois commandes :


set http_proxy=ADRESSE PROXY

set https_proxy=ADRESSE PROXY

vagrant plugin install vagrant-proxyconf

Si vous voyez ceci s'afficher c'est que c'est bon !!

Conf fichier.yml

Comme vous le voyez il y a des variables pour le partage de fichier ceci permet a vagrant d'accèder a nos fichiers sauf qu'il faut mettre notre login P@ssword en clair ce qui n'est pas une bonne pratiques. C'est pour cela qui vous faudra crée des variables ainsi que ce fichier

Il faudra créer un fichier yml dans votre dossier d'environnement

Voici la configuration : 


# config.yml
smb_username: "votre User"
smb_password: "Votre P@ssword"

Ainsi le fichier Vagrantfile ira chercher les valeurs des variables qu'on lui a mis pour la partage de fichier

Lancement de votre environnement

Quand tout cela est effectué vous pourrez lancer votre environnement

Il faudra bien sur être encore positionner dans le dossier crée auparavant

Pour cela il vous faudra utlisé cette commande 


vagrant up

Si vous avez des scripts dans votre VagrantFile utilisé plutôt cette commande : 


vagrant up --provision

Une fois cette commande effectué vous devrez attendre que le fichier génére la vm.

Ensuite aller dans votre outil de virtualisation utilisé et si tout ce passe bien vous devriez apercevoir votre machine.

Connecter la VM en ssh sur Vscode

Pour cela ouvrez un invite de commande et placer vous dans dossier d'environnement

Ensuite faite cette commande : 


vagrant ssh-config

Vous aurez ceci : ssh-config

Ensuite allez sur Vscode et installer l'extension Remote Development

remote-connection

Une fois installer vous aurez cette petite icône apparaitre en bas a gauche de votre écran

icône-ssh

Cliquez dessus et selectionner Connect To Host

Ensuite cliquez sur Configure SSH Hosts

Ensuite cliquer sur votre fichier ssh-config

Puis copier toutes les informations que vous avez récolté en faisant la commande sur le fichier 


vagrant ssh-config

Sa devrait vous donner ceci :

config-ssh

Important sur la ligne Hostname remplacer l'ip par le nom de votre machine !!!!

Une fois fini Cliquez sur l'icône remote et selectionner Connect To Host

Ensuite vous verrez le nom de votre machine, cliquez dessus et vous serrez connecté en ssh sur votre vm.

Installer des paquets automatiquement

Prenons l'exemple du paquet ansible

Il faudra rajouter ceci dans votre VagrantFile :


 # Script d'installation d'Ansible
    config.vm.provision "shell", inline: <<-SHELL

      # Mise à jour de la liste des dépôts APT
      sudo apt update

      # Installation de software-properties-common pour gérer les dépôts
      sudo apt install -y software-properties-common

      # Ajout du repository Ansible
      sudo apt-add-repository --yes --update ppa:ansible/ansible

      # Installation d'Ansible
      sudo apt install -y ansible
    SHELL

Si vous avez déja une vm faites la commande : 


vagrant reload --provision

Si c'est votre premier lancement faites : 


vagrant up --provision

Pour vérifier que le script fonctionne connecter sur votre vm et faites :


ansible --version

Les commandes utiles

vagrant init : crée un fichier Vagrantfile dans le répertoire courant. Ce fichier contient la configuration de la Vagrant Box à utiliser. Tu peux utiliser cette commande pour créer un nouveau projet Vagrant.

vagrant up : démarre la Vagrant Box. Si la box n’est pas encore installée, Vagrant la téléchargera et la configura avant de la démarrer.

vagrant ssh: se connecte à la Vagrant Box en utilisant SSH. Tu peux utiliser cette commande pour accéder à la console de la box et exécuter des commandes sur le système d’exploitation de la box.

vagrant halt : arrête la Vagrant Box. Tu peux utiliser cette commande pour mettre la box en pause ou pour l’arrêter complètement.

vagrant destroy : supprime la Vagrant Box. Cette commande arrête la box et la supprime de ta machine. Tu peux utiliser cette commande pour nettoyer ton environnement de développement

Vagrant reload : redémarrer l'environnement

vagrant ssh-config : accèder a la conf ssh de la vm

vagrant up --provision : lancer les scripts mis dans le vagrantfile au lancement de la vm