Files
memory/systems/immich.md
T
2026-10-09 22:00:10 +00:00

4.9 KiB

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