gestioCOF/README.md

95 lines
4 KiB
Markdown
Raw Normal View History

2016-05-24 09:35:55 +02:00
# GestioCOF
## Installation
### Vagrant
La façon recommandée d'installer 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.
Si vous êtes sous Linux, votre distribution propose probablement des paquets
Vagrant dans le gestionnaire de paquets (la version sera moins récente, ce qui
peut parfois poser des problèmes de compatibilité).
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 installer.
Une fois ces dépendances installées voici quelques commandes importants 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, dans le dossier
où est installé GestioCOF. Vous pouvez utiliser les commandes Django
habituelles (`manage.py runserver` etc.); toutefois pour lancer le serveur il faut faire
python manage.py runserver 0.0.0.0:8000
car 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.
**Le dossier avec le code de GestioCOF est partagé entre la machine virtuelle
et votre machine physique : vous pouvez donc utiliser votre éditeur favori pour
coder depuis l'extérieur de la machine virtuelle, et les changements seront
répercutés dans la machine virtuelle.**
### Installation manuelle
Si vous optez pour une installation manuelle plutôt que d'utiliser Vagrant, il
est fortement conseillé d'utiliser un environnement virtuel pour Python.
Il vous faudra installer mercurial, pip, les librairies de développement de
python, ainsi qu'un client et un serveur MySQL ; sous Debian et dérivées (Ubuntu, ...) :
sudo apt-get install mercurial python-pip python-dev libmysqlclient-dev mysql-server
Si vous décidez d'utiliser un environnement virtuel Python (virtualenv;
fortement conseillé), créez-le maintenant, puis installez les dépendances dans
le `requirements.txt` et `requirements-devel.txt` :
pip install -r requirements.txt -r requirements-devel.txt
Ensuite, il faut configurer MySQL ; créez une base de données `cof_gestion` et
un utilisateur local `cof_gestion` avec un mot de passe de votre choix.
Ensuite, copiez le fichier `cof/settings_dev.py` dans `cof/settings.py` et
changez la configuration de `DATABASES` en conséquent.
Finalement, il faut initialiser les modèles de Django :
python manage.py migrate
### Mise à jour
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