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 :
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-tokenConservez 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.
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: ClusterIPLe 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 :
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=100Terminer l’installation web
Redirigez le port sur votre ordinateur et laissez la commande active :
kubectl -n sayrud port-forward service/sayrud 2830:2830Ouvrez 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 :
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud logs deployment/sayrud --tail=100Dé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.