Pular para o conteúdo

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:

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

Guarde 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.

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

O diretório de configuração é montado em um PVC gravável, permitindo que o assistente crie os arquivos.

Implante e confira o status:

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

Concluir a instalação pela web ​

Encaminhe a porta no seu computador e mantenha o comando em execução:

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

Abra 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:

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

Implantaçã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.