Zum Inhalt springen

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:

sh
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-token

Bewahre 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.

yaml
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: ClusterIP

Das Konfigurationsverzeichnis wird auf einem beschreibbaren PVC eingebunden, sodass der Installationsassistent dort Dateien anlegen kann.

Stelle die Anwendung bereit und prüfe den Status:

sh
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=100

Webinstallation abschließen ​

Leite den Port auf deinem Computer weiter und lasse den Befehl laufen:

sh
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:

sh
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud logs deployment/sayrud --tail=100

Mehrere 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.