Bereitstellung mit Kubernetes
Voraussetzungen
- Eine verfügbare StorageClass oder vorbereitete PVs, die zu den PVCs passen.
- Verbindungsadressen und Zugangsdaten für PostgreSQL und Redis. Die folgende Konfiguration verwendet PostgreSQL 17 und Redis 7; das Datenbankkonto benötigt Rechte zur Schemamigration.
Namespace und Installationstoken erstellen
Übergib das Installationstoken über ein Secret, damit es bei einem Pod-Neustart während der Installation gleich bleibt:
kubectl create namespace sayrud
umask 077
openssl rand -hex 24 > sayrud-setup-token
kubectl -n sayrud create secret generic sayrud-setup --from-file=token=sayrud-setup-tokenBewahre die lokale Datei sayrud-setup-token auf, um das Token später auf der Installationsseite einzugeben. Wenn SAYRUD_SETUP_TOKEN gesetzt ist, gibt das Programm den Wert nicht in den Logs aus.
Anwendungsressourcen erstellen
Speichere Folgendes als sayrud.yaml. Die Standard-StorageClass wird verwendet; falls dein Cluster keine hat, trage den tatsächlichen storageClassName im spec beider PVCs ein.
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: sayrud-config
namespace: sayrud
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: sayrud-data
namespace: sayrud
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 10Gi
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: sayrud
namespace: sayrud
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
app: sayrud
template:
metadata:
labels:
app: sayrud
spec:
terminationGracePeriodSeconds: 45
securityContext:
runAsNonRoot: true
runAsUser: 10001
runAsGroup: 10001
fsGroup: 10001
fsGroupChangePolicy: OnRootMismatch
containers:
- name: sayrud
image: ghcr.io/sayrud/sayrud:latest
imagePullPolicy: IfNotPresent
args: ["web", "--port", "2830", "--config", "/home/app/config/sayrud.yaml"]
env:
- name: SAYRUD_SETUP_TOKEN
valueFrom:
secretKeyRef:
name: sayrud-setup
key: token
ports:
- name: http
containerPort: 2830
volumeMounts:
- name: config
mountPath: /home/app/config
- name: data
mountPath: /home/app/data
startupProbe:
httpGet:
path: /-/healthz
port: http
periodSeconds: 5
timeoutSeconds: 3
failureThreshold: 60
readinessProbe:
httpGet:
path: /-/readyz
port: http
periodSeconds: 5
timeoutSeconds: 5
livenessProbe:
httpGet:
path: /-/healthz
port: http
periodSeconds: 10
timeoutSeconds: 3
resources:
requests:
cpu: 100m
memory: 256Mi
limits:
cpu: "1"
memory: 1Gi
volumes:
- name: config
persistentVolumeClaim:
claimName: sayrud-config
- name: data
persistentVolumeClaim:
claimName: sayrud-data
---
apiVersion: v1
kind: Service
metadata:
name: sayrud
namespace: sayrud
spec:
selector:
app: sayrud
ports:
- name: http
port: 2830
targetPort: http
type: ClusterIPDas Konfigurationsverzeichnis wird auf einem beschreibbaren PVC eingebunden, sodass der Installationsassistent dort Dateien anlegen kann.
Stelle die Anwendung bereit und prüfe den Status:
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud get pods,pvc
kubectl -n sayrud logs deployment/sayrud --tail=100Webinstallation abschließen
Leite den Port auf deinem Computer weiter und lasse den Befehl laufen:
kubectl -n sayrud port-forward service/sayrud 2830:2830Öffne http://localhost:2830/setup, gib das Token aus der lokalen Datei sayrud-setup-token ein und folge der Webinstallation, um die Verbindungen einzurichten und den Administrator anzulegen.
Nach der Installation liegt die Konfiguration im PVC sayrud-config, Anhänge liegen im PVC sayrud-data.
Für den Zugriff über eine Domain richte den vorhandenen Ingress oder das Gateway des Clusters für sayrud:2830 ein und aktiviere HTTPS und WebSocket-Unterstützung.
Upgrade
Sichere die Datenbank, Konfiguration und hochgeladenen Dateien, ändere dann die Image-Version im Manifest und führe Folgendes aus:
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud logs deployment/sayrud --tail=100Mehrere Repliken
Schließe die Installation einmal ab und bereite anschließend die gemeinsam genutzten Ressourcen für die Skalierung vor:
- Verbinde alle Repliken mit derselben PostgreSQL-Datenbank und Redis-Instanz.
- Verteile dieselbe Konfiguration und insbesondere denselben
auth.secret_key. Die erzeugte Konfiguration kann als Kubernetes-Secret eingebunden werden; im normalen Betrieb reicht Lesezugriff. Starte die Pods nach Konfigurationsänderungen neu. - Speichere Anhänge in gemeinsam genutztem Speicher wie S3 oder einem
ReadWriteMany-Volume. Migriere vorhandene lokale Dateien zuerst.