証明書を管理

ドキュメントのバージョンを選択してください。

カスタム証明書発行者を使用すると、Kubernetes ベースの AlloyDB Omni データベース クラスタで Transport Layer Security(TLS)証明書を管理できます。

デフォルトでは、AlloyDB Omni Kubernetes オペレーターは cert-manager を使用して、データベース クラスタごとに一連の TLS 証明書をプロビジョニングします。オペレーターは、データベース サーバー証明書に加えて、コントロール プレーン コンポーネントの証明書も作成して、内部接続のセキュリティを確保します。デフォルトでは、各証明書はオペレーターが管理する発行者によって署名されます。

コントロール プレーン コンポーネントの証明書を含むすべての証明書を独自の信頼できるルート認証局(CA)にチェーンする場合は、任意の認証局を使用するようにオペレーターを構成できます。これにより、各内部エンティティの実装の詳細を公開することなく、コントロール プレーン機能に使用される証明書を含むすべての証明書を独自の公開鍵基盤(PKI)にチェーンできます。

デフォルトの証明書の有効期間

デフォルトでは、AlloyDB Omni Operator は cert-manager を使用して、Operator、コントロール プレーン、データベース インスタンスの TLS 証明書を発行し、自動的に更新します。

次の表に、AlloyDB Omni Operator で管理される証明書のデフォルトの有効期間を示します。

証明書の種類 証明書の説明 シークレット名 名前空間 デフォルトの期間
オペレーターの mTLS クライアント証明書 高可用性(HA)ヘルスチェックと、オペレーターとコントロール プレーン エージェント間の接続のために、local-controller-manager Deployment によって使用されます。 dbs-al-cert-l2-operator オペレーターの名前空間 1440h0m0s(60 日間)
オペレーター Webhook サーバー証明書 オペレーター アドミッション Webhook サーバーがカスタム リソースを検証および変更するために使用します。 fleet-webhook-server-cert

local-webhook-server-cert
オペレーターの名前空間 1440h0m0s(60 日間)
インスタンスごとのコントロール プレーン エージェント証明書 インスタンスごとのデータベース エージェント、ノード マネージャー、バックアップ デーモンがコントロール プレーン接続に使用します。 dbs-al-cert-dbd-INSTANCE_ID-DB_CLUSTER_NAME

dbs-al-cert-al-INSTANCE_ID-DB_CLUSTER_NAME-nm

dbs-al-cert-backup-daemon-BACKUP_REPO_NAME
データベース クラスタの名前空間 1440h0m0s(60 日間)
バックアップ証明書 バックアップ サービスがバックアップと復元の接続に使用します。 dbs-al-cert-backup-client

dbs-al-cert-backup-client-DATA_PLANE_ISSUER_NAME

dbs-al-cert-backup-server-INSTANCE_ID-DB_CLUSTER_NAME

dbs-al-cert-standby-backup-server-INSTANCE_ID-DB_CLUSTER_NAME
データベース クラスタの名前空間 1440h0m0s(60 日間)
データベース サーバー証明書 データベース インスタンスへのデータプレーン クライアント接続を保護します。 dbs-al-cert-DB_CLUSTER_NAME データベース クラスタの名前空間 87600h0m0s(10 年)
PgBouncer 認証クエリ証明書 PgBouncer Deployment がデータベースに接続して接続プーリングを実行するために使用するデータベース クライアント証明書。PgBouncer リソースを作成するときにのみ作成されます。 dbs-al-pgb-cert-PGBOUNCER_NAME データベース クラスタの名前空間 87600h0m0s(10 年)
オペレーターが管理する自己署名 CA 証明書 オペレーター、コントロール プレーン エージェント、バックアップ、データベース サーバーの証明書に署名するために、オペレーターのデフォルトの自己署名発行者が使用するルート CA 証明書。 dbs-al-ca-l2-operator

dbs-al-ca-DB_CLUSTER_NAME

dbs-al-ca-dbd-INSTANCE_ID-DB_CLUSTER_NAME

dbs-al-ca-backup-server

dbs-al-ca-backup-daemon-BACKUP_REPO_NAME
オペレーターの名前空間とデータベース クラスタの名前空間 87600h0m0s(10 年)

