refactor(k8s): schlanker Umfang, Postgres und Medien auf SMB
Docker-Images bauen und veroeffentlichen / build-and-push (push) Successful in 2m17s

Auf Wunsch des Betreibers auf das Noetige reduziert: StatefulSet
PostgreSQL, Services, Ingress, App-Deployment, zwei SMB-PersistentVolumes
(Postgres-Daten, Medien). Beibehalten nach Absprache: Worker-CronJob
(Folgeraten, Reservierungsfreigabe, Mail-Wiederholung), ConfigMap und die
NetworkPolicies (Sicherheitsbefund Rate-Limit-Umgehung).

- Migration als initContainer im App-Deployment statt eigenem Job
- Entfernt: Backup-CronJob/-Volume (NAS sichert die Freigabe),
  Migrations-CronJob, PodDisruptionBudget, HTTP-Redirect-Ingress und
  Middleware, Namespace-Objekt (einmalig von Hand anzulegen)
- PostgreSQL auf SMB als bewusste, dokumentierte Ausnahme mit
  hard, cache=strict, SMB 3.1.1 + seal, uid 70 / 0700

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
This commit is contained in:
Nick SzaunigandClaude Opus 5.5 committed 2026-09-27 20:36:30 +02:00
1 parent 974c403a8b
commit c84eb1e740
12 files changed
+200 -327

No files matched your search

