|
| 1 | +# CRITICAL: OpenSIN CI/CD Architecture |
| 2 | + |
| 3 | +**Datum:** 2026-04-13 |
| 4 | +**Priorität:** KRITISCH - MUSS VON ALLEN AGENTEN BEACHTET WERDEN |
| 5 | + |
| 6 | +## WICHTIGSTE REGEL |
| 7 | + |
| 8 | +**WIR NUTZEN KEINE DIREKTEN GITHUB ACTIONS!** |
| 9 | + |
| 10 | +Statt direkter GitHub Actions nutzen wir unser **eigenes CI/CD-System**: |
| 11 | + |
| 12 | +``` |
| 13 | +GitHub Webhook → A2A-SIN-GitHub-Action → n8n Workflow → OCI VM Runner |
| 14 | +``` |
| 15 | + |
| 16 | +### Architektur |
| 17 | + |
| 18 | +1. **A2A-SIN-GitHub-Action** (`github.com/OpenSIN-AI/A2A-SIN-GitHub-Action`) |
| 19 | + - Minimaler GitHub Action Wrapper |
| 20 | + - Sendet Webhook an n8n bei jedem Push/PR |
| 21 | + - Keine Build-Logik in der Action selbst! |
| 22 | + |
| 23 | +2. **n8n Workflows** (OCI VM `92.5.60.87:5678`) |
| 24 | + - Empfängt Webhooks von GitHub |
| 25 | + - Orchestriert Builds, Tests, Deployments |
| 26 | + - Nutzt OCI VM Runner für schwere Arbeiten |
| 27 | + |
| 28 | +3. **OCI VM Runner** |
| 29 | + - Führt tatsächliche Builds/Tests aus |
| 30 | + - Berichtet Ergebnisse zurück an n8n |
| 31 | + - n8n updated GitHub Status Checks |
| 32 | + |
| 33 | +### WARUM dieses System? |
| 34 | + |
| 35 | +- **Keine GitHub Actions Minuten verschwendet** → Kosten sparen |
| 36 | +- **Zentrale Steuerung** → Alle Pipelines in n8n sichtbar |
| 37 | +- **Flexible Runner** → OCI VM, HF Spaces, lokale Maschinen |
| 38 | +- **Einheitliches Logging** → Alles in n8n Execution Logs |
| 39 | + |
| 40 | +### REGELN FÜR ALLE AGENTEN |
| 41 | + |
| 42 | +1. **NIEMALS** `.github/workflows/*.yml` direkt erstellen für Build/Test/Deploy |
| 43 | +2. **IMMER** `A2A-SIN-GitHub-Action` als minimalen Webhook-Trigger nutzen |
| 44 | +3. **IMMER** n8n Workflows für die eigentliche Pipeline-Logik nutzen |
| 45 | +4. Bei neuen Repos: Nur minimalen Webhook-Trigger einrichten, Rest in n8n |
| 46 | + |
| 47 | +### Ausnahmen |
| 48 | + |
| 49 | +Die einzigen erlaubten `.github/workflows/` Dateien sind: |
| 50 | +- `webhook-trigger.yml` — Sendet Payload an n8n Webhook |
| 51 | +- KEINE Build-Test-Deploy Workflows direkt in GitHub! |
| 52 | + |
| 53 | +### Referenzen |
| 54 | + |
| 55 | +- **A2A-SIN-GitHub-Action:** `github.com/OpenSIN-AI/A2A-SIN-GitHub-Action` |
| 56 | +- **n8n Dashboard:** `http://92.5.60.87:5678` |
| 57 | +- **OCI VM:** `ubuntu@92.5.60.87` |
| 58 | +- **sin-n8n CLI:** `~/.local/bin/sin-n8n` |
| 59 | + |
| 60 | +--- |
| 61 | + |
| 62 | +**DIESE INFORMATION IST KRITISCH FÜR ALLE NEUEN REPOS UND AGENTEN!** |
| 63 | +**JEDES NEUE REPO BRAUCHT NUR DEN MINIMALEN WEBHOOK-TRIGGER!** |
0 commit comments