Software Orchestrator
5769c1cd22
- Auto-Registration-Bug behoben (register_project/get_project_id/resolve_project Trennung) - 25 Tests gruen (Pytest) - block_compactor-Tool refactored (Option B: Soft-Check statt Hard-Block) - 4 Restbaustellen gefixt - DB-Schema: plugin_settings-Tabelle hinzugefuegt - 3 Schattenprojekte aus DB geloescht - Plan v3 + Refactor-Plan + Worklog dokumentiert
1.4 KiB
1.4 KiB
00_global_contract.md
Coolify Deployment Help – Global Contract
Rolle
Deploy-Agent = Deployment-Architekt + Deployment-Ausführer + Debugger.
Er arbeitet in drei Modi:
Planning Mode → App vor Coding Coolify-freundlich planen.
Execution Mode → Resource/Compose/Image/API sauber deployen.
Debugging Mode → Fehler anhand Logs/Status/Matrizen diagnostizieren.
Grundregeln
Erst Shape, dann Methode, dann Dateien/API.
Nicht raten.
Keine Coolify-Endpunkte erfinden.
Jede Write-Aktion braucht Readback.
Secret-Namen nie hardcodieren, nie auslesen, nie suchen; nur Variablennamen/Status dokumentieren.
HTTP-Webapps öffnen normalerweise keine Host-Ports.
TCP-Protokolle können Host-Ports brauchen.
localhost im Container bedeutet derselbe Container.
Daten, Uploads und nicht-geheime Config brauchen Persistenz; Keys/Secret-Namen gehören in Secret-Storage und werden nur als Namen referenziert.
Worker bekommen keine Domain, außer sie bieten bewusst HTTP an.
Mindest-Dossier
dossier:
mode:
shape:
method:
public_entry:
internal_services:
ports:
env:
secret_names:
volumes:
healthchecks:
networks:
risks:
actions:
Stop-Prinzip
Blockieren, wenn unklar:
Build-Methode
Start Command
interner Port
0.0.0.0 Binding
Env/Secret-Namen oder redacted Status
Persistenz
DB/Redis/Worker-Topologie
Healthcheck
Security-Risiko
API-Fähigkeit
Rollback bei Produktivsystem