@@ -10,13 +10,19 @@ L'application est « agnostique » au type de base de donnée employée. Alors q
aujourd'hui stockés sous forme de texte car aucune requête n'aurait besoin de les parcourir ; ainsi, seul des champs par défaut de django sont employés.
#### SQlite
Pour utiliser SQlite comme SGBD, il suffit de commenter le bloc qui concerne Postgresql dans le fichier de configuration visible ici : `./general/settings.py` :
Pour utiliser SQlite comme SGBD, il suffit de commenter le bloc qui concerne Postgresql dans le fichier de configuration visible ici : `./general/settings/development.py` :
```python
## POSTGRESQL
# If bellow fails, your need to add DATABASE_URL and ENV to your virutalenv
@@ -60,15 +66,6 @@ host all all 127.0.0.1/32 trust
Pour un fonctionnement simplifié avec ce projet il faut procéder aux changement suivants.
_Petite commande à faire au début : nous allons avoir besoin de votre nom d'utilisateur._
```bash
whoami
```
C'est par le résultat de cette commande qu'il faudra que vous remplaciez chaque `<login>` dans les autres commandes.
Changer d'utilisateur pour l'utilisateur classique de `postgresql` :
```bash
su - postgres
```
...
...
@@ -84,19 +81,20 @@ Si vous ne voyez pas `postgres=#` c'est qu'il y a un problème, vérifier votre
Créer un utilisateur correspondant à votre utilisateur/login classique dans postgre :
```sql
CREATEUSER<login>;
CREATEUSERoutgoing;
ALTERUSERoutgoingWITHPASSWORD'outgoing';
```
Donner lui le droit de créer des bases de données (utile lors des tests en local) :
```sql
ALTERUSER<login>CREATEDB;
ALTERUSERoutgoingCREATEDB;
```
Créer une base de données qui lui sera associée :
```sql
CREATEDATABASE<login>;
GRANTALLonDATABASE<login>to<login>;
CREATEDATABASEoutgoing;
GRANTALLonDATABASEoutgoingtooutgoing;
```
Sortez de `psql` (`\q`) et retrouver votre utilisateur normal (`CRTL` + `D`).
...
...
@@ -117,37 +115,19 @@ Afin d'avoir des environnements reproductibles il est **fortement** suggéré d'
(Ce projet est développé sur `python-3.6`)
```bash
python3.6 -m venv <chemin-du-venv>
python3.6 -m venv ./env
```
_(chemin = "chemin" + "nom-du-venv")_ Nous vous suggérons de prendre `<chemin-du-venv> = ./env`.
Cet environnement virtuel doit être **systématiquement** activé lorsque vous travaillez sur ce projet :
```bash
source<chemin-du-venv>/bin/activate
source./env/bin/activate
```
Les lignes de votre console doivent alors commencez par `(<nom-du-venv>)`.
_Pour le désactiver, faîtes : `deactivate`_.
!> Il est essentiel à ce stade de modifier votre environnement virtuel pour ajouter des variables d'environnement spécifiques, **pour que ce projet fonctionne correctement**.
Éditer le fichier `<chemin-du-venv>/bin/activate` :
- À la fin de la fonction `deactivate ()`, avant le `}` de fin, rajouter les deux linges :
Cela permet d'ajouter et d'enlever automatiquement des variables d'environnement **essentielles** au fonctionnement du projet.
### git
Il ne vous reste plus qu'à cloner le projet :
...
...
@@ -190,11 +170,11 @@ _Collectez_ les éléments statistiques :
_Checkez_ le système :
```nash
./manage.py check
make check_backend
```
```bash
./manage.py test
make test_backend
```
Tout ce qu'il y a jusqu'ici **doit** fonctionner. :smile:
...
...
@@ -211,4 +191,4 @@ Si vous n'avez jamais travailler avec Django, un tutoriel [s'impose](https://tut
## Déploiement _externe_
À ce jour le déploiement externe est réalisé sur la plateforme proposée par [Heroku](https://www.heroku.com) à l'adresse : [http://heroku-badge.herokuapp.com/](http://heroku-badge.herokuapp.com/).
\ No newline at end of file
À ce jour, le déploiement est réalisé sur un petit vps [outgoing-utc.floflo.ch](outgoing-utc.floflo.ch)