Bisher gab es nur Tags - eine Markierung im Verlauf. Eine Release ist ein Eintrag in Gitea mit Titel und Beschreibung, sichtbar, abonnierbar, verlinkbar. npm run releases:sync liest das CHANGELOG, nimmt jeden Abschnitt, zu dem es ein Tag gibt, und legt daraus eine Release an; ein zweiter Lauf aktualisiert nur Geaendertes. "Unreleased" bleibt aussen vor, weil es dazu kein Tag gibt. Fuenf Tests decken die Zerlegung ab. Der Lauf gegen Gitea scheitert derzeit an den Zugangsdaten: Hinterlegt ist ein elfstelliges Passwort, kein API-Token. Fuer Releases braucht es write:repository, fuer den Issue-Abgleich issue:write. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1.6 KiB
#046 Releases in Gitea statt nur Tags
Status: erledigt Meilenstein: v1.0.1 Labels: chore, doku Geschätzt: 1 h Tatsächlich: 0 h 25 min
Auslöser
„Kannst du auch Releases machen und nicht nur Tags?“
Unterschied
Ein Tag ist eine Markierung im Git-Verlauf. Eine Release ist ein Eintrag in Gitea mit Titel, Beschreibung und Download-Verweisen – sichtbar unter Releases, abonnierbar und verlinkbar. Bislang gab es nur Tags; die Beschreibungen standen allein im CHANGELOG.
Umsetzung
npm run releases:sync liest das CHANGELOG, nimmt jeden Abschnitt ## [x.y.z] – Datum, für den es
ein Tag gibt, und legt daraus eine Release an. Ein zweiter Lauf aktualisiert nur, was sich geändert
hat; „Unreleased“ bleibt außen vor, weil es dazu kein Tag gibt.
npm run releases:sync -- --dry-run # zeigt nur, was passieren würde
npm run releases:sync # legt an und aktualisiert
npm run releases:sync -- v1.0.0 # nur eine Fassung
Fünf Tests decken die Zerlegung ab.
Offen: der Token
Der in den Git-Zugangsdaten hinterlegte Wert ist elf Zeichen lang – ein Passwort, kein API-Token.
Pushen funktioniert damit, die API antwortet mit 401. Betrifft auch npm run issues:sync, das seit
dem 10.10.2026 nicht mehr durchläuft.
Nötig: in Gitea unter Einstellungen → Anwendungen ein Token mit den Rechten
write:repository (für Releases) und issue:write (für den Issue-Abgleich) erzeugen und entweder
als GITEA_TOKEN in die .env legen oder in den Git-Zugangsdaten hinterlegen. Danach trägt ein
einziger Lauf alle 43 vorhandenen Fassungen nach.