Blame view

INSTALL.md 2.28 KB
cc95f31e   hitier   Complete installa...
1
# Installation de Plan De Charge
bc7964c5   hitier   Documentation sph...
2

cc95f31e   hitier   Complete installa...
3
## Prérequis
3c0785d6   hitier   Auto deploy to ap...
4

cc95f31e   hitier   Complete installa...
5
- python3
3c0785d6   hitier   Auto deploy to ap...
6

cc95f31e   hitier   Complete installa...
7
8
9
10
11
12
## Obtenir un répertoire fonctionnel

    git clone https://gitlab.irap.omp.eu/PDC-IRAP/pdc-web.git
    cd pdc-web

### Installer l'environment python
3c0785d6   hitier   Auto deploy to ap...
13
14
15
16

    python3 -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
cc95f31e   hitier   Complete installa...
17
18
19

### Configurer l'application

3c0785d6   hitier   Auto deploy to ap...
20
21
22
    cp resources/pdc_config.py .
    $(EDITOR) pdc_config.py

cc95f31e   hitier   Complete installa...
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
    cp resources/flaskenv .flaskenv


### Jouer les tests et exécuter un serveur local

    pip install -r requirements-tests.txt
	PYTHONPATH=. pytest

    # éventuellement voir le taux de couverture
    PYTHONPATH=. pytest  --cov=app --cov-report=xml:"coverage.xml" --cov-report=term --junitxml "tests-report.xml" 

    # ouvrir un serveur sur localhost:5000
    flask run

## Configurer apache 

Les fichiers concernés:

- pdc_web.wsgi
- pdc_config.py

La procédure:

    mkdir /var/www/html/pdc-web

    cp ./resources/apache2-virtual-host.conf /etc/apache2/sites-available/pdc-web.conf
    $(EDITOR) /etc/apache2/sites-available/pdc-web.conf # éditer les paramètres
    a2ensite pdc-web 
    apachectl restart


### Mise à jour 

bc7964c5   hitier   Documentation sph...
56
## git autodeploy
3c0785d6   hitier   Auto deploy to ap...
57

cc95f31e   hitier   Complete installa...
58
59
60
61
62
63
64
65
66
Les fichiers concernés:

- scripts/post-deploy.sh
- resources/post-receive.git-hook

La procédure:

    git --work-tree=/var/www/html/pdc-web --git-dir=/path/to/the/repo.git checkout -f master

3c0785d6   hitier   Auto deploy to ap...
67
68
69
    # make bare repo
    git clone --bare /path/to/the/repo.git
    # put on hook
54262837   hitier   More intallation doc
70
71
72
73
    cp /path/to/working-directory/resources/post-receive.git-hook repo.git/hooks/post-receive
    $(EDITOR) repo.git/hooks/post-receive

    git push to repo
3c0785d6   hitier   Auto deploy to ap...
74

3c0785d6   hitier   Auto deploy to ap...
75

3c0785d6   hitier   Auto deploy to ap...
76

e4465a86   hitier   More french insta...
77
Intégration Pycharm 
cc95f31e   hitier   Complete installa...
78
-------------------
bc7964c5   hitier   Documentation sph...
79

e4465a86   hitier   More french insta...
80
81
82
83
84
Ce projet utilisant le pattern "factory", il faut procéder
à quelques configuration afin de le faire tourner avec
pycharm.

Pour une procédure détaillée, voir la page:
cc95f31e   hitier   Complete installa...
85

cc95f31e   hitier   Complete installa...
86
https://flask.palletsprojects.com/en/1.1.x/cli/#pycharm-integration
cc95f31e   hitier   Complete installa...
87
88
89
90

But basically, you just have to Edit the Run Configurations,
and set the fields:

e4465a86   hitier   More french insta...
91
92
93
94
95
Dans le menu 'Edit Configurations', changer les champs:

- 'module name' positionné à 'flask'
- et dans le champs 'Parameters' choisir 'run'

cc95f31e   hitier   Complete installa...
96

e4465a86   hitier   More french insta...
97
Normalement, cette configuration permet de lire les variables positionées dans le fichier .flaskenv
cc95f31e   hitier   Complete installa...
98

e4465a86   hitier   More french insta...
99
100
    FLASK_ENV=development
    FLASK_APP=pdc_web
cc95f31e   hitier   Complete installa...
101

bc7964c5   hitier   Documentation sph...
102

e4465a86   hitier   More french insta...
103
Ainsi fait, exécutez votre projet depuis pycharm et testez.
716b68ce   hitier   Add db migrate fa...
104
flask db update