51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
# THSF.NET
|
|
|
|
Le site du **THSF**
|
|
|
|
## Fonctionnement du site
|
|
|
|
Le site du **THSF** est une application *Python Flask* configurée à partir du fichier `config.yml` situé à la racine du dépôt.
|
|
|
|
Il n'est généralement pas nécessaire de modifier ce fichier de configuration, cependant il ets possible d'augmenter le niveau de *log* en modifiant la clef de configuration `log::root::level` en la passant à `DEBUG` (valeur en production: `INFO`).
|
|
|
|
### Conteneur
|
|
|
|
Un fichier `thsf.Dockerfile` ainsi que le fichier `docker-compose.yml` correspondant permettront de rapidement démarrer localement une instance du site du **THSF**.
|
|
|
|
### Démarrer une instance du site du **THSF**
|
|
|
|
Assurez vous d'avoir l'environnement de conteneurisation adéquat (i.e: *docker* + *docker-compose*) puis exécuter directement les commandes suivantes depuis la racine du dépôt:
|
|
|
|
```shell
|
|
docker-compose build
|
|
docker-compose up -d
|
|
```
|
|
|
|
Le site du **THSF** écoutera alors sur le port *TCP/8042*:
|
|
|
|
`http://127.0.0.1:8042`
|
|
|
|
### Arrêter une instance du site du **THSF**
|
|
|
|
```shell
|
|
docker-compose down
|
|
```
|
|
|
|
## Apporter des modifications au site
|
|
|
|
Le code de l'application *Python Flask* se situe dans le répertoire `src`.
|
|
|
|
## Publication du site
|
|
|
|
Il n'est **pas possible** de pousser directement des modifications sur la branche `master`.
|
|
|
|
Pour modifier le site, il est nécessaire de créer une branche spécifique et d'y pousser vos modifications.
|
|
|
|
Lorsque vous êtes satisfaits de vos modifications, vous pouvez créer [une demande d'ajout](https://git.tetalab.org/tetalab/thsf.net/pulls) de votre branche sur la branche `master`.
|
|
|
|
Lorsque la demande de fusion sera acceptée, vos modifications seront automatiquement publiées sur [le site du THSF](https://www.thsf.net).
|
|
|
|
Vous pouvez auto-accepter vos demandes de fusion si vous faites partie des développeurs autorisés.
|
|
|
|
Si vous n'avez pas de compte sur l'instance *Gitea* du **Tetalab** et que vous voulez faire une *pull request*, envoyez un patch (diff) par courriel à **contact@tetalab.org**.
|