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=100Web インストールの完了
ローカルでポートを転送し、コマンドを実行したままにします。
sh
kubectl -n sayrud port-forward service/sayrud 2830:2830http://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ボリュームなどの共有ストレージに保存し、既存のローカルファイルは先に移行します。