本文へスキップ

Kubernetes でデプロイ ​

事前準備 ​

  • 利用可能な StorageClass、または PVC に対応する PV を用意しておきます。
  • PostgreSQL と Redis の接続先と認証情報を控えておきます。以下では PostgreSQL 17 と Redis 7 を使用します。データベースアカウントにはスキーマを移行する権限が必要です。

名前空間とインストールトークンの作成 ​

インストールトークンを Secret から渡すことで、インストール中に Pod が再起動しても同じトークンを使えます。

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

ローカルの sayrud-setup-token ファイルは、後でインストール画面に入力するため保管してください。SAYRUD_SETUP_TOKEN を指定すると、トークンの値はログに出力されません。

アプリケーションリソースの作成 ​

以下を sayrud.yaml として保存します。デフォルトの StorageClass を使用するため、クラスターにデフォルトがない場合は、両方の PVC の spec に実際の storageClassName を設定してください。

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

設定ディレクトリには書き込み可能な PVC をマウントするため、インストールウィザードからファイルを作成できます。

デプロイして状態を確認します。

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

Web インストールの完了 ​

ローカルでポートを転送し、コマンドを実行したままにします。

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

http://localhost:2830/setup を開き、ローカルの sayrud-setup-token ファイル内のトークンを入力します。Web インストール手順に従って、接続設定と管理者の作成を完了してください。

インストール後、設定は sayrud-config PVC、添付ファイルは sayrud-data PVC に保存されます。

ドメイン名でアクセスする場合は、クラスターの既存の Ingress またはゲートウェイを sayrud:2830 に接続し、HTTPS と WebSocket を有効にしてください。

アップグレード ​

データベース、設定、アップロードしたファイルをバックアップし、マニフェスト内のイメージのバージョンを変更してから実行します。

sh
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 を統一します。生成済みの設定は Kubernetes Secret としてマウントでき、通常の実行時は読み取り専用でも構いません。設定変更後は Pod を再起動してください。
  • 添付ファイルは S3 や ReadWriteMany ボリュームなどの共有ストレージに保存し、既存のローカルファイルは先に移行します。