Développement & Tests

Vagrant

Pour créer rapidement une machine virtuelle sans avoir à réinstaller un serveur Lamp à chaque fois, pour développer ou pour tester.

Installer Vagrant, VirtualBox et Ansible

Sous Ubuntu 18.04 simplement avec cette commande sudo apt install vagrant virtualbox virtualbox-ext-pack ansible Pour les autres OS consultez la documentation de Vagrant, VirtualBox et Ansible.

Concernant Windows, Ansible n'est pas compatible. Peut être qu'en passant par WSL2 cela règle le soucis.

Installation

Cloner le projet git clone https://github.com/marsante/MedShakeEHR-vagrant.git
Créer un fichier secrets.yml à la racine du projet pour personnaliser les noms et mots de passes de la base de données comme dans l'exemple :

---
root_password: motdepasseroot
admin_account: nomdecompteadmin
admin_password: motdepasseadmin

Ouvrir un terminal à la racine du projet.
Taper la commande suivante vagrant up.
A la fin de l'exécution de la commande, ouvrir le navigateur se rendre à l'adresse suivante http://55.55.55.5/self-installer.php.
Vous pouvez finir la configuration de MedShakeEHR.
Le nom d'utilisateur et le mot de passe root qui vous seront demandés sont en fait le nom et mot de passe que vous avez rempli pour les variables admin_account: admin_password:

Déploiement avec https

Commencez par supprimer les fichiers du dossier cert rm templates/cert/*
Rendez-vous dans le dossier cert cd templates/cert
Tapez ces commandes :

domaine=msehr.local
openssl genrsa -out $domaine.key 2048
openssl req -new -key $domaine.key -out $domaine.csr
openssl x509 -req -days 3650 -in $domaine.csr -signkey $domaine.key -out $domaine.crt

Au cours de la procédure plusieurs questions vous seront posées, voici un exemple de réponse :

Country Name (2 letter code) : FR
State or Province Name : «Votre Département ou Région » Paris
Locality Name : «Votre ville» Paris
Organization Name : «Votre Raison Sociale» Cabinet Dr Strange
Organization Unit Name :«Votre unit» Direction
Common Name (e.g. server FQDN or your name) : msehr.local
Email Address : «adresse mail du webmaster» example@example.com
A challenge password : «Mot de passe Certificat» : supermotdepasselong
An optional company name :

Une fois la machine virtuelle lancée, rendez-vous dans votre navigateur à l'adresse https://55.55.55.5/self-installer.php

Modifications de la configuration

Pour arrêter la machine virtuelle taper vagrant halt.
Pour détruire les fichiers de la machine virtuelle taper vagrant destroy.
Vous pouvez modifier, les caractéristiques (ip, nombre de CPU, RAM, nom, distribution …etc) de votre machine virtuelle dans Vagrantfile.
Vous pouvez modifier l'approvisionnement de la machine virtuelle dans le fichier main.yml.
Vous pouvez modifier la configuration d'Apache via les fichiers de configurations placés dans le dossier templates.
Pour réapprovisionner la machine virtuelle avec les nouveaux paramètres taper vagrant provision.

Docker

Docker est un outil qui peut empaqueter une application et ses dépendances dans un conteneur isolé, qui pourra être exécuté sur n'importe quel serveur. Contrairement aux machines virtuelles traditionnelles, un conteneur Docker n'inclut pas de système d'exploitation, mais s'appuie au contraire sur les fonctionnalités du système d’exploitation fournies par la machine hôte. Une solution pertinente pour déployer une plateforme de développement avec une pile LAMP.

VM

Pour découvrir le logiciel sans l'étape de configuration et avec 3 modules installés, vous pouvez vous rendre sur cette page pour la télécharger et les consignes d'installation. Vous aurez besoin de VirtualBox et d'un gestionnaire d'archive compatible 7zip.

dev, tests, installation