refabes-docker

Introduction

refabes-docker est un projet qui a pour vocation de regrouper les différentes instances Openrefine.

Prérequis

Disposer de :

• docker-compose
• .env-dist

Ce projet se compose de deux fichiers, le premier "docker-compose.yml" regroupe les paramètres, répertoires et profils des instances Openrefine. Le dernier fichier ".env-dist" est un template pour la création du fichier .env qui sera utilisé pour les variables d'environnement.

Installation

Déployer la configuration docker dans un répertoire :

# adaptez /opt/pod/ avec l'emplacement où vous souhaitez déployer l'application
cd /opt/pod/
git clone https://github.com/abes-esr/refabes-docker.git

Configurer l'application depuis l'exemple du fichier .env-dist (ce fichier contient la liste des variables) :

cd /opt/pod/refabes-docker/
cp .env-dist .env
# personnaliser alors le contenu du .env

Démarrage et arrêt

Pour lancer une ou des instance(s), il faut modifier la variable COMPOSE_PROFILES présent dans le fichier .env. Les profils sont définis dans le fichier fichier docker-compose.yml :

COMPOSE_PROFILES=watchtower,refmovies

Puis, il suffit de rentrer la commande suivante :

sudo docker compose up -d

Pour stopper une instance :

cd /opt/pod/refabes-docker/

docker-compose down

Pour redémarrer une instance :

docker-compose restart

Pour supprimer les données :

docker compose down -v

#Et supprimer les volumes : 
rm -fr volumes

Allocation de ressources pour les conteneurs

Pour ajuster l'allocation de ressources pour les conteneurs (par exemple, mémoire, CPU), vous pouvez modifier la valeur des variables d'environnement suivantes dans votre fichier .env :

• OPENREFINE_XXXX_MEM_LIMIT: Mémoire allouée au conteneur (par exemple: "512m" pour 512 Mo), valeur par défaut "5g".
• OPENREFINE_XXXX_CPU_LIMIT: CPU alloué au conteneur (par exemple: "0.5" pour allouer 50% d'un CPU), valeur par défaut "5".
• OPENREFINE_XXXX_PORT: Définit le port à utiliser.
• OPENREFINE_XXXX_VERSION : Définit la version de l'image à utiliser.
• OPENREFINE_XXXX_REFINE_MEMORY : Définit la valeur mémoire JAVA HEAP à utiliser.