|
|
|
# Utilisation de la VM
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
La façon recommandée de simuler GestioCOF sur votre machine est d'utiliser [Vagrant](https://www.vagrantup.com/). Vagrant permet de créer une machine virtuelle minimale sur laquelle tournera GestioCOF; ainsi on s'assure que tout le monde à la même configuration de développement (même sous Windows !), et l'installation se fait en une commande.
|
|
|
|
|
|
|
|
Pour utiliser Vagrant, il faut le [télécharger](https://www.vagrantup.com/downloads.html) et l'installer.
|
|
|
|
|
|
|
|
Vagrant permet d'utiliser différents types de machines virtuelles; par défaut il utilise [Virtualbox](https://www.virtualbox.org/) qu'il vous faudra également [télécharger](https://www.virtualbox.org/wiki/Downloads) et installer.
|
|
|
|
|
|
|
|
L'installation est terminée.
|
|
|
|
|
|
|
|
## Utilisation
|
|
|
|
|
|
|
|
### Premier lancement
|
|
|
|
|
|
|
|
#### Machine virtuelle
|
|
|
|
|
|
|
|
Le lancement se fait avec la commande `vagrant up` dans le répertoire du dépot local.
|
|
|
|
|
|
|
|
À son premier lancement, Vagrant va télécharger une image d'Ubuntu ainsi que des mises à jour (il vaut mieux avoir une connexion Internet pas trop mauvaise)
|
|
|
|
|
|
|
|
#### Paquets Python
|
|
|
|
|
|
|
|
Pour mettre à jour les paquets Python, utiliser la commande suivante : `pip install --upgrade -r requirements.txt -r requirements-devel.txt`
|
|
|
|
|
|
|
|
Pour mettre à jour les modèles après une migration, il faut ensuite faire : `python manage.py migrate`
|
|
|
|
|
|
|
|
### Utilisations suivantes
|
|
|
|
|
|
|
|
Voici quelques commandes importantes pour gérer la machine virtuelle :
|
|
|
|
|
|
|
|
- `vagrant up` permet de lancer la machine virtuelle. Si une machine virtuelle existe déjà, elle sera réutilisée ; sinon, Vagrant va créer et configurer une nouvelle machine virtuelle pour vous.
|
|
|
|
|
|
|
|
- `vagrant suspend` permet de sauver l'état de la machine virtuelle sur le disque pour la relancer plus tard (y compris après un reboot) avec `vagrant up`
|
|
|
|
|
|
|
|
- `vagrant halt` permet d'éteindre la machine virtuelle (par comparaison avec `vagrant suspend`, cela prend moins de place sur le disque car il n'y a pas besoin de sauver la RAM, mais la recréation avec `vagrant up` sera plus lente)
|
|
|
|
|
|
|
|
- Enfin, `vagrant destroy` permet de détruire complètement la machine virtuelle : lors du prochain appel de `vagrant up`, elle sera réinstallée de zéro.
|
|
|
|
*Attention, contrairement aux deux méthodes précédentes, `vagrant destroy` détruira irrémédiablement le contenu de votre base de données locale, si elle vous est d'un quelconque intérêt, réfléchissez à deux fois !*
|
|
|
|
|
|
|
|
- `vagrant ssh` vous connecte en SSH à la machine virtuelle.
|
|
|
|
|
|
|
|
Une fois connecté en SSH, vous pouvez utiliser les commandes Django habituelles.
|
|
|
|
|
|
|
|
### Lancement du serveur
|
|
|
|
|
|
|
|
Par défaut Django n'écoute que sur l'adresse locale de la machine virtuelle - or vous voudrez accéder à GestioCOF depuis votre machine physique.
|
|
|
|
|
|
|
|
Pour lancer le serveur, il faut donc lancer la commande `python manage.py runserver 0.0.0.0:8000`.
|
|
|
|
|
|
|
|
**Le dossier avec le code est partagé entre la machine virtuelle et votre machine physique : vous pouvez donc utiliser votre éditeur favori pour coder depuis votre machine physique, et les changements seront répercutés automatiquement dans la machine virtuelle.** |
|
|
\ No newline at end of file |