この表の Secret 名では、次のプレースホルダが使用されています。

  • INSTANCE_ID: データベース インスタンス用に生成された 4 文字の識別子。
  • DB_CLUSTER_NAME: DBCluster リソースの名前。
  • DATA_PLANE_ISSUER_NAME: spec.primarySpec.tls.dataPlaneCertIssuer.name で構成されたカスタム cert-manager 発行者の名前(指定されている場合)。
  • BACKUP_REPO_NAME: BackupRepository リソースの名前(構成されている場合)。
  • PGBOUNCER_NAME: PgBouncer リソースの名前。

カスタム発行者を構成する

データベース クラスタ、AlloyDB Omni Operator、PgBouncer にカスタム証明書発行元を構成できます。

証明書発行者を構成するには、まず、証明書に署名する CA に関連付けられた cert-manager 発行者を作成する必要があります。cert-manager の発行元タイプのいずれか、または互換性のある外部発行元を使用できます。AlloyDB Omni Operator は、証明書の作成時にこの発行者を参照します。

カスタム cert-manager 証明書発行者は、生成された証明書シークレットの ca.crt フィールドにルート CA の証明書を入力する必要があります。

データベース クラスタの証明書

証明書発行者を構成するデータベース クラスタ仕様フィールドは 2 つあります。

  • spec.primarySpec.tls.dataPlaneCertIssuer: データプレーン証明書をプロビジョニングする cert-manager 発行者への参照。発行元 CA は、TLS 接続中にデータベースを検証するためにデータベース クライアントが信頼できる CA です。

  • spec.primarySpec.tls.controlPlaneAgentsCertIssuer: コントロール プレーン証明書をプロビジョニングする cert-manager 発行者への参照。これらの証明書は内部接続に使用されます。

spec:
  primarySpec:
    tls:
      dataPlaneCertIssuer:
        name: DATA_PLANE_ISSUER_NAME
        kind: DATA_PLANE_ISSUER_KIND
        group: DATA_PLANE_ISSUER_GROUP
      controlPlaneAgentsCertIssuer:
        name: CONTROL_PLANE_ISSUER_NAME
        kind: CONTROL_PLANE_ISSUER_KIND
        group: CONTROL_PLANE_ISSUER_GROUP

次のように置き換えます。

  • DATA_PLANE_ISSUER_NAME: データベース サーバーなどのデータプレーン証明書をプロビジョニングする cert-manager 発行者の名前。

  • DATA_PLANE_ISSUER_KIND: cert-manager 発行者の API 種類。デフォルトは Issuer です。

  • DATA_PLANE_ISSUER_GROUP: 発行者の API グループ。デフォルトは cert-manager.io です。

  • CONTROL_PLANE_ISSUER_NAME: 内部コンポーネントのコントロール プレーン証明書をプロビジョニングする cert-manager 発行者の名前。

  • CONTROL_PLANE_ISSUER_KIND: cert-manager 発行者の API 種類。デフォルトは Issuer です。

  • CONTROL_PLANE_ISSUER_GROUP: 発行者の API グループ。デフォルトは cert-manager.io です。

オペレーター証明書

オペレーター証明書の cert-manager 発行者を構成する手順は、AlloyDB Omni Operator のインストールに使用した方法によって異なります。

Helm を使用して構成する

AlloyDB Omni Operator を初めてインストールする場合は、helm install を使用して適切な値を設定します。これは、Helm を使用してオペレーターをデプロイする手順に沿って操作していることを前提としています。

helm install alloydbomni-operator alloydbomni-operator-OPERATOR_VERSION.tgz \
--create-namespace \
--namespace alloydb-omni-system \
--set operatorCertIssuer.certManagerIssuerName="OPERATOR_CERT_ISSUER_NAME" \
--set operatorCertIssuer.certManagerIssuerKind="OPERATOR_CERT_ISSUER_KIND" \
--set operatorCertIssuer.certManagerIssuerGroup="OPERATOR_CERT_ISSUER_GROUP" \
--atomic \
--timeout 5m

オペレーターがすでにインストールされていて、証明書発行者を設定する必要がある場合は、helm upgrade を使用して適切な値を設定します。

helm upgrade alloydbomni-operator alloydbomni-operator-OPERATOR_VERSION.tgz \
--create-namespace \
--namespace alloydb-omni-system \
--set operatorCertIssuer.certManagerIssuerName="OPERATOR_CERT_ISSUER_NAME" \
--set operatorCertIssuer.certManagerIssuerKind="OPERATOR_CERT_ISSUER_KIND" \
--set operatorCertIssuer.certManagerIssuerGroup="OPERATOR_CERT_ISSUER_GROUP" \
--atomic \
--timeout 5m

