Files
memory/systems/immich.md
T

6.7 KiB

Immich — Foto/Video-Management

Status 2026-10-10: 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). NAS-Foto-Ingest 09./10.10. KOMPLETT: 29.423 neue Files (78,2 GB) via API-Upload, Reconciliation 0 fehlend.

Produktion: K8s-Immich (v3.3.1)

Eigenschaft Wert
URL https://photos.familie-schoen.com → WAN-Traefik CT99999 photos-Router → 10.0.30.203 (K8s traefik-lb) → IngressRoute immich/immich → immich-server:2283
Alt-Host immich.familie-schoen.com → 301-Redirect auf photos (WAN-Middleware immich-to-photos, 30.10.26). Legacy-Route auf CT111 .99:2283 damit entfallen
Namespace immich
Version v3.3.1 (Upgrade von v3.2.2 am 09.10. via GitOps, Commit 3ff08c4)
Assets 86.316 (85.960 unique Checksums) — Stand 10.10. nach NAS-Ingest
Storage pv-fuse-immich-library (500Gi CephFS, statisches PV mit mounter: fuse, seit 31.10.26) + pv-fuse-immich-thumbs (100Gi); Subvolume csi-vol-305a46d8… unverändert. tägliches Restic-Backup 04:09 (218,8 GiB, 14 Snapshots)
⚠️ CephFS-Mount Kernel-CephFS unbrauchbar (aes256k 32 B vs. 16-B-Limit) → Fuse-Mounter. Details systems/rke2-kubernetes.md. P1-Ausfall 31.10.: Immich 503, 8 Pods blockiert → nach Fuse-Umstellung 200
ArgoCD-App immich, Path clusters/main/immich/implemented, Repo canonical (HEAD)
Deployments immich-server (6Gi-Limit, 2Gi-Req, pinned rke2-worker-01 — OOM-Fix 10.10., Commit 6ce2a0a), 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 Aufgehoben 10.10. (Commit 3ec6327): selfHeal+prune scharf nach bewiesenem Label-Sweep — Ownership-Krieg endgültig beendet (Commits 57cfa65+497aa34+3ec6327)

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 GEFICKT 09.10. (Loki-LB .207 restauriert, Commit fb4d8b9; journald-Cap 200M airbag) — siehe systems/loki-fluentbit
  • Foto-Ingest NAS → K8s KOMPLETT 10.10.: 29.423 Files / 78,2 GB (d 27.966 + s 1.436), Reconciliation 0 fehlend; Artefakte ~/home-drilldown/census/; Rest: Grayzone 559 Files bewusst draußen, 5 RAWs mit dcraw-Thumbnail-Fehlern (Originale intakt)
  • immich-config-Freeze reaktivieren ERLEDIGT 10.10. (Commit 3ec6327): selfHeal+prune scharf nach bewiesenem Label-Sweep (kein Objekt trägt mehr das Tracking-Label); beide Apps Synced/Healthy, kein Ping-Pong. Präzedenz: Vor prune:true nach Ownership-Konsolidierung IMMER cluster-weiten Label-Sweep machen — status.resources der App kann stale Workload-Einträge zeigen.
  • Endgültige Dekommissionierung Legacy (Volumes/DB/Images) separat genehmigen; bis dahin bleibt alles liegen
  • CT111-Disk-Reserven: ~15,6 GB ungenutzte getaggte Images + diverse Volumes — nur mit Freigabe
  • NAS-Ingest-Keys nas-ingest-d/s Plaintext-Keys vernichtet 10.10. (NAS keys.env + lokale Kopie gelöscht); Key-Records leben in DB, Re-Mint jederzeit via decode()-Insert möglich

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
  • Solution-Doc: docs/solutions/workflows/2026-10-10-immich-nas-ingest-api-upload.md (Massen-Upload-Rezept: Manifest+x-immich-checksum+Checkpoint)