Saltar al contenido

Despliegue en Kubernetes ​

Requisitos previos ​

  • Una StorageClass disponible o PV preparados que correspondan a los PVC.
  • Las direcciones y credenciales de conexión de PostgreSQL y Redis. A continuación se usan PostgreSQL 17 y Redis 7; la cuenta de la base de datos debe tener permisos para migrar el esquema.

Crear el espacio de nombres y el token de instalación ​

Proporciona el token mediante un Secret para que siga siendo el mismo si el Pod se reinicia durante la instalación:

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

Conserva el archivo local sayrud-setup-token para introducir el token en la página de instalación. Si se configura SAYRUD_SETUP_TOKEN, el programa no muestra su valor en los registros.

Crear los recursos de la aplicación ​

Guarda lo siguiente como sayrud.yaml. Se usa la StorageClass predeterminada; si el clúster no tiene ninguna, establece el storageClassName correspondiente en el spec de ambos 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

El directorio de configuración se monta en un PVC con permisos de escritura para que el asistente pueda crear archivos.

Despliega y consulta el estado:

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

Completar la instalación web ​

Reenvía el puerto en tu equipo y deja el comando en ejecución:

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

Abre http://localhost:2830/setup, introduce el token del archivo local sayrud-setup-token y sigue la instalación web para configurar las conexiones y crear el administrador.

Tras la instalación, la configuración se guarda en el PVC sayrud-config y los adjuntos en el PVC sayrud-data.

Para acceder con un dominio, configura el Ingress o la puerta de enlace existente del clúster para sayrud:2830 y habilita HTTPS y WebSocket.

Actualizar ​

Haz una copia de seguridad de la base de datos, la configuración y los archivos subidos; después, cambia la versión de la imagen en el manifiesto y ejecuta:

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

Despliegue con varias réplicas ​

Completa la instalación una vez y prepara los recursos compartidos para ampliar el despliegue:

  • Conecta todas las réplicas a la misma base de datos PostgreSQL y a la misma instancia de Redis.
  • Distribuye la misma configuración, especialmente el mismo auth.secret_key. Puedes montar la configuración generada como un Secret de Kubernetes; durante el funcionamiento normal puede ser de solo lectura. Reinicia los Pods después de cambiarla.
  • Guarda los adjuntos en almacenamiento compartido, como S3 o un volumen ReadWriteMany. Migra primero los archivos locales existentes.