次のように置き換えます。

  • OPERATOR_VERSION: インストールする AlloyDB Omni Operator のバージョン。

  • OPERATOR_CERT_ISSUER_NAME: 内部接続に使用されるオペレーター証明書をプロビジョニングする cert-manager 発行者の名前。

  • OPERATOR_CERT_ISSUER_KIND: cert-manager 発行者の API 種類。デフォルトは Issuer です。

  • OPERATOR_CERT_ISSUER_GROUP: 発行者の API グループ。デフォルトは cert-manager.io です。

Operator Lifecycle Manager を使用して構成する

Operator Lifecycle Manager(OLM)を使用して AlloyDB Omni Operator をインストールした場合は、Subscription リソースの spec.config.env フィールドを変更して、Operator Deployment の CERT_MANAGER_ISSUER_NAME、CERT_MANAGER_ISSUER_KIND、CERT_MANAGER_ISSUER_GROUP 環境変数を設定できます。

spec:
  config:
    env:
    - name: CERT_MANAGER_ISSUER_NAME
      value: OPERATOR_CERT_ISSUER_NAME
    - name: CERT_MANAGER_ISSUER_KIND
      value: OPERATOR_CERT_ISSUER_KIND
    - name: CERT_MANAGER_ISSUER_GROUP
      value: OPERATOR_CERT_ISSUER_GROUP

次のように置き換えます。

  • OPERATOR_CERT_ISSUER_NAME: 内部接続に使用されるオペレーター証明書をプロビジョニングする cert-manager 発行者の名前。

  • OPERATOR_CERT_ISSUER_KIND: cert-manager 発行者の API 種類。デフォルトは Issuer です。

  • OPERATOR_CERT_ISSUER_GROUP: 発行者の API グループ。デフォルトは cert-manager.io です。

PgBouncer 証明書

カスタム発行者をサポートするために、PgBouncer コントローラは DBCluster spec.primarySpec.tls.dataPlaneCertIssuer フィールドをチェックし、それを使用して PgBouncer 証明書をプロビジョニングします。PgBouncer コントローラは、spec.primarySpec.tls.dataPlaneCertRequest で構成された属性を使用して PgBouncer 証明書をプロビジョニングします。これにより、PgBouncer は、データベースと同じ属性を持つ同じ CA の証明書を使用します。

カスタム証明書属性を構成する

オペレーターによって生成される TLS 証明書の属性(証明書の有効期間、更新ウィンドウ、サブジェクト代替名(SAN)、共通名、秘密鍵の構成など)をカスタマイズできます。

カスタム証明書属性は、DBCluster マニフェストで構成します。

  • spec.primarySpec.tls.dataPlaneCertRequest: pgBackRest サーバー、PgBouncer 認証クエリ、データベース サーバー証明書など、データプレーン証明書の属性を指定します。
  • spec.primarySpec.tls.controlPlaneAgentsCertRequest: コントロール プレーン証明書のプロビジョニングの属性を指定します。これらの証明書は内部接続に使用されます。

証明書リクエストを構成する

リクエスト プロパティを次の形式で指定します。

spec:
  primarySpec:
    tls:
      dataPlaneCertRequest:
        commonName: DATABASE_COMMON_NAME
        dnsNames:
        - DATABASE_DNS_NAME_1
        - DATABASE_DNS_NAME_2
        duration: DATA_PLANE_DURATION
        renewBefore: DATA_PLANE_RENEW_BEFORE
        privateKey:
          algorithm: DATA_PLANE_ALGORITHM
          size: DATA_PLANE_KEY_SIZE
          rotationPolicy: DATA_PLANE_ROTATION_POLICY
      controlPlaneAgentsCertRequest:
        duration: CONTROL_PLANE_DURATION
        renewBefore: CONTROL_PLANE_RENEW_BEFORE
        privateKey:
          algorithm: CONTROL_PLANE_ALGORITHM
          size: CONTROL_PLANE_KEY_SIZE
          rotationPolicy: CONTROL_PLANE_ROTATION_POLICY

