Files
LTX-DeskWEB/docs/CONTAINER_REGISTRY.md
T

77 lines
3.2 KiB
Markdown

# Fertiges Image vom Git-Server beziehen
Die Container Registry ist ein separater Paketbereich desselben Git-Servers.
Images gehören nicht als große Binärdateien in die Git-Historie. Der Quellcode,
Dockerfile und die Compose-Dateien bleiben im Repository.
## Aktueller Veröffentlichungsstand
Veröffentlicht am 29. September 2026:
`git.casaderoll.de/michael/ltx-deskweb:0.1.0-9ff96db`
Architektur: **linux/amd64** (Athena / Debian auf x86-64).
Quellstand: `9ff96db`, einschließlich der Upload-Rechte und der Browser-Höhenkorrektur.
Registry-Digest (OCI-Index):
`sha256:3555ed4c826ef0b0f613edf4fcffa52e951fe772fb99c1b642787f4dfd952869`
Push, Registry-Manifest und authentifizierter Pull wurden erfolgreich geprüft.
Der Pull-Test erfolgte auf Athena mit bereits vorhandenen Layern; ein Download
auf einem vollständig leeren Host wurde nicht separat ausgeführt.
Direkt herunterladen:
```sh
docker pull git.casaderoll.de/michael/ltx-deskweb:0.1.0-9ff96db
```
## Manuelle Installation ohne lokalen Image-Build
Repository klonen und `.env`, Secrets sowie gemeinsame Medienverzeichnisse wie
in README.md beschrieben einrichten. Zugangsdaten niemals in Git speichern.
Bei privaten Paketen auf dem Zielserver interaktiv anmelden:
```sh
docker login git.casaderoll.de --username michael
```
Ein eventuell verwendeter Zugriffstoken benötigt zum Veröffentlichen
Paket-Schreibrechte, zum Herunterladen Leserechte. Rechteumfang und Sichtbarkeit
im Git-Server prüfen; die Anwendung nicht unbeabsichtigt öffentlich freigeben.
Passwort/Token interaktiv eingeben, nicht als Befehlsargument oder Chatnachricht.
Fertiges Image herunterladen und starten:
```sh
docker compose -f compose.yaml -f compose.registry.yaml pull ltx-deskweb
docker compose -f compose.yaml -f compose.registry.yaml up -d --no-build ltx-deskweb
```
Für Athenas bestehende Loopback-Verbindung zusätzlich das Host-Override verwenden:
```sh
docker compose -p ltx-deskweb -f compose.yaml -f compose.registry.yaml \
-f deploy/compose.athena.yaml pull ltx-deskweb
docker compose -p ltx-deskweb -f compose.yaml -f compose.registry.yaml \
-f deploy/compose.athena.yaml up -d --no-build --no-deps ltx-deskweb
```
Die Deck-Labels werden aus compose.yaml übernommen. Dieser Container enthält nur
die GUI, ihren Webdienst und ffmpeg, keine LTX-Modelle oder GPU-Laufzeit. Diese
Anleitung ersetzt nicht die separate Einrichtung des LTX-Backends.
## Versionen veröffentlichen
- Geprüften Quellstand bauen und mit eindeutiger Version/Commit-Kennung markieren.
- Image in `git.casaderoll.de/michael/ltx-deskweb` pushen.
- Registry-Manifest und Digest prüfen; anschließend Pull testen.
- Veröffentlichten Digest und Tests hier bzw. in den Release-Notizen dokumentieren.
- Versionstags nicht mit späteren Builds überschreiben; keine unkontrollierten
Produktivupdates über `latest`.
- Für eine neue Version `LTX_DESKWEB_IMAGE` in `.env` auf den geprüften Tag oder
`git.casaderoll.de/michael/ltx-deskweb@sha256:...` setzen.
Ein fertiges Image muss nicht von der Zielmaschine gebaut werden. Ein zukünftiger
CI-Workflow kann das Bauen und Veröffentlichen übernehmen; ein solcher Workflow
ist derzeit noch nicht eingerichtet. Upgrade-Ablauf: [UPGRADE_INFO.md](UPGRADE_INFO.md).