README
This commit is contained in:
parent
3fee57061d
commit
5ee66b453a
1 changed files with 24 additions and 1 deletions
25
README.md
25
README.md
|
@ -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 !
|
||||
|
|
Loading…
Add table
Reference in a new issue