docs(DEPLOY): add Phase 2b activation steps
All checks were successful
Docker Build / build-and-push-image (push) Successful in 58s

This commit is contained in:
2026-05-09 14:39:14 +02:00
parent 799e10dcc2
commit 4f246ccc1d

View File

@@ -106,12 +106,31 @@ Pour le test `/echo coucou` répond `coucou`.
| `setWebhook``Wrong response from the webhook: 401` | `BOT_FACTORY_SECRET` côté Secret ≠ celui passé à setWebhook. Régénérer + recréer le Secret avec `kubectl delete && create`. |
| Webhook accepté mais pas de réponse Telegram | `kubectl logs` côté gateway → erreur sendMessage. Token bot invalide (révoqué via @BotFather ?) ou rate-limit Telegram. |
## Phase 2b — activer la queue Postgres async (optionnel)
Phase 2a (handler `http` sync) est livrée et active dès qu'un bot a `handler: http`.
Phase 2b (queue + worker) est désactivée tant que `DATABASE_URL` n'est pas dans le Secret. Pour activer :
1. Provisionner un user / une DB Postgres avec droits `CREATE TABLE` (le pod auto-applique la migration idempotente `gateway_jobs` au boot).
2. Ajouter le DSN au Secret existant :
```bash
DSN='postgres://gateway:CHANGEME@pgbouncer.tools.svc.cluster.local:6432/gateway?sslmode=disable'
kubectl -n telegram-gateway patch secret telegram-gateway-bots --type=json -p="[
{\"op\":\"add\",\"path\":\"/data/DATABASE_URL\",\"value\":\"$(echo -n "$DSN" | base64)\"}
]"
kubectl -n telegram-gateway rollout restart deploy/telegram-gateway
```
3. Vérifier dans les logs : `queue + schema ready (db=postgres://gateway@…)` puis `worker started`.
4. Configurer un bot avec `async: true` dans `chart/values.yaml` pour valider le pipeline.
## Pour aller plus loin
- Phase 2 : handler `http` (forward vers svc interne) + queue Postgres durable.
- Phase 3 : handlers `shell` / `script` / `ollama` async, retry quand le
- Phase 3 (pas livré) : handlers `shell` / `script` / `ollama` async, retry quand le
Macbook Ollama est endormi.
- Phase 4 : passage à Vault (toggle `vault.enabled: true` + provisionner
- Phase 4 (pas livré) : passage à Vault (toggle `vault.enabled: true` + provisionner
`kvv2/telegram-gateway/config`), Wake-on-LAN, multi-provider.
Plan complet : `~/.claude/plans/pour-les-notifications-on-inherited-seal.md`.