Skip to content

Commit 4336d37

Browse files
author
OpenSIN-AI
committed
feat: add critical CI/CD architecture knowledge to PCPM
- Document custom CI/CD system (A2A-SIN-GitHub-Action + n8n) - Clarify: NO direct GitHub Actions for build/test/deploy - All new repos need only webhook trigger, rest in n8n - Critical knowledge for all agents and new repos
1 parent bdbc6cc commit 4336d37

1 file changed

Lines changed: 63 additions & 0 deletions

File tree

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
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

Comments
 (0)