v1.13.0¶
Description¶
Montée de version infrastructure : passage du moteur PostgreSQL 15 → PostgreSQL 18 (extension oracle_fdw conservée), avec évolutions et correctifs API et admin. Inclut aussi le basculement de l’authentification JWT vers un cookie HttpOnly (API + interface admin).
PostgreSQL 18¶
- Image basée sur
postgres:18(Debian 13 / Trixie), extension oracle_fdw 2.9.0, Instant Client Oracle 18.5 - Service Compose inchangé :
labri-db-3 - Volume nouveau :
pg_data_18monté sur/var/lib/postgresql(pas.../data) ; l'ancienpg_data_3n'est plus référencé et reste disponible comme filet de secours
PHP¶
- Adaptations Debian 13 : paquet
libaio1t64+ symlinklibaio.so.1(Oracle) - Instant Client Oracle 18.5 (basic + SDK) ; Symfony CLI via l'installeur officiel (
get.symfony.com) — le dépôt aptrepo.symfony.comn'est plus utilisable - Extensions conservées : Composer, GD, Xdebug, oci8 / pdo_oci, pgsql / pdo_pgsql, intl, opcache
- Service
labri-crondérivé de la nouvelle image PHP (Dockerfile dédié) - Correctif de sécurité PHP2shell : image PHP mise à jour ; durcissement dans
docker/php/php.ini.prod(session.upload_progress.enabled = Off) ; bascule Adminer deadminer:5.4.2versadminer:latestavec suppression de l’ancienne image locale
Backend API¶
- Compatibilité Doctrine :
server_versionPostgreSQL 18 - Synchronisation HAL / co-publications : exclusion des publications dont le seul partenaire hors France est NEOLAiA
- Import CSV des accords : création à la volée des libellés programme / filière manquants ; critère
est_erasmusaffiné (ignore les libellés « hors Erasmus ») - Organisation : exposition des libellés multilingues des références externes
- Recherche d’organisations : prise en compte des libellés et identifiants des références externes (correspondance LIKE, Levenshtein et Soundex sur les libellés ; LIKE uniquement sur
source_idet valeurs deexternal_ids) - Exposition de la base partenaires locale pour OrgaSearch (recherche et fiche par identifiant) : OrgaSearch peut ainsi proposer les établissements déjà consolidés dans LaBRRI au même titre que ROR, HAL ou Wikidata
- Historique (logs) : filtre
ressourceen correspondance exacte ; nouveau filtreressourceType(préfixe d’IRI/api/{type}/, ex.organisationssans confondre avectype_organisations) - Authentification : le JWT de session est porté par un cookie en HttpOnly
UI_DOMAIN: le sample et le configuration-tool utilisent désormais<DOMAINE>(ex.labrri.univ-tours.fr) ; le placeholder<DOMAINE_SANSSOUSDOMAINE>est retiré- Nouvelle variable
UI_COOKIE_SECURE(trueen HTTPS / prod)
OrgaSearch¶
- Version 0.3.0 : une seule source LaBRRI est activable,
labrri-tours(URL + clé fournies par l’administrateur de l’instance de l'Université de Tours) - Cette source n’est active que si
LABRI_TOURS_API_URLetLABRI_TOURS_API_KEYsont renseignés ; les autres instances LaBRRI ne sont pas encore déclarées dans cette version
Interface admin¶
- Authentification : plus de JWT en
localStorageni d’en-têteAuthorization: Bearerissu du cookie lisible en JS ; les appels API passent aveccredentials: 'include'(cookie HttpOnly) - Matchtrain : authentification par token
- URLs doc et Matchtrain basculées vers les DNS
*.labrri-services.univ-tours.fr - Tableaux de bord : fond de carte OpenLayers Esri (base + labels) ; heuristiques du QueryBuilder désactivées (l’ajout automatique d’une dimension temporelle déclenchait parfois une requête trop lourde et bloquait l’interface)
- UX : spinner lors de la recherche d’organisation ; validation
siteWebdes projets tolérante aux valeurs vides - Page d’accueil : URL du logo institutionnel configurable par environnement
- Fiche organisation : section Autres libellés (libellés issus des références externes, hors libellé principal) ; correction de l’état de chargement de la recherche partenaires (spinner)
- Sélecteur partenaires : libellé de recherche précisé (« libellé ou id externe ») pour refléter la recherche élargie côté API
- Historique : filtre ressource aligné sur le paramètre API
ressourceType
Images Docker¶
| Variable d'environnement | Tag |
|---|---|
<IMAGE_DB> |
scm.univ-tours.fr:4567/iliad3/labrri-deploy/labrri_db:v18 |
<IMAGE_PHP> |
scm.univ-tours.fr:4567/iliad3/labrri-deploy/labrri_php:v1.3.1 |
<IMAGE_ADMIN> |
scm.univ-tours.fr:4567/iliad3/labrri-deploy/labrri_admin_<instance (ex. tours)>_<preprod/prod>:v1.13.0 |
<IMAGE_ORGASEARCH> |
scm.univ-tours.fr:4567/iliad3/labrri-deploy/orgasearch:v0.3.0 |
Mise à jour vers v1.13.0¶
Utilisateur dédié
Toutes les opérations ci-dessous doivent être exécutées en tant qu'utilisateur <LOGIN>, depuis le dossier <WORKDIR>, conformément à la documentation de déploiement. Les éléments de contexte (<NOMCONTENEUR_POSTGRES>, <UTILISATEUR_POSTGRES>, <NOMBDD_POSTGRES>, <DOSSIER_BACKUP>) sont ceux de cette documentation.
Volume PostgreSQL 18
Les fichiers de données d'un cluster PostgreSQL 15 sont incompatibles avec PostgreSQL 18 : il faut un nouveau volume (pg_data_18:/var/lib/postgresql, pas .../data) et un dump/restore — ne pas monter pg_data_3 sous l'image 18. Ne pas faire docker volume rm ni docker compose down -v tant que pg_data_3 sert de filet de secours.
1. Backup de la base v15 (save-database.sh ou équivalent) :
docker exec <NOMCONTENEUR_POSTGRES> pg_dump -U <UTILISATEUR_POSTGRES> -F t <NOMBDD_POSTGRES> > <DOSSIER_BACKUP>/labri-db-$(date +%Y-%m-%d-%H-%M).tar
2. Dépôt : récupérer les changements du repository labrri-deploy dans <WORKDIR> :
git pull
3. DB : télécharger <IMAGE_DB> (v18) via Portainer (voir étape 7 de la documentation de déploiement), puis dans le docker-compose.yml :
- remplacer le montage
pg_data_3:/var/lib/postgresql/data/parpg_data_18:/var/lib/postgresql/(comme dans le sample) - dans la section
volumes:du bas de fichier, remplacer la déclarationpg_data_3:parpg_data_18: - renseigner
LABRI_DB_IMAGEdans.env
Puis relancer la stack :
docker compose up -d
pg_data_3 hors Compose
Retirer pg_data_3 du Compose ne supprime pas le volume Docker : il reste présent sur l'hôte (non monté), utilisable comme filet de secours. Ne pas exécuter docker volume rm ni docker compose down -v tant qu'il sert de secours.
Après bascule, <NOMCONTENEUR_POSTGRES> désigne le conteneur du service labri-db-3 (image v18).
4. Restauration du dump vers la v18 :
docker exec -i <NOMCONTENEUR_POSTGRES> pg_restore -U <UTILISATEUR_POSTGRES> -d <NOMBDD_POSTGRES> --clean --if-exists < <DOSSIER_BACKUP>/labri-db-<AAAA-MM-JJ-HH-MM>.tar
5. Contrôler éventuellement les séquences :
- Script SQL de contrôle de cohérence des séquences d'identifiants auto-incrémentés
- Script SQL de correction des séquences d'identifiants auto-incrémentés incohérentes
6. Si l'instance utilise des vues Oracle, vérifier l'extension oracle_fdw.
7. PHP et cron : télécharger <IMAGE_PHP> via Portainer (voir étape 7), renseigner LABRI_PHP_IMAGE dans .env, reconstruire labri-cron à partir de cette image (comme pour v1.12.0 : copier / aligner le Dockerfile cron sur le sample si besoin). Rétablir les droits d'exécution de entrypoint.sh (le git pull peut les avoir perdus), puis relancer :
chmod +x <WORKDIR>/docker/php/entrypoint.sh
docker compose build labri-cron
docker compose up -d
8. Adminer (correctif PHP2shell) : aligner le service labri-adminer du docker-compose.yml sur le sample (image: adminer:latest), puis arrêter et supprimer le conteneur, supprimer l’ancienne image, re-tirer et recréer :
docker compose stop labri-adminer
docker compose rm -f labri-adminer
docker image rm adminer:5.4.2
docker compose pull labri-adminer
docker compose up -d labri-adminer
9. Clés JWT : configuration-tool.sh, opération 10
10. Cookie / domaine UI : dans <WORKDIR>/docker/api/.env (s’aligner sur docker/api/.env.sample) :
UI_DOMAIN: domaine public complet (<DOMAINE>, ex.labrri.univ-tours.fr) — le placeholder<DOMAINE_SANSSOUSDOMAINE>n’est plus utilisé- ajouter
UI_COOKIE_SECURE=true(HTTPS / prod ;falseuniquement en HTTP local)
11. Admin : télécharger <IMAGE_ADMIN> (v1.13.0) via Portainer, renseigner LABRI_ADMIN_IMAGE dans .env, puis relancer la stack (docker compose up -d). L’image admin et le code API HttpOnly doivent être déployés ensemble.
12. Clé API partenaires (uniquement si cette instance doit être partageable comme source OrgaSearch) : dans <WORKDIR>/docker/api/.env, renseigner PARTNERS_API_KEY (lettres et chiffres, au moins 32 caractères) et la communiquer aux administrateurs OrgaSearch qui doivent consommer cette instance. Tant que la clé est vide, GET /api/partners répond 401.
13. OrgaSearch : télécharger <IMAGE_ORGASEARCH> (v0.3.0) via Portainer, renseigner ORGASEARCH_IMAGE dans .env. Dans cette version, seule la source labrri-tours est activable : ajouter dans le bloc environment de labri-orgasearch l’URL et la clé fournies par l’administrateur de l’instance de L'Université de Tours :
LABRI_TOURS_API_URL: "https://labri.univ-tours.fr/api"
LABRI_TOURS_API_KEY: "<CLE_FOURNIE_PAR_L_ADMIN_TOURS>"
La stack sera relancée à l’étape suivante.
14. Cache Symfony : configuration-tool.sh, opération 12, ou suppression de <WORKDIR>/.cache/api/prod (voir étape 13 de la documentation de déploiement), puis relancer la stack :
docker compose down
docker compose up -d
15. Session navigateur : après bascule, se reconnecter via CAS. Si la session / le cookie MOULTIPASS ne se comporte plus comme attendu, vider le cache du site et le localStorage (ancienne clé auth contenant encore un token).
16. Vérifier SELECT version(); → PostgreSQL 18.x ; ne supprimer le volume Docker pg_data_3 (docker volume rm) qu'après une période de confiance