次のように置き換えます。

  • DATABASE_COMMON_NAME: (省略可、データプレーンのみ)データベース証明書の共通名。
  • DATABASE_DNS_NAME_1、DATABASE_DNS_NAME_2:(省略可、データプレーンのみ)データベース証明書のサブジェクト代替名(SAN)のリスト。
  • DATA_PLANE_DURATION と CONTROL_PLANE_DURATION: リクエストされた証明書の有効期間(文字列の期間)。たとえば、カスタムの 30 日間の場合は 720h0m0s です。各証明書リクエスト ブロックで、duration と renewBefore の両方を指定する(renewBefore は duration より小さくする)か、両方のフィールドを省略する必要があります。両方のフィールドを省略した場合、デフォルトの期間は、コントロール プレーン証明書とバックアップ証明書の場合は 1440h0m0s(60 日)、データベース サーバー証明書と PgBouncer 認証クエリ証明書の場合は 87600h0m0s(10 年)です。
  • DATA_PLANE_RENEW_BEFORE と CONTROL_PLANE_RENEW_BEFORE: cert-manager が更新の試行を開始する必要がある有効期限までの期間。たとえば、有効期限の 5 日前の場合は 120h0m0s です。各証明書リクエスト ブロックで、duration と renewBefore の両方を指定する(renewBefore は duration 未満)か、両方のフィールドを省略する必要があります。両方のフィールドを省略すると、デフォルトの更新期間は、コントロール プレーン証明書とバックアップ証明書の場合は 120h0m0s(5 日間)、データベース サーバー証明書と PgBouncer 認証クエリ証明書の場合は 1440h0m0s(60 日間)になります。
  • DATA_PLANE_ALGORITHM と CONTROL_PLANE_ALGORITHM: 秘密鍵アルゴリズム。有効な値は RSA、ECDSA、または Ed25519 です。
  • DATA_PLANE_KEY_SIZE と CONTROL_PLANE_KEY_SIZE: 秘密鍵のサイズ(ビット単位)。アルゴリズムが RSA の場合、有効な値は 4096 または 8192 です(デフォルトは 4096)。アルゴリズムが ECDSA の場合、有効な値は 384 または 521 です(デフォルトは 384)。アルゴリズムが Ed25519 の場合、サイズは無視されます。
  • DATA_PLANE_ROTATION_POLICY と CONTROL_PLANE_ROTATION_POLICY: 秘密鍵の再生成を制御するポリシー。有効な値は Always または Never です。

オペレーターとバックアップのクライアント証明書

オペレーターとバックアップ クライアント(Namespace 内のすべてのインスタンスで共有され、データベース クラスタ仕様で管理されない)の証明書属性をカスタマイズするには、Certificate カスタム リソースを変更します。オペレーターは、これらの手動変更を保持します。

証明書のシークレットをクリーンアップする

DBCluster リソースを削除すると、AlloyDB Omni Operator は関連する Certificate リソースを削除しますが、cert-manager はデフォルトで証明書 Secret リソースをクリーンアップしません。証明書の削除時にシークレットをクリーンアップするように cert-manager コントローラを構成するには、cert-manager ドキュメントの証明書の削除時にシークレットをクリーンアップするをご覧ください。

自動クリーンアップを構成せずに DBCluster リソースをすでに削除している場合は、残っている証明書シークレットを手動で削除します。

kubectl delete secret CERTIFICATE_SECRET_NAME -n NAMESPACE

次のように置き換えます。

  • CERTIFICATE_SECRET_NAME: 削除する証明書シークレットの名前。
  • NAMESPACE: データベース クラスタの Namespace。

確認

オペレーター Deployment が正常で、環境変数 CERT_MANAGER_ISSUER_NAME、CERT_MANAGER_ISSUER_KIND、CERT_MANAGER_ISSUER_GROUP が設定されていることを確認するには、次のコマンドを実行します。

kubectl get deployments local-controller-manager -n alloydb-omni-system -o yaml

正しい発行元が使用されていることを確認するには、次のように Certificate オブジェクトを検査します。

kubectl get certificate -n NAMESPACE

NAMESPACE は、データベース クラスタの名前空間、またはオペレーター証明書の alloydb-omni-system に置き換えます。

各証明書の出力の issuerRef フィールドを調べて、カスタム発行元と一致していることを確認します。

1.8.2 より前のオペレーター バージョンでオペレーター クライアント証明書の有効期限を緩和する

