vendoo/docs/GITHUB_MERGE_RELEASE_1_41_0.md

Vendoo 1.41.0 – GitHub Push, Pull Request, Merge und Release

Grundregel

Der Produktionsbranch ist main. Direkt auf main wird nicht entwickelt. Jeder neue Vendoo-Stand wird zuerst auf einen Release- oder Hotfix-Branch übertragen, durch GitHub Actions geprüft und anschließend per Pull Request gemergt.

Teil A – vollständigen Quellstand hochladen

Auf dem Windows-Rechner nach erfolgreichem lokalen Start von 1.41.0:

1. W:\ChatGPT\Vendoo\GitHub-Deploy-Assistent.bat starten.
2. Der Assistent bereitet ein sauberes Git-Staging vor.
3. Den vollständigen Sicherheitsbericht lesen.
4. Prüfen, dass keine dieser Dateien im Git-Status erscheint:
   • .env
   • Datenbanken
   • Uploads
   • Backups
   • Logs
   • master.key
   • secrets.enc.json
   • modules/
   • updates/
5. Prüfen, dass der Zielbranch lautet:

release/1.41.0-coolify-production

6. Erst danach exakt eingeben:

PUSH

7. Den Assistenten vollständig abschließen lassen.

Teil B – Pull Request #16 prüfen

1. GitHub öffnen.
2. Repository Masterluke77/vendoo öffnen.
3. Pull requests öffnen.
4. PR Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates öffnen.
5. Prüfen:

Base: main
Compare: release/1.41.0-coolify-production

6. Unter Files changed kontrollieren, dass der vollständige Quellstand enthalten ist.
7. Besonders prüfen:
   • Dockerfile
   • deploy/coolify.env.example
   • .github/workflows/ci.yml
   • .github/workflows/release.yml
   • app/modules/deployments/
   • app/kernel/platform-kernel.mjs
   • public/index.html
   • public/app.js
   • docs/COOLIFY_PRODUCTION_1_41_0.md
8. Unter Checks beziehungsweise unten im PR warten, bis alle GitHub-Actions-Prüfungen grün sind.
9. Bei einem roten Check nicht mergen. Den fehlgeschlagenen Job öffnen und den vollständigen Fehler korrigieren.

Teil C – Draft beenden

Der vorbereitete PR ist zunächst ein Draft.

1. Im PR Ready for review anklicken.
2. Erneut prüfen, dass alle Checks grün sind.
3. Keine offenen Review-Kommentare stehen lassen.

Teil D – Merge

Empfohlen:

Squash and merge

Vorgehen:

1. Pfeil neben dem Merge-Button öffnen.
2. Squash and merge auswählen.
3. Commit-Titel verwenden:

Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates

4. Merge bestätigen.
5. Prüfen, dass der PR den Status Merged hat.
6. Den Release-Branch anschließend über Delete branch löschen.

Nicht den lokalen Vendoo-Ordner löschen. Nur der GitHub-Release-Branch darf nach dem Merge entfernt werden.

Teil E – main prüfen

1. Repository-Startseite öffnen.
2. Branch main auswählen.
3. Prüfen, dass package.json Version 1.41.0 enthält.
4. Actions öffnen.
5. Den letzten Workflow auf main prüfen.
6. Erst fortfahren, wenn Vendoo CI erfolgreich ist.

Teil F – GitHub Release veröffentlichen

1. Rechts im Repository Releases öffnen.
2. Draft a new release anklicken.
3. Choose a tag wählen.
4. Neuen Tag erstellen:

v1.41.0

5. Target Branch main wählen.
6. Release title:

Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates

7. Release Notes aus CHANGELOG.md übernehmen.
8. Set as the latest release aktivieren.
9. Nicht als Pre-Release markieren.
10. Publish release anklicken.

Danach startet der Workflow Vendoo Release.

Teil G – Release-Workflow kontrollieren

Unter Actions → Vendoo Release müssen beide Jobs erfolgreich sein:

1. Release-Paket und Prüfsummen
2. GHCR-Container veröffentlichen

Der Workflow erzeugt:

• Release-ZIP
• SHA-256-Datei
• ghcr.io/masterluke77/vendoo:1.41.0
• ghcr.io/masterluke77/vendoo:1.41
• ghcr.io/masterluke77/vendoo:stable
• ghcr.io/masterluke77/vendoo:latest
• SBOM und Provenienz/Attestation

Teil H – erstes Coolify-Deployment

Für die erste Installation:

1. Coolify-Anwendung mit GitHub-Repository und Branch main verbinden.
2. Auto Deploy zunächst deaktivieren.
3. Deploy manuell anklicken.
4. Build-Logs und Healthcheck prüfen.
5. https://vendoo.flatlined.de/readyz öffnen.
6. Ersteinrichtung durchführen.
7. Coolify-Webhook im Vendoo Update Center speichern.

Teil I – zukünftiger Updateablauf

Für spätere Releases immer in dieser Reihenfolge:

1. neue Version lokal entwickeln und testen
2. Release-Branch pushen
3. Pull Request öffnen
4. GitHub Actions grün
5. PR nach main mergen
6. GitHub Release veröffentlichen
7. laufendes Vendoo öffnen
8. Update Center öffnen
9. Coolify-Deployment mit DEPLOY bestätigen
10. /readyz und Anwendung prüfen

Mit deaktiviertem Coolify Auto Deploy bleibt der Produktionsstand aktiv, bis der Administrator den Deployment-Auftrag bewusst aus Vendoo oder Coolify auslöst.