====== 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.
<WRAP center round important 60%>
Concernant Windows, Ansible n'est pas compatible. Peut être qu'en passant par WSL2 cela règle le soucis.
</WRAP>
==== 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 : 
<code>
---
root_password: motdepasseroot
admin_account: nomdecompteadmin
admin_password: motdepasseadmin
</code>

  * 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 :
<code>
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
</code>

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

<WRAP center round info 60%>
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 : 
</WRAP>


  * 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 [[https://www.logiciel-cabinet-medical.fr/generalites/tester-medshakeehr.html|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.

{{tag>dev tests installation}}