1.8.2 より前の AlloyDB Omni Operator バージョンでは、local-controller-manager Deployment は、コントロール プレーン エージェントへの HA ヘルスチェック接続用に 60 日間の dbs-al-cert-l2-operator mTLS クライアント証明書をメモリにキャッシュします。cert-manager は有効期限の 5 日前に dbs-al-cert-l2-operator Secret を自動的に更新しますが、local-controller-manager Deployment は、オペレーター Pod が再起動するまで更新された証明書を再読み込みしません。キャッシュに保存された証明書が 60 日目に期限切れになると、その後のヘルスチェックの再接続が tls: expired certificate エラーで失敗し、計画外の HA フェイルオーバーがトリガーされる可能性があります。

この問題を完全に解決するには、AlloyDB Omni Operator をバージョン 1.8.2 以降にアップグレードします。

オペレーター バージョン 1.8.2 以降にすぐにアップグレードできない場合は、証明書の有効期限が切れる 10 日前までに dbs-al-cert-l2-operator Secret をローテーションし、local-controller-manager Deployment を再起動します。この手順では、データベース Pod の再起動やデータベース トラフィックの中断は行われません。

始める前に

rotate_cert.sh スクリプトを実行する前に、環境が次の要件を満たしていることを確認してください。

  • PATH に bash、kubectl、openssl、base64 をインストールします。
  • Kubernetes クラスタへのアクセスを構成し、アクティブな kubectl コンテキストをターゲット クラスタに設定します。アクティブなコンテキストを確認するには、kubectl config current-context を実行します。1.8.2 より前のバージョンのオペレーターを実行しているクラスタごとに、この手順を繰り返します。
  • アカウントに、オペレーターの Namespace(デフォルトは alloydb-omni-system)で Kubernetes ロールベース アクセス制御(RBAC)権限があることを確認します。
    • Certificate リソースと Pod ログに対する get
    • Pod リソースに対する get と list
    • dbs-al-cert-l2-operator Secret の get と delete(バックアップされた Secret を復元するための create と patch)
    • local-controller-manager Deployment の get と patch
    • CertificateRequest リソースに対する delete(バックアップされた Secret を復元するため)

オペレーター クライアント証明書をローテーションする

rotate_cert.sh スクリプトは、2 つのモードと、オプションの名前空間引数をサポートしています。デフォルトは alloydb-omni-system です。

  • ./rotate_cert.sh check: 読み取り専用チェックを実行し、次の情報を出力します。
    • 現在の証明書のシリアル番号と有効期間
    • 推奨されるローテーション期限。有効期限の 10 日前に設定
    • local-controller-manager コンテナの開始時間
    • [OK] または [WARNING] のいずれかのメモリ内証明書のステータス
    • kubectl バックアップ コマンド
  • ./rotate_cert.sh rotate: 次のアクションを実行します。
    • dbs-al-cert-l2-operator Secret を削除します。
    • cert-manager が新しい証明書のシリアル番号を発行し、dbs-al-cert-request-l2-operator Certificate リソースを更新するまで待機します。
    • local-controller-manager Deployment を再起動します。
    • 新しい Pod のログを確認し、新しい有効期限を出力します。

