Aller au contenu

Déploiement sur Kubernetes ​

Prérequis ​

  • Une StorageClass disponible, ou des PV déjà préparés correspondant aux PVC.
  • Les adresses et identifiants de connexion de PostgreSQL et Redis. La configuration ci-dessous utilise PostgreSQL 17 et Redis 7 ; le compte de base de données doit être autorisé à migrer le schéma.

Créer l’espace de noms et le jeton d’installation ​

Transmettez le jeton via un Secret pour qu’il reste identique si le Pod redémarre pendant l’installation :

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

Conservez le fichier local sayrud-setup-token pour saisir le jeton sur la page d’installation. Lorsque SAYRUD_SETUP_TOKEN est défini, le programme n’affiche pas sa valeur dans les journaux.

Créer les ressources de l’application ​

Enregistrez le contenu suivant dans sayrud.yaml. La StorageClass par défaut est utilisée ; si le cluster n’en a pas, renseignez le storageClassName approprié dans le spec des deux PVC.

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

Le répertoire de configuration est monté sur un PVC accessible en écriture, afin que l’assistant puisse y créer des fichiers.

Déployez l’application et vérifiez son état :

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

Terminer l’installation web ​

Redirigez le port sur votre ordinateur et laissez la commande active :

sh
kubectl -n sayrud port-forward service/sayrud 2830:2830

Ouvrez http://localhost:2830/setup, saisissez le jeton du fichier local sayrud-setup-token et suivez le guide d’installation web pour configurer les connexions et créer l’administrateur.

Après l’installation, la configuration est conservée dans le PVC sayrud-config, et les pièces jointes dans le PVC sayrud-data.

Pour utiliser un nom de domaine, configurez l’Ingress ou la passerelle du cluster pour sayrud:2830 et activez HTTPS et WebSocket.

Mettre à niveau ​

Sauvegardez la base de données, la configuration et les fichiers téléversés, puis modifiez la version de l’image dans le manifeste et exécutez :

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

Déploiement avec plusieurs répliques ​

Effectuez une première installation, puis préparez les ressources partagées nécessaires à l’augmentation du nombre de répliques :

  • Connectez toutes les répliques à la même base PostgreSQL et à la même instance Redis.
  • Distribuez la même configuration, notamment la même valeur de auth.secret_key. La configuration générée peut être montée sous forme de Secret Kubernetes ; un accès en lecture seule suffit en fonctionnement normal. Redémarrez les Pods après toute modification.
  • Stockez les pièces jointes sur un stockage partagé, comme S3 ou un volume ReadWriteMany. Migrez d’abord les fichiers locaux existants.