Boîte à outils

Docker Compose — CKAN 2.12.0

Le modèle directement importable dans un service Docker Compose Coolify pour CKAN 2.12.0.

Publication
septembre 2026
Langue
FR
Thématiques
Données pour le développement, Technologies pour le développement

Résumé

Cette ressource met en place CKAN web, worker CKAN, DataPusher, PostgreSQL, Solr et Redis. Profil retenu : portail complet avec datastore et import tabulaire. Elle accompagne le guide complet de déploiement.

Architecture

Ckan web, worker ckan, datapusher, postgresql, solr et redis. Le domaine public est attribué au service d’entrée ; les autres composants communiquent sur le réseau interne.

Prérequis

Un serveur compatible avec les besoins de la solution, Docker géré par Coolify, un domaine pointé vers le serveur, un espace de stockage persistant et un accès administrateur à la plateforme. La mémoire, le processeur et le disque doivent être dimensionnés selon les utilisateurs, les données et les tâches de fond. CKAN répond à un besoin de catalogue : décrire des jeux de données, publier des ressources, organiser les responsabilités entre producteurs et administrateurs, et rendre l’ensemble découvrable par recherche et API.

Variables, secrets et volumes

Les variables décrivent les domaines et le comportement de l’application. Les secrets sont générés une fois et partagés avec les services qui utilisent la même identité. L’état durable comprend les bases CKAN et DataStore, les fichiers CKAN, l’index Solr reconstructible et la file Redis.

Installation et validation

Créer un service Docker Compose, importer le fichier, attribuer le domaine, compléter les paramètres puis lancer le déploiement. Attendre les initialisations et exercer le parcours suivant : connexion administrateur, organisation, jeu de données, import d’un CSV de 1 193 lignes, aperçu DataStore, API, recherche, worker, redéploiement.

Sauvegarde, restauration et mise à jour

Exporter les deux bases postgresql et les fichiers ; reconstruire ou sauvegarder solr selon l’objectif de reprise. Avant une mise à jour, produire un point de reprise, tester la nouvelle version dans un environnement isolé et rejouer le parcours d’acceptation.

Lecture du fichier

Le bloc services décrit les conteneurs et leurs responsabilités. Les ancres réutilisent les variables communes sans dupliquer leur définition. Les volumes nommés identifient les états qui survivent aux redéploiements. Les contrôles de santé et les conditions de dépendance organisent le passage de la base vers l’initialisation, puis vers le service courant. Un portail utile commence donc par un schéma de métadonnées, une politique de publication et un circuit de mise à jour, avant le choix des extensions ou de l’habillage.

Avant toute adaptation, repérer le service exposé, le propriétaire des migrations, les travailleurs, les magasins d’état et les fichiers gérés. Modifier ensuite une responsabilité à la fois et conserver un parcours de validation reproductible. La composition associe l’application CKAN, un worker RQ, DataPusher, PostgreSQL pour les métadonnées et le DataStore, Solr pour l’index et Redis pour les tâches.

Exploitation

Après installation, suivre le domaine public, les certificats, la santé des services, l’espace disque, les files et la croissance des bases. Les comptes administrateurs nominatifs remplacent les accès partagés. Les changements de configuration sont relus, datés et accompagnés d’un contrôle fonctionnel. Le stockage de fichiers complète cet ensemble.

Adapter sans casser le contrat

Une nouvelle version peut modifier les images, variables, migrations ou chemins persistants. Comparer la composition avec la documentation de la version ciblée, mettre à jour dans un environnement isolé et vérifier les fonctions réellement utilisées. Le modèle reste un point de départ opérationnel, pas un substitut à l’administration du service. Le domaine public reste attaché à CKAN ; DataPusher et les magasins d’état utilisent le réseau interne et ne doivent pas recevoir de route publique.

Contrôles avant partage

Vérifier que le fichier ne contient aucun mot de passe ni domaine privé, que les images sont versionnées, que tous les volumes utiles sont nommés et que le service public possède un contrôle de santé. Relire ensuite les instructions d’installation avec une personne qui n’a pas participé à la conception. La validation ne s’est pas arrêtée à la page d’accueil.

Points de contrôle du modèle

Le Compose doit être relu avec trois contrats en tête : le fichier de configuration CKAN monté comme fichier, les URL internes utilisées par DataPusher et les tâches, et le hook d’initialisation réellement exécuté par l’image. Les signes dollar placés dans un contenu géré ne suivent pas les mêmes règles que ceux d’une commande Compose ; les échapper mécaniquement peut rendre la configuration invalide.