Files
nas-runbooks/common/veille-decommission-api-page-statique-20260904.md

3.8 KiB

Decommission veille-backend/veille-frontend (API FastAPI) au profit d'une page statique

Instance auteur : Claude (session chat) Date : 2026-09-04 Tags : veille, veille-nexum, decommission, page-statique, localStorage, n8n, ports-registry Statut : valide


Contexte

Nabil et Nyora ont construit un script qui tourne 3x/jour (apres le job de veille Dr Nexum) et transfere le contenu vers une page HTML statique (tags, recherche, marquage lu/non lu geres cote client via localStorage), servie sur bolbol.tn/veille. Cette page couvre a l'identique l'usage de l'ancien frontend dynamique, sans cout ni charge serveur supplementaire. L'ancien couple veille-backend (FastAPI, interne) + veille-frontend (port 3055, veille.bolbol.tn) devient redondant.


Verifications faites avant decommission

  • Page statique testee en direct (curl NAS -> bolbol.tn/veille/, HTTP 200, 881 Ko) : localStorage, tags, recherche et filtre lu/non lu tous presents dans le HTML livre.
  • Pipeline Telegram (VEILLE | Dr. Nexum — 3x/jour, execution reelle via script sur hermes-nyora, pas via le workflow n8n desactive depuis le 31/07) confirme independant du backend FastAPI : il archive dans "Nyora Veille Transit", pas dans veille-backend. Aucune dependance Telegram -> API.
  • Point de vigilance identifie et accepte par Nabil : la section "Opportunites" (alimentee par le workflow n8n actif "VEILLE | Ingest Opportunites" -> webhook -> enrichissement Bifrost -> backend) n'a pas d'equivalent dans la page statique. Decision Nabil : rattrape plus tard en ameliorant le HTML, sans engager de ressources supplementaires pour l'instant.
  • Entree veille.bolbol.tn retiree du reverse proxy par Nabil avant la decommission technique.

Solution appliquee

# 1. Desactivation du workflow n8n devenu orphelin (cible backend supprimee)
# via n8n:unpublish_workflow sur "VEILLE | Ingest Opportunites" (id 9378593adccf42dc)

# 2. Arret et suppression des containers
cd /volume1/docker/nyora-veille && docker compose down

# 3. Suppression des images Docker associees
docker rmi nyora-veille-veille-backend nyora-veille-veille-frontend

# 4. Nettoyage des fichiers nginx orphelins (ancien reverse proxy manuel, plus reference)
rm -f /volume1/docker/nginx-veille-clean.conf /volume1/docker/nginx-veille.conf.tmp

# 5. Archivage du code source (deja versionne sur Gitea bolbol/nyora-veille, commit 0bbc095 du 29/08)
mv /volume1/docker/nyora-veille /volume1/docker/_archived/nyora-veille-DECOM-20260904

# 6. Mise a jour ports-registry.md : retrait des lignes veille-frontend (3055->3000)
#    et veille-backend (interne), ajout entree historique decom-veille-04-09

Verification

  • docker ps -a | grep veille -> aucun container veille-backend/veille-frontend restant.
  • docker images | grep veille -> images nyora-veille-* supprimees.
  • ports-registry.md : plus de ligne veille-frontend/veille-backend, entree historique 2026-09-04 presente.
  • bolbol.tn/veille/ reste servi normalement (page statique, hors perimetre des containers supprimes).
  • veille.bolbol.tn : plus route (retire du reverse proxy par Nabil en amont) — attendu, pas une regression.

Pieges specifiques

  • Le repertoire /volume1/docker n'est PAS un depot git : ports-registry.md se modifie directement sur le NAS, pas de commit/push necessaire pour ce fichier.
  • mcp-nas bloque rm -r direct sur /volume1, /opt, /mnt (garde-fou) : utiliser mv vers une zone d'archive plutot que la suppression recursive forcee.
  • Le workflow n8n "VEILLE | Dr. Nexum — 3x/jour" est desactive dans n8n depuis le 31/07 mais s'execute en realite via script cron sur hermes-nyora — ne pas se fier au statut n8n seul pour juger si un pipeline tourne encore.

References