Files

73 lines
6.7 KiB
Markdown

# 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)