Skip to content

README.md

Latest commit

 

History

History
75 lines (52 loc) · 3.22 KB

README.md

File metadata and controls

75 lines (52 loc) · 3.22 KB

Développement et déploiement

Développement en local

Il est possible de déployer et de tester l'application localement en mode développement en utilisant docker compose.

Tip

Pour installer docker (et docker compose), voir Install Docker Engine

Avant toute chose, il faut créer un fichier .env à la racine du projet, qui doit contenir:

S3_ACCESS_KEY_ID=<key id>
S3_SECRET_ACCESS_KEY=<access key>

La key id et l'access key sont à demander aux tech leads.

Il n'y a ensuite plus qu'à tout lancer avec:

docker compose -f docker/compose.yaml -f docker/compose.dev.yaml up

Vous pouvez accéder à l'application en tapant http://localhost:5173/ dans la barre d'adresse de votre navigateur.

Important

Si vous voulez vous connecter en tant qu'admin à l'application locale, le nom d'utilisateur ainsi que le mot de passe sont accessibles ici.

Tips

Pour forcer le build complet des applications (si vous ajoutez une dépendance par exemple):

docker compose -f docker/compose.yaml -f docker/compose.dev.yaml up --build

Pour ne lancer que le backend:

docker compose -f docker/compose.yaml -f docker/compose.dev.yaml up backend

Note

docker garde un build cache afin de ne pas avoir à tout télécharger chaque chaque fois et ainsi rendre le build plus rapide. De ce fait, si des changements ont été fait côté coordo, il se pourrait que docker ne les télécharge pas automatiquement. Dans ce cas, vous pouvez forcer le build complet avec:

docker compose -f docker/compose.dev.yaml build --no-cache

et relancer l'application Si vous avez toujours un problème, vous pouvez tenter de supprimer les containers / images et volumes avec:

docker system prune -a --volumes

Environnement de test / staging

Data4Good utilise Coolify pour le déploiement de ses applications en mode test / staging. Si vous avez un compte sur le Coolify de Data4Good, vous pouvez accéder à la configuration de l'application de staging de Data4Trees.

Note

Si vous avez besoin de tester votre code sur l'environnement staging, vous pouvez contacter @RonanMorgan pour qu'il vous crée un compte.

Déploiement en test

En premier lieu, pour chaque PR, il convient de déployer le code de la branche sur l'environnement de test. Le déploiement de staging va utiliser les fichiers docker/compose.yaml et docker/compose.test.yaml. L'application de staging est disponible à l'adresse: https://test-data4trees.services.d4g.fr/.

Déploiement en staging

Pour les asociations, une vraie application de staging est dispo à l'adresse https://data4trees.services.d4g.fr/ Le déploiement de staging va utiliser les fichiers docker/compose.yaml et docker/compose.staging.yaml.

Session admin

Un utilisateur superadmin est créé automatiquement à chaque démarrage de l'application. Vous pouvez demander les credentials associés aux tech leads.