カスタム証明書発行者を使用すると、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-certlocal-webhook-server-cert |
オペレーターの名前空間 | 1440h0m0s(60 日間) |
| インスタンスごとのコントロール プレーン エージェント証明書 | インスタンスごとのデータベース エージェント、ノード マネージャー、バックアップ デーモンがコントロール プレーン接続に使用します。 | dbs-al-cert-dbd-INSTANCE_ID-DB_CLUSTER_NAMEdbs-al-cert-al-INSTANCE_ID-DB_CLUSTER_NAME-nmdbs-al-cert-backup-daemon-BACKUP_REPO_NAME |
データベース クラスタの名前空間 | 1440h0m0s(60 日間) |
| バックアップ証明書 | バックアップ サービスがバックアップと復元の接続に使用します。 | dbs-al-cert-backup-clientdbs-al-cert-backup-client-DATA_PLANE_ISSUER_NAMEdbs-al-cert-backup-server-INSTANCE_ID-DB_CLUSTER_NAMEdbs-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-operatordbs-al-ca-DB_CLUSTER_NAMEdbs-al-ca-dbd-INSTANCE_ID-DB_CLUSTER_NAMEdbs-al-ca-backup-serverdbs-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ログに対するgetPodリソースに対するgetとlistdbs-al-cert-l2-operatorSecret のgetとdelete(バックアップされた Secret を復元するためのcreateとpatch)local-controller-managerDeployment のgetとpatchCertificateRequestリソースに対する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-operatorSecret を削除します。- cert-manager が新しい証明書のシリアル番号を発行し、
dbs-al-cert-request-l2-operatorCertificateリソースを更新するまで待機します。 local-controller-managerDeployment を再起動します。- 新しい Pod のログを確認し、新しい有効期限を出力します。
オペレーター クライアント証明書を確認してローテーションする手順は次のとおりです。
次のスクリプトを
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.shcheckモードでrotate_cert.shスクリプトを実行して、現在の証明書の有効期限、推奨されるローテーション日、オペレーターのメモリ内ステータスを検査します。./rotate_cert.sh check省略可: 証明書をローテーションする前に、
dbs-al-cert-l2-operatorSecret をバックアップします。kubectl get secret dbs-al-cert-l2-operator -n alloydb-omni-system \ -o yaml > dbs-al-cert-l2-operator-backup.yamlcheckの出力に[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)を実行してオペレーター ログを調べます。省略可: 手順 3 でバックアップ ファイルを作成した場合は、ローテーションが成功したことを確認した後、ローカル バックアップ ファイルを削除します。このファイルには古い秘密鍵が含まれています。
rm -f dbs-al-cert-l2-operator-backup.yaml
バックアップされた証明書を復元する
ローテーション中に cert-manager が新しい証明書を発行できず、期限切れでない dbs-al-cert-l2-operator-backup.yaml ファイルにロールバックする必要がある場合は、次の手順に沿って操作します。
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-founddbs-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 -local-controller-managerDeployment を再起動して、復元された証明書をメモリに読み込みます。kubectl rollout restart deployment/local-controller-manager -n alloydb-omni-system kubectl rollout status deployment/local-controller-manager -n alloydb-omni-system --timeout=180scheckモードでrotate_cert.shスクリプトを実行して、Certificate Serial値がバックアップされた証明書のシリアル番号と一致し、スクリプトが[OK]を報告することを確認します。./rotate_cert.sh check復元された証明書は元の有効期限を保持するため、
Recommended Rotate Byの日付までに証明書をローテーションする必要があります。復元を確認したら、ローカル バックアップ ファイルを削除します。
rm -f dbs-al-cert-l2-operator-backup.yaml