オペレーター クライアント証明書を確認してローテーションする手順は次のとおりです。

  1. 次のスクリプトを rotate_cert.sh という名前のファイルに保存し、ファイルを実行可能にします。

    cat << 'EOF' > rotate_cert.sh
    #!/usr/bin/env bash
    set -euo pipefail
    MODE="${1:-}"
    NS="${2:-alloydb-omni-system}"
    SECRET="dbs-al-cert-l2-operator"
    CERT="dbs-al-cert-request-l2-operator"
    DEPLOY="local-controller-manager"
    get_cert_info() {
      kubectl get secret "$SECRET" -n "$NS" -o jsonpath='{.data.tls\.crt}' 2>/dev/null \
        | base64 -d 2>/dev/null | openssl x509 -noout -serial -enddate 2>/dev/null || true
    }
    calc_rotate_by() {
      date -u -d "$1 - 10 days" +"%Y-%m-%d" 2>/dev/null \
        || date -u -j -v-10d -f "%Y-%m-%dT%H:%M:%SZ" "$1" +"%Y-%m-%d" 2>/dev/null || echo "unknown"
    }
    get_container_name() {
      local names
      names="$(kubectl get pods -n "$NS" -l local-control-plane=controller-manager \
        --field-selector=status.phase=Running --sort-by=.metadata.creationTimestamp \
        -o jsonpath='{.items[-1].spec.containers[*].name}' 2>/dev/null || true)"
      if [[ " $names " == *" local-manager "* ]]; then
        echo "local-manager"
      else
        echo "manager"
      fi
    }
    case "$MODE" in
      check)
        INFO="$(get_cert_info)"
        SERIAL="$(echo "$INFO" | sed -n 's/^serial=//p')"
        ENDDATE="$(echo "$INFO" | sed -n 's/^notAfter=//p')"
        NOT_BEFORE="$(kubectl get certificate "$CERT" -n "$NS" -o jsonpath='{.status.notBefore}')"
        NOT_AFTER="$(kubectl get certificate "$CERT" -n "$NS" -o jsonpath='{.status.notAfter}')"
        CONTAINER="$(get_container_name)"
        STARTED_AT="$(kubectl get pods -n "$NS" -l local-control-plane=controller-manager \
          --field-selector=status.phase=Running --sort-by=.metadata.creationTimestamp \
          -o jsonpath="{.items[-1].status.containerStatuses[?(@.name==\"$CONTAINER\")].state.running.startedAt}")"
        echo "Certificate Serial      : $SERIAL"
        echo "Certificate Start Date  : $NOT_BEFORE"
        echo "Certificate End Date    : $ENDDATE ($NOT_AFTER)"
        echo "Recommended Rotate By   : $(calc_rotate_by "$NOT_AFTER") (10 days before expiry)"
        echo "Operator Started At     : $STARTED_AT"
        if [[ "$STARTED_AT" < "$NOT_BEFORE" ]]; then
          echo "[WARNING] Operator started ($STARTED_AT) BEFORE current cert was issued ($NOT_BEFORE). It is still caching the old cert in memory! Run './rotate_cert.sh rotate $NS' now."
        else
          echo "[OK] Operator is running with the current certificate in memory."
        fi
        echo "Optional Backup Command : kubectl get secret $SECRET -n $NS -o yaml > $SECRET-backup.yaml"
        ;;
      rotate)
        OLD_SERIAL="$(get_cert_info | sed -n 's/^serial=//p')"
        OLD_REV="$(kubectl get certificate "$CERT" -n "$NS" -o jsonpath='{.status.revision}' 2>/dev/null || true)"
        echo "Current Certificate Serial: ${OLD_SERIAL:-none}"
        kubectl delete secret "$SECRET" -n "$NS" --ignore-not-found
        NEW_SERIAL=""
        NOT_AFTER=""
        for _ in {1..30}; do
          sleep 2
          NEW_SERIAL="$(get_cert_info | sed -n 's/^serial=//p')"
          NEW_REV="$(kubectl get certificate "$CERT" -n "$NS" -o jsonpath='{.status.revision}' 2>/dev/null || true)"
          READY_COND="$(kubectl get certificate "$CERT" -n "$NS" -o jsonpath='{.status.conditions[?(@.type=="Ready")].status}' 2>/dev/null || true)"
          NOT_AFTER="$(kubectl get certificate "$CERT" -n "$NS" -o jsonpath='{.status.notAfter}' 2>/dev/null || true)"
          [[ -n "$NEW_SERIAL" && "$NEW_SERIAL" != "$OLD_SERIAL" && "$NEW_REV" != "$OLD_REV" && "$READY_COND" == "True" && -n "$NOT_AFTER" ]] && break
        done
        [[ -n "$NEW_SERIAL" && "$NEW_SERIAL" != "$OLD_SERIAL" && "$READY_COND" == "True" ]] || { echo "[ERROR] Timed out waiting for new cert."; exit 1; }
        kubectl rollout restart "deployment/$DEPLOY" -n "$NS"
        kubectl rollout status "deployment/$DEPLOY" -n "$NS" --timeout=180s
        NEW_POD="$(kubectl get pods -n "$NS" -l local-control-plane=controller-manager \
          --field-selector=status.phase=Running --sort-by=.metadata.creationTimestamp -o jsonpath='{.items[-1].metadata.name}')"
        CONTAINER="$(get_container_name)"
        READY=false
        for _ in {1..40}; do
          LOGS="$(kubectl logs "pod/$NEW_POD" -n "$NS" -c "$CONTAINER" 2>/dev/null || true)"
          grep -q "tls: expired certificate" <<<"$LOGS" && { echo "[ERROR] Found 'tls: expired certificate' in operator logs!"; exit 1; }
          grep -q "L2 controller cert generation completed successfully" <<<"$LOGS" && { READY=true; break; }
          sleep 3
        done
        [[ "$READY" == "true" ]] || { echo "[ERROR] Timed out waiting for L2 controller cert generation log."; exit 1; }
        echo "[SUCCESS] New Serial: $NEW_SERIAL | End Date: $NOT_AFTER | Next Rotate By: $(calc_rotate_by "$NOT_AFTER") (10 days before expiry)"
        ;;
      *)
        echo "Usage: $0 <check|rotate> [namespace]"
        echo "  check       : Validate current certificate status and operator start time."
        echo "  rotate      : Trigger immediate certificate rotation and restart the operator."
        echo "  [namespace] : Namespace of the operator (defaults to 'alloydb-omni-system')."
        exit 1 ;;
    esac
    EOF
    chmod +x rotate_cert.sh
    
  2. check モードで rotate_cert.sh スクリプトを実行して、現在の証明書の有効期限、推奨されるローテーション日、オペレーターのメモリ内ステータスを検査します。

    ./rotate_cert.sh check
    
  3. 省略可: 証明書をローテーションする前に、dbs-al-cert-l2-operator Secret をバックアップします。

    kubectl get secret dbs-al-cert-l2-operator -n alloydb-omni-system \
      -o yaml > dbs-al-cert-l2-operator-backup.yaml
    
  4. check の出力に [WARNING] が表示されている場合、または現在の日付が Recommended Rotate By の日付以前の場合は、rotate モードで rotate_cert.sh スクリプトを実行します。

    ./rotate_cert.sh rotate
    

    出力が [SUCCESS] で終わり、新しい証明書のシリアル番号、有効期限、次に推奨されるローテーション日が表示されていることを確認します。出力に [ERROR] が表示されるか、スクリプトがゼロ以外のステータスで終了した場合は、./rotate_cert.sh check を再実行し、kubectl logs deployment/local-controller-manager -n alloydb-omni-system -c local-manager(1.6.0 より前のオペレーター バージョンでは -c manager)を実行してオペレーター ログを調べます。

  5. 省略可: 手順 3 でバックアップ ファイルを作成した場合は、ローテーションが成功したことを確認した後、ローカル バックアップ ファイルを削除します。このファイルには古い秘密鍵が含まれています。

    rm -f dbs-al-cert-l2-operator-backup.yaml
    

