docs: CI-Desktop-Bau nur bei geaendertem Desktop-Stand — Betriebshandbuch, CI-Runbook, Entwicklungsanleitung, CHANGELOG
- anleitung-betrieb.md Kap. 10: neuer Unterabschnitt "Wann gebaut wird und wann Pakete uebernommen werden", Job-Dauer-Satz und Fehlerbilder-Tabelle ergaenzt - ci-cd-setup.md Abschnitt 4: Absatz zum Ueberspringen bei unveraendertem Desktop; Abschnitt 6: neuer Fehlerbehebungs-Eintrag - anleitung-entwicklung.md: Absatz zum CI-Ueberspringen bei "Desktop-App lokal bauen" - CHANGELOG.md: ein Stichpunkt unter Unveroeffentlicht/Geaendert Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -570,7 +570,37 @@ Der Rust-Bau ist auf vier parallele Prozesse begrenzt (`CARGO_BUILD_JOBS`),
|
||||
weil sich der Runner den Rechner mit Gitea und dem Entwicklungs-Stack teilt;
|
||||
mit acht Prozessen geriet ein Rechner mit 15 GB Arbeitsspeicher an die Grenze.
|
||||
Der Job dauert damit etwa fünf bis sieben Minuten (mit warmem Zwischenspeicher),
|
||||
der erste Lauf nach einer Änderung der Abhängigkeiten deutlich länger.
|
||||
der erste Lauf nach einer Änderung der Abhängigkeiten deutlich länger – sofern überhaupt gebaut wird, siehe nächster Abschnitt.
|
||||
|
||||
### Wann gebaut wird und wann Pakete übernommen werden
|
||||
|
||||
Seit September 2026 baut die Pipeline die Desktop-Pakete auf dem Beta-Kanal
|
||||
nur noch, wenn sich an der Desktop-App etwas geändert hat. Maßgeblich ist ein
|
||||
Stempel aus der Versionsnummer des letzten Freigabe-Tags und dem letzten
|
||||
Commit an den Desktop-Pfaden (`apps/desktop/`, die Skripte
|
||||
`desktop-version.sh`, `desktop-collect.sh`, `desktop-stamp.sh`, die
|
||||
Workflow-Datei `ci.yml`). Liegen zu diesem Stempel fertige Pakete im
|
||||
Zwischenspeicher des Runners, übernimmt der Job sie unverändert; die
|
||||
Bau-Schritte entfallen, und der Job braucht dann unter einer Minute. Im
|
||||
Protokoll steht dann eine Zeile wie „Desktop unveraendert seit
|
||||
<Commit>: Pakete … aus dem Zwischenspeicher".
|
||||
|
||||
Drei Regeln dazu:
|
||||
|
||||
- Freigabe-Tags bauen immer – die Release-Dateien entstehen frisch mit reiner
|
||||
Versionsnummer.
|
||||
- Nach einer Freigabe wird einmal neu gebaut, auch ohne Änderung an der
|
||||
Desktop-App, weil die Versionsnummer zum Stempel gehört; die Beta-Pakete
|
||||
tragen danach die neue Basisversion.
|
||||
- Übernommene Pakete tragen den Stand ihres Baus – Dateiname (`-beta.<Commit>`)
|
||||
und Manifest nennen den Commit des Baus, nicht den des aktuellen Abbilds.
|
||||
Das ist gewollt: ein Client dieses Standes bekommt keinen unnötigen Hinweis
|
||||
auf einen neuen Beta-Stand, ein älterer Client weiterhin.
|
||||
|
||||
Fehlt der Eintrag im Zwischenspeicher (der Runner räumt ungenutzte Einträge
|
||||
nach einigen Tagen, alte nach etwa einem Monat weg) oder ist er unvollständig,
|
||||
wird ganz normal gebaut – die Pipeline prüft vor der Übernahme Manifest,
|
||||
Kanal, Version, Dateinamen, Größen und Prüfsummen.
|
||||
|
||||
### Wo die Pakete im Abbild liegen
|
||||
|
||||
@@ -621,3 +651,4 @@ Für die Desktop-Auslieferung ist keine neue Pflichtvariable nötig.
|
||||
| Download bricht bei großen Dateien ab | Größengrenze oder Zeitlimit des vorgeschalteten Proxys (Nginx Proxy Manager) – `client_max_body_size` bzw. Timeout-Einstellungen | Proxy-Konfiguration für die betroffene Adresse prüfen und die Grenze anheben. |
|
||||
| Client meldet „Unter dieser Adresse antwortet kein Tessera-Server" | Anwender hat die interne API-Adresse statt der Web-Adresse eingetragen, oder `/api-proxy` ist vom Client-Rechner aus nicht erreichbar | Die im Anwenderhandbuch beschriebene Adresse verwenden (dieselbe wie im Browser); Netzwerk-/Firewall-Erreichbarkeit der Web-Adresse prüfen. |
|
||||
| Windows zeigt die SmartScreen-Warnung | Erwartet – die App ist für den internen Gebrauch nicht signiert (D-09) | Kein Fehler; Anwenderhandbuch, Abschnitt „Installation unter Windows", beschreibt den Ablauf. |
|
||||
| Beta-Paket nennt einen älteren Commit als das laufende Abbild (Dateiname `-beta.<Commit>`, Einstellungen → Desktop-App) | Erwartet: Desktop-App seit diesem Commit unverändert, Pakete aus dem Zwischenspeicher übernommen (Abschnitt „Wann gebaut wird …") | Kein Fehler. Soll dennoch neu gebaut werden, genügt eine Änderung unter `apps/desktop/` im nächsten Push. |
|
||||
|
||||
Reference in New Issue
Block a user