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:
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-tokenConserva 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.
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: ClusterIPEl 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:
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=100Completar la instalación web
Reenvía el puerto en tu equipo y deja el comando en ejecución:
kubectl -n sayrud port-forward service/sayrud 2830:2830Abre 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:
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud logs deployment/sayrud --tail=100Despliegue 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.