バックアップされた証明書を復元する

ローテーション中に cert-manager が新しい証明書を発行できず、期限切れでない dbs-al-cert-l2-operator-backup.yaml ファイルにロールバックする必要がある場合は、次の手順に沿って操作します。

  1. dbs-al-cert-request-l2-operator 証明書の保留中または失敗した CertificateRequest リソースを削除して、cert-manager が SecretMismatch の理由で復元された秘密鍵を拒否し、復元された Secret を上書きしないようにします。

    REV="$(kubectl get certificate dbs-al-cert-request-l2-operator -n alloydb-omni-system -o jsonpath='{.status.revision}')"
    kubectl delete certificaterequest \
      "dbs-al-cert-request-l2-operator-$((REV + 1))" \
      -n alloydb-omni-system --ignore-not-found
    
  2. dbs-al-cert-l2-operator-backup.yaml ファイルから最上位の metadata.resourceVersion フィールドと metadata.uid フィールドを削除し、サーバーサイドの適用を使用して Secret を適用します。

    grep -vE '^  (resourceVersion|uid):' dbs-al-cert-l2-operator-backup.yaml \
      | kubectl apply --server-side --force-conflicts -f -
    
  3. local-controller-manager Deployment を再起動して、復元された証明書をメモリに読み込みます。

    kubectl rollout restart deployment/local-controller-manager -n alloydb-omni-system
    kubectl rollout status deployment/local-controller-manager -n alloydb-omni-system --timeout=180s
    
  4. check モードで rotate_cert.sh スクリプトを実行して、Certificate Serial 値がバックアップされた証明書のシリアル番号と一致し、スクリプトが [OK] を報告することを確認します。

    ./rotate_cert.sh check
    

    復元された証明書は元の有効期限を保持するため、Recommended Rotate By の日付までに証明書をローテーションする必要があります。

  5. 復元を確認したら、ローカル バックアップ ファイルを削除します。

    rm -f dbs-al-cert-l2-operator-backup.yaml