thsf.net/README.md

2.0 KiB

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:

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

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 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.

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.