This commit is contained in:
Ludovic Stephan 2020-11-16 19:10:02 +01:00
parent 3fee57061d
commit 5ee66b453a

View file

@ -1,6 +1,8 @@
# Annuaire des élèves de l'ENS
## Installation
## Environnement de développement
### Méthode facile : environnement virtuel python
Il est fortement conseillé d'utiliser un environnement virtuel pour Python.
@ -33,6 +35,27 @@ Vous êtes prêts à développer ! Lancez l'annuaire avec :
python manage.py runserver
### Plus compliqué : machine virtuelle Vagrant
Pour avoir une situation plus proche de la situation en production, il est possible de faire tourner le site depuis une
machine virtuelle Windows. Pour cela, il faut d'abord installer `vagrant` et `virtualbox` :
sudo apt install vagrant virtualbox
Ensuite, la commande `vagrant up` devrait créer et configurer la machine virtuelle ; un peu de patience, cela peut prendre
du temps ! Une fois fini, il y a deux possibilités :
- `vagrant ssh` permet de se connecter à la machine, et d'effectuer des opérations à l'aide de `manage.py`. On peut effectuer
à peu près les mêmes opérations que pour un virtualenv classique, à une différence près : il faut utiliser
python manage.py runserver 0.0.0.0:8000
pour lancer le serveur, afin d'y avoir accès depuis son navigateur.
- un serveur normalement très proche de celui de production (avec `gunicorn` + `nginx`) tourne en permanence sur la machine ;
il suffit de visiter `127.0.0.1:8080` pour y avoir accès !
## Développement
En manque d'inspiration ? N'hésitez pas à aller lire les issues ouvertes actuellement, il y en a pour tous les niveaux !