Compare commits
No commits in common. "main" and "v4.2.1" have entirely different histories.
@ -1,90 +0,0 @@
|
||||
# AI Release Guide (Gitea)
|
||||
|
||||
Diese Datei ist die verbindliche Anleitung fuer KI-Agenten, um Releases fuer dieses Projekt zu erstellen.
|
||||
|
||||
## Zielsystem
|
||||
|
||||
- Git Host: `https://git.24-music.de`
|
||||
- Repo: `Administrator/Twitch-VOD-Manager`
|
||||
- Default Branch: `main`
|
||||
- Release-Assets muessen auf Gitea liegen, nicht auf GitHub/Codeberg.
|
||||
|
||||
## Sicherheitsregeln
|
||||
|
||||
- Token niemals in Dateien committen.
|
||||
- Token niemals in Logs, README oder Code schreiben.
|
||||
- Nur als Environment Variable nutzen:
|
||||
- PowerShell: ``$env:GITEA_TOKEN="<token>"``
|
||||
- Wenn Token kompromittiert wirkt: sofort rotieren.
|
||||
|
||||
## Voraussetzungen vor Release
|
||||
|
||||
1. `origin` muss auf Gitea zeigen:
|
||||
- `https://git.24-music.de/Administrator/Twitch-VOD-Manager.git`
|
||||
2. Working Tree darf keine ungewollten Aenderungen enthalten.
|
||||
3. DNS fuer `git.24-music.de` muss auf `159.195.45.29` aufloesen.
|
||||
4. Die App verwendet Gitea-Updater-URLs:
|
||||
- In `src/main.ts` via `GITEA_*` Konstanten/API.
|
||||
- In `package.json`:
|
||||
- `"build.publish.url": "https://git.24-music.de/Administrator/Twitch-VOD-Manager/releases/download/v${version}/"`
|
||||
|
||||
## Standardablauf fuer neues Release
|
||||
|
||||
Beispiel fuer `4.2.2`.
|
||||
|
||||
1. Version setzen:
|
||||
- `npm version 4.2.2 --no-git-tag-version`
|
||||
2. Build + Schnelltest:
|
||||
- `npm run build`
|
||||
- `npm run test:e2e:update-logic`
|
||||
3. Windows Installer bauen:
|
||||
- `npx electron-builder --win`
|
||||
4. Pruefen, dass Dateien existieren:
|
||||
- `release/Twitch-VOD-Manager-Setup-4.2.2.exe`
|
||||
- `release/Twitch-VOD-Manager-Setup-4.2.2.exe.blockmap`
|
||||
- `release/latest.yml`
|
||||
5. Commit + Tag:
|
||||
- `git add package.json package-lock.json`
|
||||
- `git commit -m "release: 4.2.2"`
|
||||
- `git tag v4.2.2`
|
||||
6. Push:
|
||||
- `git push origin main`
|
||||
- `git push origin v4.2.2`
|
||||
7. Release auf Gitea anlegen und Assets hochladen (API):
|
||||
- Endpoint: `POST /api/v1/repos/Administrator/Twitch-VOD-Manager/releases`
|
||||
- Endpoint: `POST /api/v1/repos/Administrator/Twitch-VOD-Manager/releases/{id}/assets?name=<file>`
|
||||
8. Verifikation:
|
||||
- `GET /api/v1/repos/Administrator/Twitch-VOD-Manager/releases/latest` muss `v4.2.2` liefern.
|
||||
- Download-Links muessen `200` geben:
|
||||
- `/releases/download/v4.2.2/latest.yml`
|
||||
- `/releases/download/v4.2.2/Twitch-VOD-Manager-Setup-4.2.2.exe`
|
||||
|
||||
## Verbindliche Asset-Regel
|
||||
|
||||
Pro aktuellem Release muessen mindestens diese 3 Dateien vorhanden sein:
|
||||
|
||||
- `Twitch-VOD-Manager-Setup-<version>.exe`
|
||||
- `Twitch-VOD-Manager-Setup-<version>.exe.blockmap`
|
||||
- `latest.yml`
|
||||
|
||||
Ohne diese Dateien funktioniert der Auto-Updater nicht zuverlaessig.
|
||||
|
||||
## Script-Hinweis
|
||||
|
||||
Es gibt ein Script: `scripts/release_gitea.mjs` (npm: `release:gitea`).
|
||||
|
||||
- Vor Nutzung sicherstellen, dass:
|
||||
- `GITEA_TOKEN` gesetzt ist.
|
||||
- `origin` korrekt ist.
|
||||
- der Tag existiert oder der Workflow diesen sauber erstellt.
|
||||
|
||||
Wenn das Script fehlschlaegt, immer auf den manuellen Standardablauf oben zurueckfallen.
|
||||
|
||||
## DNS/Netzwerk Fallback (nur wenn lokal noetig)
|
||||
|
||||
Wenn lokales DNS noch alt cached und Requests fehlschlagen, HTTP-Tests mit erzwungener Aufloesung:
|
||||
|
||||
- `curl --resolve git.24-music.de:443:159.195.45.29 https://git.24-music.de/api/v1/version`
|
||||
|
||||
Nur fuer Tests nutzen, nicht als dauerhaften Workaround.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user