egutierrez
a03675113a
- .claude/agents/fn-orquestador/SKILL.md - .claude/commands/fn_claude.md - .claude/rules/INDEX.md - .claude/rules/cpp_apps.md - .claude/rules/ids_naming.md - CHANGELOG.md - apps/dag_engine/README.md - apps/dag_engine/api.go - apps/dag_engine/dags_migrated/example.yaml - apps/dag_engine/dags_migrated/example_lineage_tracking.yaml - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
---
|
|
name: gitea-releases-monitor
|
|
id: 0004
|
|
status: pending
|
|
created: 2026-05-16
|
|
updated: 2026-05-16
|
|
priority: medium
|
|
risk: low
|
|
related_issues: []
|
|
apps:
|
|
- registry_api
|
|
- data_factory
|
|
- agents_and_robots
|
|
trigger: webhook
|
|
schedule: ""
|
|
expected_runtime_s: 5
|
|
tags: [git, webhook, multi-repo, monitoring]
|
|
---
|
|
|
|
## Goal
|
|
|
|
Probar webhooks como trigger (no cron, no manual). Cada push a un repo `dataforge/*` registra commit en data_factory + notifica via Matrix bot. Demuestra reactividad event-driven.
|
|
|
|
## Pre-requisitos
|
|
|
|
- `gitea_create_webhook_bash_infra` disponible.
|
|
- Servidor HTTP receptor (reusar `registry_api` o `deploy_server`).
|
|
- Bot Matrix en sala `#fn-registry-releases`.
|
|
- GITEA_TOKEN en `pass registry/api-token`.
|
|
|
|
## Flow
|
|
|
|
1. Crear endpoint receptor `POST /webhook/gitea` en una app (probable: nueva mini-app `gitea_webhook_listener` o anadir a `deploy_server`).
|
|
2. Iterar repos `dataforge/<name>` (35 apps + analyses). Instalar webhook en cada uno apuntando al receptor:
|
|
```bash
|
|
for app in $(ls apps/); do
|
|
gitea_create_webhook "dataforge" "$app" "http://<vps>/webhook/gitea" "$secret"
|
|
done
|
|
```
|
|
3. Receptor parsea payload Gitea (event `push`): `{ref, commits: [{id, message, author, url}]}`.
|
|
4. INSERT en `data_factory.runs` con `node_id='gitea_push_<repo>'` (upsert node si no existe).
|
|
5. Notifica Matrix:
|
|
```
|
|
[<repo>] <author>: <commit message>
|
|
<url>
|
|
```
|
|
6. dag_engine recibe trigger `api` con info del run.
|
|
7. data_factory tab Extractors muestra `gitea_push_<repo>` por cada repo con activity.
|
|
|
|
## Acceptance
|
|
|
|
- [ ] Webhook instalado en >=3 repos.
|
|
- [ ] Push de prueba dispara recepcion + entry en `data_factory.runs`.
|
|
- [ ] Matrix recibe mensaje formateado.
|
|
- [ ] data_factory muestra nodos `gitea_push_<repo>` con last_run reciente.
|
|
- [ ] Receptor maneja fallos (timeout, payload invalido) sin crash.
|
|
|
|
## Telemetria esperada
|
|
|
|
- `data_factory.runs` con `trigger='api'`.
|
|
- Por repo: 1 nodo extractor.
|
|
- Matrix: 1 msg por push.
|
|
|
|
## Notas
|
|
|
|
- Webhook secret debe estar en `pass gitea/webhook-secret` o env var.
|
|
- Si el receptor se cae, los pushes se pierden (no hay queue). Mejora futura: redis/sqlite queue.
|
|
- Cuidado con loops: commits que GENERA el bot pueden disparar webhooks.
|