Docker

Module permettant le déploiement de l'ensemble des briques de la GPAO via Docker

Procédure

Installation de Docker Engine sous Ubuntu

Suivre ces deux tutos :

1. https://docs.docker.com/engine/install/ubuntu/
2. https://docs.docker.com/engine/install/linux-postinstall/

/!\ Pour gérer le proxy de l'IGN et les erreurs du type Error response from daemon :

• Créer un fichier /home/"$USER"/.docker/config.json pour le compte admin et le compte normal en suivant la doc https://docs.docker.com/network/proxy/

• Créer un fichier /etc/systemd/system/docker.service.d/proxy.conf et configurer les variables d'environment HTTP_PROXY, HTTPS_PROXY et NO_PROXY en suivant la doc https://docs.docker.com/config/daemon/systemd/

Un systemctl restart docker voire un reboot la machine sera peut-être nécessaire pour les prendre en compte.

Vérifier avec un docker info que les variables proxy sont enregistrées.

Déploiement de la GPAO

Cloner le dépôt ign-gpao/docker et dans un terminal lancer la commande suivante :

docker compose up --scale client-gpao=0

Les images Dockers sont téléchargées sur le DockerHub de la GPAO et les conteneurs database-gpao, api-gpao et monitor-gpao sont lancés automatiquement via le fichier docker-compose.yml. Le monitor est alors accessible à l'adresse localhost:8000/ et le client est à lancer à part.

NB :

Dans le cas d'une mise à jour d'une GPAO, il est parfois nécessaire de supprimer et de recréer la base si le modèle de données a changé entre la précédente release et la nouvelle. Pour cela :

1. Ouvrir un environnement d’exécution dans le conteneur database : docker exec -ti database bash
2. Supprimer l'ancienne base (Attention cela supprime toutes les données de jobs, projets...) : dropdb -U postgres -h localhost gpao
3. Se placer dans le répertoire du conteneur contenant le fichier gpao.sql : cd docker-entrypoint-initdb.d/
4. Créer la nouvelle base : psql -U postgres -h localhost -f gpao.sql

Licence

Ce projet est sous licence CECILL-B (voir LICENSE.md).