71 lines
6.1 KiB
Markdown
71 lines
6.1 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` → 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` (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)
|