PostgreSQLをKubernetesにデプロイする方法：信頼性とスケーラビリティを備えたデータベース構築の完全ガイド

PostgreSQLは、複雑なデータセットの処理に優れたオープンソースのRDBMS（リレーショナルデータベース管理システム）です。一方、Kubernetesはコンテナ化されたアプリケーションのデプロイ、スケーリング、管理を自動化するオーケストレーションプラットフォームです。この2つを組み合わせることで、自動スケーリング、ローリングアップデート、レプリカによる冗長化とフェイルオーバーを実現し、可用性の高いデータベース基盤を構築できます。

デプロイの全体フロー

PostgreSQLをKubernetesにデプロイする作業は、主に以下の5つのステップで構成されます。

• Kubernetesクラスタの準備
• コンテナイメージの選定
• マニフェスト（YAML）の作成
• デプロイの実行
• 監視と運用

ステップ1：Kubernetesクラスタをセットアップする

本番環境ではAWS EKS、GCP GKE、Azure AKSなどのマネージドKubernetesサービスを利用するのが一般的です。検証や学習目的であれば、Minikubeやkindを使ってローカル環境に手軽にクラスタを構築できます。あわせてkubectlをインストールし、必要に応じてパッケージマネージャーのHelmも導入しておくと、以降の作業がスムーズになります。

ステップ2：デプロイメントマニフェストを作成する

PostgreSQLのDeploymentとServiceをYAMLファイルで定義します。まず、マニフェスト内で参照するpostgres-pvcを作成し、データを永続化できるようにしておきましょう。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: postgres-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi

続いて、PostgreSQL本体のDeploymentと、クラスタ内部通信用のServiceを定義します。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgres
spec:
  replicas: 1
  selector:
    matchLabels:
      app: postgres
  template:
    metadata:
      labels:
        app: postgres
    spec:
      containers:
        - name: postgres
          image: postgres:16
          ports:
            - containerPort: 5432
          env:
            - name: POSTGRES_USER
              value: "admin"
            - name: POSTGRES_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: postgres-secret
                  key: POSTGRES_PASSWORD
            - name: POSTGRES_DB
              value: "mydb"
          volumeMounts:
            - mountPath: /var/lib/postgresql/data
              name: postgres-storage
      volumes:
        - name: postgres-storage
          persistentVolumeClaim:
            claimName: postgres-pvc
---
apiVersion: v1
kind: Service
metadata:
  name: postgres-svc
spec:
  selector:
    app: postgres
  ports:
    - port: 5432
      targetPort: 5432
  type: ClusterIP

セキュリティの観点から、パスワードは平文でマニフェストに直接記述せず、Secretリソースで管理するのがベストプラクティスです。

apiVersion: v1
kind: Secret
metadata:
  name: postgres-secret
type: Opaque
stringData:
  POSTGRES_PASSWORD: secretpass

ステップ3：デプロイして動作を確認する

マニフェストを適用し、Podの状態やログを確認して正常に起動しているかチェックします。

# デプロイの適用
kubectl apply -f postgres-manifest.yaml

# Podの状態を確認
kubectl get pods

# ログを表示
kubectl logs <pod-name>

# リソース使用状況を監視
kubectl top pods

ステップ4：スケーリングとバックアップを行う

負荷に応じてレプリカ数を変更したり、pg_dumpを使って定期的にバックアップを取得したりできます。ただし、PostgreSQLはステートフルなアプリケーションであるため、単純にDeploymentのレプリカを増やしてもデータは複製されません。真の高可用性が必要な場合は、StatefulSetへの移行やCloudNativePG・Zalando Postgres Operatorなどの専用オペレーターの活用を検討してください。

# レプリカ数をスケール
kubectl scale deployment postgres --replicas=3

# pg_dumpでバックアップを取得
kubectl exec <pod-name> -- pg_dump -U admin mydb > backup.sql

まとめ

PostgreSQLをKubernetesにデプロイすることで、堅牢なデータベース管理とコンテナオーケストレーションのメリット――自動スケーリング、ローリングアップデート、永続ストレージ、フェイルオーバー――を同時に享受できます。基本はYAMLマニフェストで構成を定義し、kubectl applyでデプロイ、標準的なkubectlコマンドで監視・運用するというシンプルな流れです。本番環境ではSecretによる認証情報の管理、PVCによる永続化、そしてオペレーターを活用した高可用性構成まで踏み込むことで、より信頼性の高いデータベース基盤が実現します。