6.1 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 → 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 | 86.316 (85.960 unique Checksums) — Stand 10.10. nach NAS-Ingest |
| Storage | cephfs-PVC 500Gi (Library ~365 G, 73 %), 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 (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(pathclusters/main/immich/rendered, Workloads) +immich-config(pathclusters/main/immichOHNE recurse, Namespace/StorageClasses/PVCs/Externalsecrets/Ingress/DB) - Nie wieder
recurse: trueauf 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 ausargocd-initial-admin-secret) — Tracking-Label-Diff = App-Kollisions-Fingerprint status.resourceskann Stale-Einträge zeigen; Wahrheit =argocd app diffÜbergangs-Freeze auf immich-configAufgehoben 10.10. (Commit3ec6327): selfHeal+prune scharf nach bewiesenem Label-Sweep — Ownership-Krieg endgültig beendet (Commits 57cfa65+497aa34+3ec6327)
GitOps-Upgrade-Rezept (bewährt)
clusters/main/immich/values.yaml: Image-Tags patchen (3 Stellen: controllers.main + explizite Repos server/ML)clusters/main/immich/rendered/all.yaml: 2 Image-Zeilen (server + machine-learning) mitpatchen- Commit + Push zu Remote
canonical→ ArgoCD selfHeal rollt automatisch - Verifikation:
kubectl -n immich get deploy(Images:v3.3.1) → Public-API/api/server/versionerst NACH Endpoint-Wechsel aussagekräftig (alter Pod bleibt sonst im Pool) - Sicherheitsnetz: Restic-Backup gleicher Tag 04:09
Bekannte Mess-Pitfalls (Schema-Versionen!)
- v3.x: Tabelle
exif, SpaltefileSizeByte; v2.6.3-Legacy: Tabelleasset_exif, SpaltefileSizeInByte— Spalten-/Tabellennamen vor jeder Query erst viainformation_schemaverifizieren - 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)
- Pre-Flight: aktive Connections auf Published Port 2283 prüfen (
ss -tn established) — nur bei 0 stilllegen - Graceful Stops in Order: server → ML → redis → postgres
docker update --restart=noje Container (compose-file NICHT anfassen — dort stehen nochrestart: always, eincompose up -dwürde alles wieder hochfahren)- Verify:
docker inspectstatus+restart-policy je Container,docker pszeigt 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 CT111GEFICKT 09.10. (Loki-LB .207 restauriert, Commit fb4d8b9; journald-Cap 200M airbag) — siehe systems/loki-fluentbitFoto-Ingest NAS → K8sKOMPLETT 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 reaktivierenERLEDIGT 10.10. (Commit3ec6327): selfHeal+prune scharf nach bewiesenem Label-Sweep (kein Objekt trägt mehr das Tracking-Label); beide Apps Synced/Healthy, kein Ping-Pong. Präzedenz: Vorprune:truenach Ownership-Konsolidierung IMMER cluster-weiten Label-Sweep machen —status.resourcesder 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-KeysPlaintext-Keys vernichtet 10.10. (NAS keys.env + lokale Kopie gelöscht); Key-Records leben in DB, Re-Mint jederzeit via decode()-Insert möglichnas-ingest-d/s
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)