Aller au contenu

Installation projet

Dépôt Git

git clone git@github.com:Efalia/mgx.git

cd mgx/

Installation de la Vagrant

vagrant up

Une fois fini, vous pouvez y accéder via :

vagrant ssh
Bug

Si vous avez des problèmes avec la box :

sudo rm /opt/vagrant/embedded/bin/curl

Accès au serveur web

Avec le provider Docker (par défaut), il est nécessaire de modifier votre fichier /etc/hosts pour y ajouter le nom de domaine mgx.loc pointant vers 127.0.0.1.

/etc/hosts
- 127.0.0.1 localhost
+ 127.0.0.1 localhost mgx.loc

Une fois les étapes précédentes terminées, vous devriez avoir accès dans votre navigateur à :

Bug

Si vous avez des problèmes de DNS, videz votre cache DNS.

Accès en HTTPS

Voir la documentation SSL dédiée.

Personnalisation de la Vagrant

Les ressources utilisées par la Vagrant sont configurées dans le fichier Vagrantfile. Vous pouvez les modifier en créant le fichier Vagrantfile.local (1) et en y spécifiant les variables que vous souhaitez modifier.

  1. Ce fichier ne peut pas être commité dans le projet.

Une fois votre fichier créé, pour appliquer ces changements :

vagrant halt --force
vagrant destroy --force
vagrant up
Example

Pour ne plus avoir à saisir les identifiants pour le partage SMB sous Windows vous pouvez utiliser :

Vagrantfile.local
Vagrant.configure('2') do |config|
    config.vm.provider "hyperv" do |h, override|
        override.vm.synced_folder '.', '/vagrant', type: 'smb', smb_username: 'identifiant_a_remplacer', smb_password: 'motdepasse_a_remplacer', mount_options: ['mfsymlinks', 'forceuid', 'noperm', 'file_mode=0777', 'dir_mode=0777', 'vers=3.0']
    end
end

Si vous êtes sur un domaine, le smb_username devra être de la forme identifiant@domaine Note supplémenataire : L'information ci-dessus est peut-etre toujours d'actualité dans certains cas, cependant, lors de nos tests récents, nous avons dû utiliser une autre notation de type domaine\identifiant (ex: efalia\mdespesse). Le mount a alors également nécessité l'ajout de ces paramètres dans les mount_options: 'username=mdespesse', 'domain=efalia'

Sous windows, l'utilisation de Virtualbox peut amener à des soucis de type A host only network interface you're attempting to configure via DHCP already has a conflicting host only adapter with DHCP enabled. Pour les fixer, il est également possible d'ajouter cette fonction dans le vagrantfile.local

class VagrantPlugins::ProviderVirtualBox::Action::Network
  def dhcp_server_matches_config?(dhcp_server, config)
    true
  end
end