Развёртывание в Kubernetes
Подготовка
- Доступный StorageClass или заранее подготовленные PV, подходящие для PVC.
- Адреса и учётные данные для подключения к PostgreSQL и Redis. Ниже используются PostgreSQL 17 и Redis 7; у учётной записи базы данных должны быть права на миграцию схемы.
Создание пространства имён и токена установки
Передайте токен через Secret, чтобы он не менялся при перезапуске Pod во время установки:
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Сохраните локальный файл sayrud-setup-token, чтобы позже ввести токен на странице установки. Если задан SAYRUD_SETUP_TOKEN, программа не выводит его значение в журналы.
Создание ресурсов приложения
Сохраните следующее содержимое в sayrud.yaml. Используется StorageClass по умолчанию; если его нет, укажите нужный storageClassName в spec обоих 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: ClusterIPКаталог конфигурации монтируется в доступный для записи PVC, чтобы мастер установки мог создавать в нём файлы.
Разверните приложение и проверьте состояние:
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Завершение веб-установки
Настройте перенаправление порта на своём компьютере и оставьте команду работающей:
kubectl -n sayrud port-forward service/sayrud 2830:2830Откройте http://localhost:2830/setup, введите токен из локального файла sayrud-setup-token и следуйте инструкции веб-установки, чтобы настроить подключения и создать администратора.
После установки конфигурация хранится в PVC sayrud-config, а вложения — в PVC sayrud-data.
Для доступа по доменному имени настройте существующий Ingress или шлюз кластера для sayrud:2830 и включите HTTPS и WebSocket.
Обновление
Создайте резервную копию базы данных, конфигурации и загруженных файлов, затем измените версию образа в манифесте и выполните:
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud logs deployment/sayrud --tail=100Развёртывание с несколькими репликами
Завершите установку один раз, затем подготовьте общие ресурсы для масштабирования:
- Все реплики должны подключаться к одной базе PostgreSQL и одному экземпляру Redis.
- Используйте одинаковую конфигурацию, особенно значение
auth.secret_key. Созданную конфигурацию можно монтировать как Secret Kubernetes; при обычной работе достаточно доступа только для чтения. После изменений перезапустите Pods. - Храните вложения в общем хранилище, например S3 или томе
ReadWriteMany. Сначала перенесите существующие локальные файлы.