68 lines
4.9 KiB
Markdown
68 lines
4.9 KiB
Markdown
# Immich — Foto/Video-Management
|
|
|
|
> **Status 2026-10-09:** K8s-Immich (v3.3.1) ist **alleinige Produktion** für `photos.familie-schoen.com`. Legacy-Immich auf CT111 (v2.6.3) nach Reconciliation **stillgelegt** (Container gestoppt, Autostart aus, Daten unangetastet).
|
|
|
|
## Produktion: K8s-Immich (v3.3.1)
|
|
|
|
| Eigenschaft | Wert |
|
|
|---|---|
|
|
| URL | `https://photos.familie-schoen.com` → Traefik-LB 10.0.30.203 → K8s |
|
|
| Namespace | `immich` |
|
|
| Version | v3.3.1 (Upgrade von v3.2.2 am 09.10. via GitOps, Commit `3ff08c4`) |
|
|
| Assets | **56.887** (56.531 unique Checksummen) |
|
|
| Storage | cephfs-PVC 500Gi (Library ~188 G), tägliches Restic-Backup 04:09 (218,8 GiB, 14 Snapshots) |
|
|
| ArgoCD-App | `immich`, Path `clusters/main/immich/implemented`, Repo `canonical` (HEAD) |
|
|
| Deployments | `immich-server`, `immich-machine-learning`, `immich-valkey` |
|
|
| DB | `postgresql` namespace, `postgres-main-1`, DB `immich` (CNPG-managed) |
|
|
| DB-Zugriff | `kubectl -n postgres exec postgres-main-1 -- psql -U postgres -d immich` (nicht `-U immich`!) |
|
|
|
|
### GitOps-Anatomie (wichtig!)
|
|
- **ZWEI Apps teilen sich das Verzeichnis:** `immich` (path `clusters/main/immich/rendered`, Workloads) + `immich-config` (path `clusters/main/immich` OHNE recurse, Namespace/StorageClasses/PVCs/Externalsecrets/Ingress/DB)
|
|
- **Nie wieder `recurse: true` auf immich-config** — das ließ beide Apps dieselben Workloads verwalten → Tracking-Label-Krieg (13.353+ Heals, ewiges OutOfSync; behoben 09.10. via Commits 57cfa65+497aa34)
|
|
- Diagnose-Hebel bei OutOfSync: `argocd app diff <app>` im argocd-server-Pod (`--plaintext`, PW aus `argocd-initial-admin-secret`) — Tracking-Label-Diff = App-Kollisions-Fingerprint
|
|
- `status.resources` kann Stale-Einträge zeigen; Wahrheit = `argocd app diff`
|
|
- Übergangs-Freeze auf immich-config (prune:false/selfHeal:false) nach 24 h Stabilität reaktivieren
|
|
|
|
### GitOps-Upgrade-Rezept (bewährt)
|
|
1. `clusters/main/immich/values.yaml`: Image-Tags patchen (3 Stellen: controllers.main + explizite Repos server/ML)
|
|
2. `clusters/main/immich/rendered/all.yaml`: 2 Image-Zeilen (server + machine-learning) mitpatchen
|
|
3. Commit + Push zu Remote `canonical` → ArgoCD selfHeal rollt automatisch
|
|
4. Verifikation: `kubectl -n immich get deploy` (Images `:v3.3.1`) → Public-API `/api/server/version` erst NACH Endpoint-Wechsel aussagekräftig (alter Pod bleibt sonst im Pool)
|
|
5. Sicherheitsnetz: Restic-Backup gleicher Tag 04:09
|
|
|
|
### Bekannte Mess-Pitfalls (Schema-Versionen!)
|
|
- v3.x: Tabelle `exif`, Spalte `fileSizeByte`; v2.6.3-Legacy: Tabelle `asset_exif`, Spalte `fileSizeInByte` — Spalten-/Tabellennamen vor jeder Query erst via `information_schema` verifizieren
|
|
- psql-Fehlerzeilen in SSH+dockexec-Pipelines sehen aus wie Datensätze — stderr nie wegmaskieren, Counts gegen Roh-Count-Queries kreuzvalidieren
|
|
|
|
## Legacy-Immich auf CT111 (stillgelegt 2026-10-09)
|
|
|
|
| Eigenschaft | Wert |
|
|
|--- verwende ---|---|
|
|
| Host | CT111 = 10.0.30.99 (Proxmox-CT, Root-FS /dev/rbd1 49 G) |
|
|
| Version | v2.6.3, Docker-Compose `/opt/immich/docker-compose.yml` |
|
|
| Assets | 53.613 (53.257 unique; 356 Dubletten) — **vollständige Teilmenge von K8s, formal bewiesen** |
|
|
| Container | `immich_server`, `immich_machine_learning`, `immich_redis`, `immich_postgres` — alle `exited`, `restart=no` |
|
|
| Daten | unangetastet: `/mnt/data/immich-library` (344 G, eigenes RBD), `/mnt/data/immich-postgres` (1,4 G, Root-FS) |
|
|
| Seafile-Stack | derselbe CT, UNBERÜHRT (seafile, seafile-redis, seafile-memcached, seafile-mysql, seadoc, ideogram4-api) |
|
|
|
|
### Stilllegungs-Rezept (nachvollziehbar)
|
|
1. Pre-Flight: aktive Connections auf Published Port 2283 prüfen (`ss -tn established`) — nur bei 0 stilllegen
|
|
2. Graceful Stops in Order: server → ML → redis → postgres
|
|
3. `docker update --restart=no` je Container (compose-file NICHT anfassen — dort stehen noch `restart: always`, ein `compose up -d` würde alles wieder hochfahren)
|
|
4. Verify: `docker inspect` status+restart-policy je Container, `docker ps` zeigt nur noch Seafile-Stack
|
|
|
|
### Rollback jederzeit möglich
|
|
`docker start immich_postgres immich_redis immich_machine_learning immich_server` (Reihenfolge!) + `docker update --restart=always …` — Daten unberührt.
|
|
|
|
## Offene Punkte
|
|
- **fluent-bit-Journal-Flut auf CT111:** Loki 10.0.30.207:3100 unreachable → Journal wächst wieder. Fix: Loki-Routing oder journald-Drop-In `SystemMaxUse=200M`.
|
|
- Foto-Ingest NAS → K8s (305 G Dominik + 119 G Sarah) gegen 56.887 Bestandsassets dedupen — nächster Migrationsschritt
|
|
- Endgültige Dekommissionierung (Volumes/DB/Images) separat genehmigen; bis dahin bleibt alles liegen
|
|
- CT111-Disk-Reserven: ~15,6 GB ungenutzte getaggte Images + diverse Volumes — nur mit Freigabe
|
|
|
|
## Verweise
|
|
- [[systems/seafile]] — Dokumente/Archive-Ziel der Home-Migration
|
|
- [[systems/ceph-cluster]] — cephfs-PVC der K8s-Instanz
|
|
- [[systems/rke2-kubernetes]] — Cluster-Anatomie
|
|
- Solution-Doc: `docs/solutions/workflows/2026-10-09-immich-legacy-decommission-prep.md`
|