Clarifie la procédure d'installation manuelle
Clarifie la procédure de configuration de MySQL lors d'une installation manuelle et intègre un paragraphe pour expliquer comment utiliser SQLite.
This commit is contained in:
parent
1bd92f7ff7
commit
7f6b5c8ad8
1 changed files with 79 additions and 9 deletions
88
README.md
88
README.md
|
@ -26,7 +26,9 @@ gérer la machine virtuelle :
|
||||||
|
|
||||||
- `vagrant up` permet de lancer la machine virtuelle. Si une 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
|
existe déjà, elle sera réutilisée; sinon, Vagrant va créer et configurer une
|
||||||
nouvelle machine virtuelle pour vous.
|
nouvelle machine virtuelle pour vous (la première fois que vous lancez cette
|
||||||
|
commande, Vagrant va télécharger une image d'Ubuntu; il vaut mieux avoir une
|
||||||
|
connection Internet pas trop mauvaise).
|
||||||
|
|
||||||
- `vagrant suspend` permet de sauver l'état de la machine virtuelle sur le
|
- `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
|
disque pour la relancer plus tard (y compris après un reboot) avec `vagrant
|
||||||
|
@ -66,23 +68,91 @@ est fortement conseillé d'utiliser un environnement virtuel pour Python.
|
||||||
Il vous faudra installer mercurial, pip, les librairies de développement de
|
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, ...) :
|
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
|
sudo apt-get install mercurial python-pip python-dev libmysqlclient-dev
|
||||||
|
|
||||||
Si vous décidez d'utiliser un environnement virtuel Python (virtualenv;
|
Si vous décidez d'utiliser un environnement virtuel Python (virtualenv;
|
||||||
fortement conseillé), créez-le maintenant, puis installez les dépendances dans
|
fortement conseillé), déplacez-vous dans le dossier où est installé GestioCOF
|
||||||
le `requirements.txt` et `requirements-devel.txt` :
|
(le dossier où se trouve ce README), et créez-le maintenant :
|
||||||
|
|
||||||
|
virtualenv env
|
||||||
|
|
||||||
|
Pour l'activer, il faut faire
|
||||||
|
|
||||||
|
. env/bin/activate
|
||||||
|
|
||||||
|
dans le même dossier.
|
||||||
|
|
||||||
|
Vous pouvez maintenant installer les dépendances Python depuis les fichiers
|
||||||
|
`requirements.txt` et `requirements-devel.txt` :
|
||||||
|
|
||||||
pip install -r requirements.txt -r 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
|
Enfin, copiez le fichier `cof/settings_dev.py` dans `cof/settings.py`.
|
||||||
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 :
|
#### Installation avec MySQL
|
||||||
|
|
||||||
|
Il faut maintenant installer MySQL. Si vous n'avez pas déjà MySQL installé sur
|
||||||
|
votre serveur, il faut l'installer ; sous Debian et dérivées (Ubuntu, ...) :
|
||||||
|
|
||||||
|
sudo apt-get install mysql-server
|
||||||
|
|
||||||
|
Il vous demandera un mot de passe pour le compte d'administration MySQL,
|
||||||
|
notez-le quelque part (ou n'en mettez pas, le serveur n'est accessible que
|
||||||
|
localement par défaut). Si vous utilisez une autre distribution, consultez la
|
||||||
|
documentation de votre distribution pour savoir comment changer ce mot de passe
|
||||||
|
et démarrer le serveur MySQL (c'est automatique sous Ubuntu).
|
||||||
|
|
||||||
|
Vous devez alors créer un utilisateur local et une base `cof_gestion`, avec le
|
||||||
|
mot de passe de votre choix (remplacez `mot_de_passe`) :
|
||||||
|
|
||||||
|
mysql -uroot -e "CREATE DATABASE cof_gestion; GRANT ALL PRIVILEGES ON cof_gestion.* TO 'cof_gestion'@'localhost' IDENTIFIER BY 'mot_de_passe'"
|
||||||
|
|
||||||
|
Éditez maintenant le fichier `cof/settings.py` pour y intégrer ces changements ;
|
||||||
|
la définition de `DATABASES` doit ressembler à (à nouveau, remplacez
|
||||||
|
`mot_de_passe` de façon appropriée) :
|
||||||
|
|
||||||
|
DATABASES = {
|
||||||
|
'default': {
|
||||||
|
'ENGINE': 'django.db.backends.mysql',
|
||||||
|
'NAME': 'cof_gestion',
|
||||||
|
'USER': 'cof_gestion',
|
||||||
|
'PASSWORD': 'mot_de_passe',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#### Installation avec SQLite
|
||||||
|
|
||||||
|
GestioCOF est installé avec MySQL sur la VM COF, et afin d'avoir un
|
||||||
|
environnement de développement aussi proche que possible de ce qui tourne en
|
||||||
|
vrai pour éviter les mauvaises surprises, il est conseillé d'utiliser MySQL sur
|
||||||
|
votre machine de développement également. Toutefois, GestioCOF devrait
|
||||||
|
fonctionner avec d'autres moteurs SQL, et certains préfèrent utiliser SQLite
|
||||||
|
pour sa légèreté et facilité d'installation.
|
||||||
|
|
||||||
|
Si vous décidez d'utiliser SQLite, il faut l'installer ; sous Debian et dérivées :
|
||||||
|
|
||||||
|
sudo apt-get install sqlite3
|
||||||
|
|
||||||
|
puis éditer le fichier `cof/settings.py` pour que la définition de `DATABASES`
|
||||||
|
ressemble à :
|
||||||
|
|
||||||
|
DATABASES = {
|
||||||
|
'default': {
|
||||||
|
'ENGINE': 'django.db.backends.sqlite3',
|
||||||
|
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#### Fin d'installation
|
||||||
|
|
||||||
|
Il ne vous reste plus qu'à initialiser les modèles de Django avec la commande suivante :
|
||||||
|
|
||||||
python manage.py migrate
|
python manage.py migrate
|
||||||
|
|
||||||
|
et vous êtes prêts à développer ! Lancer GestioCOF en faisant
|
||||||
|
|
||||||
|
python manage.py runserver
|
||||||
|
|
||||||
### Mise à jour
|
### Mise à jour
|
||||||
|
|
||||||
Pour mettre à jour les paquets Python, utiliser la commande suivante :
|
Pour mettre à jour les paquets Python, utiliser la commande suivante :
|
||||||
|
|
Loading…
Reference in a new issue