Implantação no Kubernetes
Pré-requisitos
- Uma StorageClass disponível ou PVs já preparados que correspondam aos PVCs.
- Os endereços e as credenciais de conexão do PostgreSQL e do Redis. A configuração abaixo usa PostgreSQL 17 e Redis 7; a conta do banco precisa de permissão para migrar o esquema.
Criar o namespace e o token de instalação
Forneça o token por um Secret para que ele continue o mesmo se o Pod reiniciar durante a instalação:
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-tokenGuarde o arquivo local sayrud-setup-token para informar o token na página de instalação. Quando SAYRUD_SETUP_TOKEN está definido, o programa não exibe seu valor nos logs.
Criar os recursos da aplicação
Salve o conteúdo abaixo como sayrud.yaml. Ele usa a StorageClass padrão; se o cluster não tiver uma, informe o storageClassName correto no spec dos dois PVCs.
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: ClusterIPO diretório de configuração é montado em um PVC gravável, permitindo que o assistente crie os arquivos.
Implante e confira o status:
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=100Concluir a instalação pela web
Encaminhe a porta no seu computador e mantenha o comando em execução:
kubectl -n sayrud port-forward service/sayrud 2830:2830Abra http://localhost:2830/setup, informe o token do arquivo local sayrud-setup-token e siga a instalação pela web para configurar as conexões e criar o administrador.
Após a instalação, a configuração fica no PVC sayrud-config, e os anexos no PVC sayrud-data.
Para acessar por um domínio, configure o Ingress ou gateway existente do cluster para sayrud:2830 e habilite HTTPS e WebSocket.
Atualizar
Faça backup do banco de dados, da configuração e dos arquivos enviados; depois, altere a versão da imagem no manifesto e execute:
kubectl apply -f sayrud.yaml
kubectl -n sayrud rollout status deployment/sayrud --timeout=300s
kubectl -n sayrud logs deployment/sayrud --tail=100Implantação com várias réplicas
Conclua a instalação uma vez e prepare os recursos compartilhados para ampliar a implantação:
- Conecte todas as réplicas ao mesmo banco PostgreSQL e à mesma instância do Redis.
- Distribua a mesma configuração, principalmente o mesmo
auth.secret_key. A configuração gerada pode ser montada como um Secret do Kubernetes; durante a operação normal, ela pode ser somente leitura. Reinicie os Pods depois de alterá-la. - Armazene os anexos em armazenamento compartilhado, como S3 ou um volume
ReadWriteMany. Migre os arquivos locais existentes primeiro.