+16 -12
View File
@@ -2,8 +2,10 @@
# Reservierungen, Rate Limits, E-Mail-Ausgang und Zahlungsjobs liegen in
# PostgreSQL — beliebig viele Replikate moeglich.
#
# Migrationen laufen NICHT beim Start, sondern als eigener, kontrollierter
# Schritt (jobs.yaml, CronJob "artista-modelcamp-migrate", siehe docs/BETRIEB.md).
# Migrationen laufen als eigener Schritt VOR dem App-Container: initContainer
# "migrate" (Werkzeug-Image, `prisma migrate deploy`). Scheitert er, startet
# die App nicht. Mehrere Replikate gleichzeitig sind unkritisch — Prisma
# serialisiert Migrationen ueber eine Datenbank-Sperre.
apiVersion: apps/v1
kind: Deployment
metadata:
@@ -37,6 +39,18 @@ spec:
labelSelector:
matchLabels:
app.kubernetes.io/name: artista-modelcamp-app
initContainers:
- name: migrate
image: artista-modelcamp-tools
command: ["prisma", "migrate", "deploy"]
envFrom:
- secretRef: { name: artista-modelcamp-secrets }
resources:
requests: { cpu: 50m, memory: 128Mi }
limits: { memory: 512Mi }
securityContext:
allowPrivilegeEscalation: false
capabilities: { drop: ["ALL"] }
containers:
- name: app
image: artista-modelcamp
@@ -117,13 +131,3 @@ spec:
- port: 3000
# Kubelet-Probes kommen vom Knoten und sind von NetworkPolicies je nach
# CNI (Canal/Calico in RKE2) ausgenommen.
---
apiVersion: policy/v1
kind: PodDisruptionBudget
metadata:
name: artista-modelcamp-app
spec:
minAvailable: 1
selector:
matchLabels:
app.kubernetes.io/name: artista-modelcamp-app
+5 -27
View File
@@ -1,11 +1,7 @@
apiVersion: v1
kind: Namespace
metadata:
name: artista
labels:
# Pod Security Admission: nur eingeschraenkte (non-root) Pods.
pod-security.kubernetes.io/enforce: restricted
---
# Der Namespace "artista" wird einmalig von Hand angelegt:
# kubectl create namespace artista
# kubectl label namespace artista pod-security.kubernetes.io/enforce=restricted
#
# Nicht geheime Einstellungen. Geheimnisse: k8s/secret.example.yaml.
apiVersion: v1
kind: ConfigMap
@@ -23,26 +19,8 @@ data:
MEDIA_DIR: "/app/media"
EXTERNAL_VIDEO_PROVIDER: "none"
---
# Freigegebene Bilder und Videos (Unterkunft, Portraets, Feedback-Videos).
# Dauerhaft, deshalb ein PersistentVolumeClaim und KEIN emptyDir.
#
# ReadWriteMany, weil mehrere App-Replikate dasselbe Verzeichnis lesen.
# Geeignet: z. B. Longhorn (RWX), NFS oder eine SMB/CSI-Freigabe — fuer
# Medien ist ein Netzwerkdateisystem unkritisch (anders als fuer PostgreSQL).
# Steht nur ReadWriteOnce zur Verfuegung: replicas im Deployment auf 1 setzen.
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: artista-modelcamp-media
spec:
accessModes: ["ReadWriteMany"]
# storageClassName: longhorn
resources:
requests:
storage: 5Gi
---
# Die Datenbank ist nur fuer Pods mit dem Label artista/db-client erreichbar
# (App, Migration, Worker, Sicherung).
# (App inkl. Migrations-initContainer, Worker).
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
-159
View File
@@ -1,159 +0,0 @@
# --- Migration ----------------------------------------------------------------
# Als SUSPENDIERTER CronJob definiert, damit Kustomize das Image mit der
# App gleichzieht. Er laeuft nie von selbst, sondern bewusst vor jedem
# Rollout:
# kubectl -n artista create job migrate-$(date +%Y%m%d%H%M) --from=cronjob/artista-modelcamp-migrate
# kubectl -n artista wait --for=condition=complete job/migrate-… --timeout=5m
apiVersion: batch/v1
kind: CronJob
metadata:
name: artista-modelcamp-migrate
spec:
suspend: true
schedule: "0 0 1 1 *"
jobTemplate:
spec:
backoffLimit: 0
ttlSecondsAfterFinished: 86400
template:
metadata:
labels:
artista/db-client: "true"
spec:
restartPolicy: Never
automountServiceAccountToken: false
securityContext:
runAsNonRoot: true
runAsUser: 1001
seccompProfile: { type: RuntimeDefault }
containers:
- name: migrate
image: artista-modelcamp-tools
command: ["prisma", "migrate", "deploy"]
envFrom:
- secretRef: { name: artista-modelcamp-secrets }
resources:
requests: { cpu: 50m, memory: 128Mi }
limits: { memory: 512Mi }
securityContext:
allowPrivilegeEscalation: false
capabilities: { drop: ["ALL"] }
---
# --- Worker -------------------------------------------------------------------
# Gibt abgelaufene Reservierungen frei (nach Rueckfrage bei Stripe), zieht
# faellige Raten ein, trennt Zahlungsmethoden nach der letzten Rate,
# versendet den E-Mail-Ausgang. Idempotent; Forbid verhindert
# ueberlappende Laeufe zusaetzlich.
apiVersion: batch/v1
kind: CronJob
metadata:
name: artista-modelcamp-worker
spec:
schedule: "*/10 * * * *"
timeZone: "Europe/Berlin"
concurrencyPolicy: Forbid
startingDeadlineSeconds: 300
successfulJobsHistoryLimit: 3
failedJobsHistoryLimit: 5
jobTemplate:
spec:
backoffLimit: 1
activeDeadlineSeconds: 900
template:
metadata:
labels:
artista/db-client: "true"
spec:
restartPolicy: Never
automountServiceAccountToken: false
securityContext:
runAsNonRoot: true
runAsUser: 1001
seccompProfile: { type: RuntimeDefault }
containers:
- name: worker
image: artista-modelcamp-tools
command: ["tsx", "scripts/worker.ts"]
envFrom:
- configMapRef: { name: artista-modelcamp-config }
- secretRef: { name: artista-modelcamp-secrets }
resources:
requests: { cpu: 50m, memory: 192Mi }
limits: { memory: 512Mi }
securityContext:
allowPrivilegeEscalation: false
capabilities: { drop: ["ALL"] }
---
# --- Sicherung ----------------------------------------------------------------
# Taeglicher pg_dump mit 30 Tagen Aufbewahrung. Das Backup-Volume darf ein
# Netzwerkspeicher (NFS/SMB) sein. Zusaetzlich regelmaessig aus dem Cluster
# kopieren (docs/BETRIEB.md, "Sicherung und Wiederherstellung").
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: artista-modelcamp-db-backup
spec:
accessModes: ["ReadWriteOnce"]
# storageClassName: smb-backup
resources:
requests:
storage: 10Gi
---
apiVersion: batch/v1
kind: CronJob
metadata:
name: artista-modelcamp-db-backup
spec:
schedule: "15 3 * * *"
timeZone: "Europe/Berlin"
concurrencyPolicy: Forbid
failedJobsHistoryLimit: 5
jobTemplate:
spec:
backoffLimit: 2
template:
metadata:
labels:
artista/db-client: "true"
spec:
restartPolicy: OnFailure
automountServiceAccountToken: false
securityContext:
runAsNonRoot: true
runAsUser: 70
runAsGroup: 70
fsGroup: 70
seccompProfile: { type: RuntimeDefault }
containers:
- name: pg-dump
# Gleiche Hauptversion wie der Server.
image: postgres:18.1-alpine
env:
- name: PGPASSWORD
valueFrom:
secretKeyRef: { name: artista-modelcamp-secrets, key: DB_PASSWORD }
command: ["/bin/sh", "-c"]
args:
- |
set -eu
set -o pipefail
target="/backup/artista-$(date -u +%Y-%m-%d_%H%M).dump"
# Custom-Format: komprimiert, selektiv wiederherstellbar.
pg_dump --host=artista-modelcamp-postgres --username=artista --dbname=artista \
--format=custom --file="${target}.partial"
mv "${target}.partial" "${target}"
find /backup -name 'artista-*.dump.partial' -mtime +1 -delete
find /backup -name 'artista-*.dump' -mtime +30 -delete
ls -lh /backup
resources:
requests: { cpu: 50m, memory: 128Mi }
limits: { memory: 256Mi }
securityContext:
allowPrivilegeEscalation: false
capabilities: { drop: ["ALL"] }
volumeMounts:
- name: backup
mountPath: /backup
volumes:
- name: backup
persistentVolumeClaim: { claimName: artista-modelcamp-db-backup }
+2 -1
View File
@@ -5,9 +5,10 @@ kind: Kustomization
namespace: artista
resources:
- config.yaml
- storage.yaml
- postgres.yaml
- app.yaml
- jobs.yaml
- worker.yaml
labels:
- pairs:
app.kubernetes.io/part-of: artista-modelcamp
+15 -20
View File
@@ -1,14 +1,11 @@
# PostgreSQL fuer Buchungen, Zahlungen, Gutscheine und Protokoll.
#
# SPEICHER: Blockspeicher mit ReadWriteOnce verwenden (z. B. Longhorn,
# local-path, Ceph RBD). KEINE SMB/CIFS-Freigabe als Datenverzeichnis:
# SMB bildet POSIX-Sperren, fsync-Garantien und Dateirechte nicht so ab,
# wie PostgreSQL sie fuer Absturzsicherheit voraussetzt — Datenverlust bei
# Stromausfall oder Neustart ist die Folge. Sicherungen (backup-CronJob)
# duerfen dagegen auf SMB/NFS liegen.
#
# Alternative fuer hoehere Verfuegbarkeit: CloudNativePG-Operator; dann
# dieses Manifest weglassen und DATABASE_URL auf dessen Service zeigen lassen.
# Datenverzeichnis: PVC "artista-modelcamp-postgres-data" (storage.yaml), im
# Produktions-Overlay auf SMB. Das ist eine BEWUSSTE, vom Betreiber
# akzeptierte Ausnahme von der Empfehlung "Blockspeicher": SMB garantiert
# Sperren und fsync nicht in jedem Fall wie ein lokales Dateisystem. Die
# Mount-Optionen in smb-volumes.yaml sind darauf ausgelegt; Risiken und
# Hinweise zur Sicherung stehen in docs/BETRIEB.md.
apiVersion: apps/v1
kind: StatefulSet
metadata:
@@ -24,11 +21,14 @@ spec:
labels:
app.kubernetes.io/name: artista-modelcamp-postgres
spec:
automountServiceAccountToken: false
# Beim Beenden sauber herunterfahren (Checkpoint), bevor das Volume
# ausgehaengt wird — auf Netzwerkspeicher besonders wichtig.
terminationGracePeriodSeconds: 120
securityContext:
runAsNonRoot: true
runAsUser: 70
runAsGroup: 70
fsGroup: 70
seccompProfile: { type: RuntimeDefault }
containers:
- name: postgres
@@ -52,23 +52,18 @@ spec:
periodSeconds: 5
livenessProbe:
exec: { command: ["pg_isready", "-U", "artista"] }
initialDelaySeconds: 30
initialDelaySeconds: 60
periodSeconds: 20
failureThreshold: 6
resources:
requests: { cpu: 100m, memory: 256Mi }
limits: { memory: 1Gi }
securityContext:
allowPrivilegeEscalation: false
capabilities: { drop: ["ALL"] }
volumeClaimTemplates:
- metadata:
name: data
spec:
accessModes: ["ReadWriteOnce"]
# storageClassName: longhorn
resources:
requests:
storage: 10Gi
volumes:
- name: data
persistentVolumeClaim: { claimName: artista-modelcamp-postgres-data }
---
apiVersion: v1
kind: Service
+27
View File
@@ -0,0 +1,27 @@
# Die beiden dauerhaften Speicher. Im Produktions-Overlay werden sie fest an
# die SMB-PersistentVolumes gebunden (k8s/overlays/production/smb-volumes.yaml).
# Eine separate Sicherung gibt es nicht: die SMB-Freigabe wird auf dem NAS
# selbst mehrfach gesichert.
# PostgreSQL-Datenverzeichnis.
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: artista-modelcamp-postgres-data
spec:
accessModes: ["ReadWriteOnce"]
resources:
requests:
storage: 10Gi
---
# Freigegebene Bilder und Videos. ReadWriteMany, weil mehrere App-Replikate
# lesen.
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: artista-modelcamp-media
spec:
accessModes: ["ReadWriteMany"]
resources:
requests:
storage: 5Gi
+43
View File
@@ -0,0 +1,43 @@
# Worker: gibt abgelaufene Reservierungen frei (nach Rueckfrage bei Stripe),
# zieht faellige Raten ein, trennt Zahlungsmethoden nach der letzten Rate und
# versendet den E-Mail-Ausgang. Ohne ihn laufen Ratenzahlung und
# Reservierungsfreigabe nicht. Idempotent; Forbid verhindert Ueberlappung.
apiVersion: batch/v1
kind: CronJob
metadata:
name: artista-modelcamp-worker
spec:
schedule: "*/10 * * * *"
timeZone: "Europe/Berlin"
concurrencyPolicy: Forbid
startingDeadlineSeconds: 300
successfulJobsHistoryLimit: 3
failedJobsHistoryLimit: 5
jobTemplate:
spec:
backoffLimit: 1
activeDeadlineSeconds: 900
template:
metadata:
labels:
artista/db-client: "true"
spec:
restartPolicy: Never
automountServiceAccountToken: false
securityContext:
runAsNonRoot: true
runAsUser: 1001
seccompProfile: { type: RuntimeDefault }
containers:
- name: worker
image: artista-modelcamp-tools
command: ["tsx", "scripts/worker.ts"]
envFrom:
- configMapRef: { name: artista-modelcamp-config }
- secretRef: { name: artista-modelcamp-secrets }
resources:
requests: { cpu: 50m, memory: 192Mi }
limits: { memory: 512Mi }
securityContext:
allowPrivilegeEscalation: false
capabilities: { drop: ["ALL"] }
+3 -33
View File
@@ -1,6 +1,8 @@
# Ingress fuer Traefik mit cert-manager.
# Anpassen: Host (auch in APP_URL, kustomization.yaml), ingressClassName
# Anpassen: Host (auch APP_URL in kustomization.yaml), ingressClassName
# ("kubectl get ingressclass"), ClusterIssuer, TLS-Secret-Name.
# HTTP->HTTPS-Umleitung erwartet dieses Manifest EntryPoint-weit in Traefik
# (Helm: ports.web.redirections.entryPoint.to=websecure).
#
# X-Forwarded-For/X-Real-Ip: Rate Limits verlassen sich darauf, dass Traefik
# vom Client mitgeschickte Werte verwirft. Dafuer im Traefik-EntryPoint
@@ -30,35 +32,3 @@ spec:
name: artista-modelcamp-app
port:
name: http
---
# HTTP -> HTTPS. Entfaellt, wenn Traefik das bereits EntryPoint-weit tut
# (Helm: ports.web.redirections.entryPoint.to=websecure).
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: artista-modelcamp-http-redirect
annotations:
traefik.ingress.kubernetes.io/router.entrypoints: web
traefik.ingress.kubernetes.io/router.middlewares: artista-artista-modelcamp-redirect-https@kubernetescrd
spec:
ingressClassName: traefik
rules:
- host: modelcamp.example.org
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: artista-modelcamp-app
port:
name: http
---
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
name: artista-modelcamp-redirect-https
spec:
redirectScheme:
scheme: https
permanent: true
+3 -3
View File
@@ -7,7 +7,7 @@ namespace: artista
resources:
- ../../base
- ingress.yaml
# Medien und Sicherungen auf SMB (PostgreSQL bewusst nicht, siehe Datei).
# PostgreSQL-Daten und Medien auf SMB.
# Ohne SMB: diese Zeile und die beiden PVC-Patches unten entfernen.
- smb-volumes.yaml
@@ -32,14 +32,14 @@ patches:
- op: add
path: /spec/volumeName
value: artista-modelcamp-media-smb
- target: { kind: PersistentVolumeClaim, name: artista-modelcamp-db-backup }
- target: { kind: PersistentVolumeClaim, name: artista-modelcamp-postgres-data }
patch: |-
- op: add
path: /spec/storageClassName
value: ""
- op: add
path: /spec/volumeName
value: artista-modelcamp-db-backup-smb
value: artista-modelcamp-postgres-smb
- target: { kind: ConfigMap, name: artista-modelcamp-config }
patch: |-
- op: replace
+53 -46
View File
@@ -6,22 +6,60 @@
# und das Zugangs-Secret "artista-modelcamp-smb" (k8s/secret.example.yaml).
#
# ANZUPASSEN: "source" (//<nas>/<freigabe>/<ordner>) je Volume. Die Ordner
# muessen auf der Freigabe bereits existieren.
# muessen auf der Freigabe bereits existieren; der Postgres-Ordner leer.
#
# BEWUSST NICHT AUF SMB: das PostgreSQL-Datenverzeichnis. SMB bildet
# POSIX-Sperren, fsync-Garantien und Dateirechte nicht so ab, wie PostgreSQL
# sie fuer Absturzsicherheit braucht (Briefing §13). Die Datenbank bleibt auf
# Blockspeicher und wird taeglich per pg_dump auf das Backup-Volume unten
# gesichert — damit liegen die Geschaeftsdaten trotzdem auf dem NAS.
#
# Rechte: fsGroup wirkt auf SMB nicht. Besitz und Rechte setzen deshalb
# uid/gid/dir_mode/file_mode in den mountOptions (Muster aus Wabenhain).
# Aenderungen an mountOptions greifen erst beim naechsten Einhaengen.
# reclaimPolicy Retain: Loeschen von PVC/PV laesst die Dateien auf dem NAS.
# Beide Verbindungen verschluesselt (SMB 3.1.1 + seal); das NAS muss
# SMB-Verschluesselung erlauben. fsGroup wirkt auf SMB nicht: Besitz und
# Rechte setzen uid/gid/dir_mode/file_mode. reclaimPolicy Retain: Loeschen
# von PVC/PV laesst die Dateien auf dem NAS.
# Keine eigene Sicherung im Cluster: die Freigabe wird auf dem NAS gesichert.
# --- Medien (Bilder/Videos) ----------------------------------------------------
# Die App liest nur (readOnly-Mount). Neue Bilder legst du direkt ueber die
# SMB-Freigabe ab, z. B. vom Windows-Explorer aus.
# --- PostgreSQL-Datenverzeichnis ------------------------------------------------
# BEWUSSTE AUSNAHME (Entscheidung des Betreibers): Datenbank auf SMB.
# Risiko: SMB garantiert Sperren/fsync nicht in jedem Fall wie ein lokales
# Dateisystem; bei Netzwerk- oder NAS-Ausfall waehrend Schreibvorgaengen kann
# die Datenbank beschaedigt werden. Die Optionen unten minimieren das:
# hard E/A wartet bei Netzstoerung statt Fehler an PostgreSQL zu
# melden (kein "soft"-Abbruch mitten im Schreiben)
# cache=strict strikte Cache-Kohaerenz, fsync geht bis zum Server
# nobrl keine Byte-Range-Locks (PostgreSQL braucht sie nicht)
# uid/gid 70, 0700/0600 PostgreSQL verlangt ein privates Datenverzeichnis
# Sicherung: nur NAS-Snapshots, die atomar sind (Btrfs/ZFS-Snapshot der ganzen
# Freigabe), sind fuer ein laufendes Datenverzeichnis konsistent. Einfaches
# Dateikopieren waehrend des Betriebs ergibt KEINE brauchbare Sicherung.
apiVersion: v1
kind: PersistentVolume
metadata:
name: artista-modelcamp-postgres-smb
spec:
capacity:
storage: 10Gi
accessModes: ["ReadWriteOnce"]
persistentVolumeReclaimPolicy: Retain
storageClassName: ""
mountOptions:
- vers=3.1.1
- seal
- hard
- cache=strict
- uid=70
- gid=70
- dir_mode=0700
- file_mode=0600
- mfsymlinks
- nobrl
csi:
driver: smb.csi.k8s.io
volumeHandle: artista-modelcamp-postgres-smb
volumeAttributes:
source: //nas.example.lan/artista/modelcamp-postgres
nodeStageSecretRef:
name: artista-modelcamp-smb
namespace: artista
---
# --- Medien (Bilder/Videos) ------------------------------------------------------
# Die App liest nur. Neue Bilder legst du direkt ueber die SMB-Freigabe ab,
# z. B. vom Windows-Explorer aus.
apiVersion: v1
kind: PersistentVolume
metadata:
@@ -34,7 +72,7 @@ spec:
storageClassName: ""
mountOptions:
- vers=3.1.1
- seal # SMB3-Verschluesselung: keine Klartextdaten im Netz
- seal
- uid=1001 # Containerbenutzer "nextjs" (Dockerfile)
- gid=1001
- dir_mode=0550 # App liest nur; Schreiben ausschliesslich ueber das NAS
@@ -43,40 +81,9 @@ spec:
- nobrl
csi:
driver: smb.csi.k8s.io
# Muss im Cluster eindeutig sein.
volumeHandle: artista-modelcamp-media-smb
volumeAttributes:
source: //nas.example.lan/artista/modelcamp-media
nodeStageSecretRef:
name: artista-modelcamp-smb
namespace: artista
---
# --- Datenbank-Sicherungen ------------------------------------------------------
apiVersion: v1
kind: PersistentVolume
metadata:
name: artista-modelcamp-db-backup-smb
spec:
capacity:
storage: 10Gi
# ReadWriteOnce: nur der Backup-Job haengt dieses Volume ein.
accessModes: ["ReadWriteOnce"]
persistentVolumeReclaimPolicy: Retain
storageClassName: ""
mountOptions:
- vers=3.1.1
- seal # SMB3-Verschluesselung: keine Klartextdaten im Netz
- uid=70 # Benutzer "postgres" im pg_dump-Job (postgres:18-alpine)
- gid=70
- dir_mode=0700 # Sicherungen enthalten personenbezogene Daten
- file_mode=0600
- mfsymlinks
- nobrl
csi:
driver: smb.csi.k8s.io
volumeHandle: artista-modelcamp-db-backup-smb
volumeAttributes:
source: //nas.example.lan/artista/modelcamp-backup
nodeStageSecretRef:
name: artista-modelcamp-smb
namespace: artista