docs(quick-260916-dcz): Betriebshandbuch Kapitel 9 (Changelog-Schritt, Gitea-Release, Seite Was ist neu), Anwender-, Entwicklungs- und CI-Handbuch
- Betrieb Kapitel 9: Vorschritt CHANGELOG.md vor dem Tag, automatischer Gitea-Release samt Verhalten bei fehlendem Abschnitt, Erstfreigabe v1.0.0 in der Vergangenheit, vierter Erkennungsweg "Was ist neu" - Anwender: Satz zur Versionszeile in "Aufbau der Oberflaeche", neuer Abschnitt "Was ist neu" vor den Stolpersteinen, Inhaltsverzeichnis; Abschnitt "Dashboard" (dyv) unangetastet - Entwicklung: Regel "Aenderungsliste" unter Konventionen und Fallstricke (Bauzeit-Einbettung, Importdisziplin, Kanalregel, Release-Skript) - CI-Setup (ASCII): REGISTRY_TOKEN mit repository: write, vier Schritte im Job publish, Release je Tag, API-Basis im Job-Container Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018N9CD3ebPKm1b32bPpBknY
This commit is contained in:
@@ -432,6 +432,11 @@ Zeilen einmal ergänzt.
|
||||
Das Freigeben erledigt Claude; Sie sagen nur „Version X freigeben“. Zur Einordnung,
|
||||
was dabei passiert:
|
||||
|
||||
1. **Änderungsliste abschließen:** In `CHANGELOG.md` wird der Abschnitt
|
||||
„Unveröffentlicht“ in „X.Y.Z – JJJJ-MM-TT“ umbenannt, darüber ein neues, leeres
|
||||
„Unveröffentlicht“ angelegt, und das Ganze auf `main` committet und gepusht.
|
||||
Erst dann wird zusammengeführt und getaggt:
|
||||
|
||||
```bash
|
||||
git checkout live
|
||||
git merge --ff-only main
|
||||
@@ -445,6 +450,14 @@ weigert, ist eine frühere Korrektur (siehe Hotfix, Schritt 5) noch nicht zurüc
|
||||
Zweig `live` wird nur geprüft, der Tag `vX.Y.Z` wird gebaut und als `live` und
|
||||
`vX.Y.Z` abgelegt. Das dauert etwa vier bis sechs Minuten.
|
||||
|
||||
Beim Tag legt die Pipeline zusätzlich einen **Release in Gitea** an: Name
|
||||
„Tessera X.Y.Z“, Text ist der Abschnitt dieser Version aus `CHANGELOG.md`. Sie
|
||||
finden ihn im Repository unter „Releases“. Fehlt der Abschnitt in der
|
||||
Änderungsliste, schlägt genau dieser letzte Schritt fehl – die Abbilder sind dann
|
||||
trotzdem gebaut und abgelegt. Der Release wird nachgeholt, sobald der Abschnitt
|
||||
nachgetragen ist: entweder durch erneutes Auslösen des Tag-Laufs oder lokal per
|
||||
Skript (`.gitea/scripts/publish-release.sh --tag vX.Y.Z`).
|
||||
|
||||
Danach spielen Sie die Version auf dem Live-Server ein – Kapitel 4 gilt unverändert:
|
||||
|
||||
```bash
|
||||
@@ -452,10 +465,12 @@ docker compose -f docker-compose.prod.yml pull
|
||||
docker compose -f docker-compose.prod.yml up -d --force-recreate api web
|
||||
```
|
||||
|
||||
**Erstfreigabe v1.0.0:** Den Zweig `live` gibt es noch nicht. Er entsteht beim
|
||||
ersten Mal aus `main` (`git checkout -b live main`), bekommt den Tag `v1.0.0` und
|
||||
wird zusammen mit dem Tag gepusht. Das erfolgt, sobald der Knopf „Fehler melden“
|
||||
eingebaut ist – nicht in diesem Durchlauf.
|
||||
**Erstfreigabe v1.0.0:** Die erste Freigabe ist erfolgt. Der Zweig `live`
|
||||
entstand am 2026-09-14 aus `main` (`git checkout -b live main`), bekam den Tag
|
||||
`v1.0.0` und wurde zusammen mit dem Tag gepusht; seit 2026-09-15 läuft diese
|
||||
Version auf dem Live-Server. Der Release „Tessera 1.0.0“ in Gitea wurde
|
||||
nachträglich mit dem Skript angelegt, weil die Änderungsliste erst danach
|
||||
eingeführt wurde.
|
||||
|
||||
### Einen Fehler auf Live beheben (Hotfix)
|
||||
|
||||
@@ -483,7 +498,7 @@ eine Datenbankänderung, wird sie als reguläre Version über `main` freigegeben
|
||||
|
||||
### Woran Sie erkennen, welche Version läuft
|
||||
|
||||
Drei Wege, vom einfachsten zum genauesten:
|
||||
Vier Wege, vom einfachsten zum genauesten:
|
||||
|
||||
1. **In der Oberfläche:** Unten in der Seitenleiste steht `v1.0.0 · Live` bzw.
|
||||
`v1.0.0-12-gabc1234 · Beta`. Wenn Sie die Maus darüber halten, erscheinen die
|
||||
@@ -505,6 +520,11 @@ Drei Wege, vom einfachsten zum genauesten:
|
||||
```
|
||||
|
||||
Zeigt die Startzeile `Tessera API v1.0.0 (live) abc1234` (siehe Kapitel 7).
|
||||
4. **Was sich geändert hat:** Ein Klick auf die Versionszeile unten in der
|
||||
Seitenleiste öffnet die Seite „Was ist neu“ mit der Änderungsliste. Auf Live
|
||||
sehen Sie nur freigegebene Versionen; auf der Beta steht zusätzlich der
|
||||
Abschnitt „Noch nicht freigegeben (Beta)“ mit dem, was seit der letzten
|
||||
Freigabe dazugekommen ist.
|
||||
|
||||
### Den neuen Live-Server einrichten
|
||||
|
||||
|
||||
Reference in New Issue
Block a user