Masterluke77andGitHub
6f48827f4d
* docs: prepare Vendoo 1.41.2 git-ignore boundary hotfix * fix: track native source modules with root-anchored runtime ignores
176 lines
4.7 KiB
Markdown
176 lines
4.7 KiB
Markdown
# 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:
|
||
|
||
```text
|
||
release/1.41.0-coolify-production
|
||
```
|
||
|
||
6. Erst danach exakt eingeben:
|
||
|
||
```text
|
||
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:
|
||
|
||
```text
|
||
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:
|
||
|
||
```text
|
||
Squash and merge
|
||
```
|
||
|
||
Vorgehen:
|
||
|
||
1. Pfeil neben dem Merge-Button öffnen.
|
||
2. `Squash and merge` auswählen.
|
||
3. Commit-Titel verwenden:
|
||
|
||
```text
|
||
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:
|
||
|
||
```text
|
||
v1.41.0
|
||
```
|
||
|
||
5. Target Branch `main` wählen.
|
||
6. Release title:
|
||
|
||
```text
|
||
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.
|