bolbol
/
nas-runbooks
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: NYORA_DOC_API_KEY manquante du docker-compose.yml (401 hermes-tt) - corrige et documente

This commit is contained in:
bolbol 2026-07-03 10:40:31 +00:00
parent 404d39bcd3
commit bbc90d8662
1 changed files with 36 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
common/nyora-doc-api-hermes-guide.md
View File

@ -157,3 +157,39 @@ mérite une relecture rapide côté PowerPoint.
Limite connue de ce QC : il porte uniquement sur le mode données (JSON), pas Limite connue de ce QC : il porte uniquement sur le mode données (JSON), pas
sur le mode template — cohérent avec la limitation de restyle déjà sur le mode template — cohérent avec la limitation de restyle déjà
documentée ci-dessus. documentée ci-dessus.
## Panne corrigée le 03/07/2026 — clé absente du runtime Hermes-TT
**Symptôme** : Hermes-TT échouait à appeler `nyora-doc-api` (401), malgré cette
documentation mentionnant correctement le header `x-api-key` et sa valeur.
**Cause réelle** : la variable `NYORA_DOC_API_KEY` n'existait ni dans
`/volume1/docker/hermes-platform/.env`, ni — surtout — dans le bloc
`environment:` des 3 services (`hermes-agent-tt/nyora/perso`) du
`docker-compose.yml` d'hermes-platform. Ce fichier whiteliste explicitement
chaque variable transmise au container : `NYORA_DOC_API_URL` y était bien
présente, mais `NYORA_DOC_API_KEY` n'avait jamais été ajoutée. Résultat :
même avec un `.env` correct, la clé n'atteignait jamais le container.
**Correctif appliqué** :
1. Ajout de `NYORA_DOC_API_URL` + `NYORA_DOC_API_KEY=nyora-doc-2026` au `.env`
(section "Services NAS"), suppression au passage des lignes mortes
`PANDOC_URL`, `CARBONE_URL`, `GOTENBERG_URL`, `PPTX_API_URL`,
`DOCUMENT_FACTORY_URL`, `TIKA_URL` (services désinstallés).
2. Ajout de `NYORA_DOC_API_KEY: ${NYORA_DOC_API_KEY}` dans le bloc
`environment:` des 3 services du `docker-compose.yml`.
3. `docker compose up -d hermes-agent-tt hermes-agent-nyora hermes-agent-perso`
pour recréer les 3 containers.
4. Vérifié : `env | grep NYORA_DOC_API_KEY` dans les 3 containers, puis test
`curl -H "x-api-key: $NYORA_DOC_API_KEY" $NYORA_DOC_API_URL/v1/templates`
depuis `hermes-agent-tt` → `200`.
**Leçon** : dans ce projet, ajouter une variable au `.env` ne suffit **pas** —
elle doit aussi être déclarée explicitement dans le bloc `environment:` de
chaque service du `docker-compose.yml` d'hermes-platform. Réflexe à avoir
pour toute nouvelle intégration (vérifier les 2 fichiers, pas un seul).
Skill `hermes-tt/data/skills/achats/email-html-marches/references/nyora-doc-api.md`
corrigé en parallèle (il indiquait un header incertain `X-API-Key`/`api-key`
et une clé "non trouvée" — remplacé par le header exact `x-api-key` et un
renvoi à la variable d'environnement plutôt qu'une valeur en clair).