agecem-org/README.md

65 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2023-02-17 17:28:47 -05:00
# agecem/agecem-org
Site web de l'AGECEM.
Le backend utilise [go-echo](https://echo.labstack.com/).
2023-02-17 17:46:37 -05:00
## Prérequis
- `docker`
- `docker-compose`
L'installation de `docker` et `docker-compose` est hors de la portée de ce projet. Veuillez vous référer à la documentation de votre système d'exploitation.
2023-02-17 17:28:47 -05:00
## Procédure
Le lifecycle du serveur est maintenu par containers, en utilisant `docker-compose`.
2023-02-17 17:46:37 -05:00
### Exemples d'utilisation de docker-compose
2023-02-17 17:28:47 -05:00
2023-07-04 19:43:41 -04:00
*L'exemple suivant assume que minio est déployé par docker-compose en même temps que le serveur web.*
Remplir .env avec les credentials que minio utilisera pour sa configuration initiale.
Remplacer `agecem-org` par quelque chose de sécurisé.
```
# .env
MINIO_ROOT_USER=agecem-org
MINIO_ROOT_PASSWORD=agecem-org
```
Déployer le ou les containers en mode détaché, en s'assurant de rebâtir l'image.
2023-02-17 17:28:47 -05:00
`$ docker-compose up -d --build`
2023-02-17 17:28:47 -05:00
2023-02-17 17:46:37 -05:00
Voir l'état des containers
2023-02-17 17:28:47 -05:00
`$ docker-compose ps`
2023-02-17 17:46:37 -05:00
Voir les logs des containers
2023-02-17 17:28:47 -05:00
`$ docker-compose logs`
Détruire les containers
`$ docker-compose down`
### Exemple de développement sans base de données ou docker
Pour un environnement simplifié sans minio ou docker, seul le toolchain `go` devrait être nécessaire au démarrage du serveur.
Pour une exécution sans installation permanente, veuillez utiliser:
`$ go run . server`
Si nécessaire, un fichier de config peut être déposé dans `$HOME/.agecem-org.yaml` ou spécifié tel que:
`$ go run . server --config agecem-org.yaml`
`agecem-org.yaml` doit être remplacé par le fichier de config désiré.
Pour un exemple de fichier de config en format JSON, voir le résultat de:
`go run . config`