Kelola sertifikat

Pilih versi dokumentasi:

Penerbit sertifikat kustom memungkinkan Anda mengelola sertifikat Transport Layer Security (TLS) di cluster database AlloyDB Omni berbasis Kubernetes.

Secara default, operator Kubernetes AlloyDB Omni menggunakan cert-manager untuk menyediakan serangkaian sertifikat TLS untuk setiap cluster database. Selain sertifikat server database, operator juga membuat sertifikat untuk komponen bidang kontrol guna memastikan koneksi internal juga aman. Secara default, setiap sertifikat ditandatangani oleh penerbit yang dikelola oleh operator.

Jika Anda ingin semua sertifikat, termasuk sertifikat untuk komponen bidang kontrol, dirantai kembali ke root certificate authority (CA) tepercaya Anda sendiri, Anda dapat mengonfigurasi operator untuk menggunakan penerbit pilihan Anda. Dengan begitu, Anda dapat merantai semua sertifikat ke infrastruktur kunci publik (PKI) Anda sendiri, termasuk sertifikat yang digunakan untuk fungsi bidang kontrol, tanpa mengekspos detail implementasi setiap entity internal.

Masa berlaku sertifikat default

Secara default, operator AlloyDB Omni menggunakan cert-manager untuk menerbitkan dan memperpanjang sertifikat TLS secara otomatis untuk operator, bidang kontrol, dan instance database.

Tabel berikut mencantumkan durasi validitas default untuk sertifikat yang dikelola oleh operator AlloyDB Omni:

Jenis sertifikat Deskripsi sertifikat Nama rahasia Namespace Durasi default
Sertifikat klien mTLS operator Digunakan oleh Deployment local-controller-manager untuk koneksi dan health check ketersediaan tinggi (HA) antara operator dan agen bidang kontrol. dbs-al-cert-l2-operator Namespace operator 1440h0m0s (60 hari)
Sertifikat server webhook operator Digunakan oleh server webhook penerimaan operator untuk memvalidasi dan mengubah resource kustom. fleet-webhook-server-cert

local-webhook-server-cert
Namespace operator 1440h0m0s (60 hari)
Sertifikat agen bidang kontrol per instance Digunakan oleh agen database per instance, pengelola node, dan daemon cadangan untuk koneksi bidang kontrol. 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
Namespace cluster database 1440h0m0s (60 hari)
Sertifikat cadangan Digunakan oleh layanan pencadangan untuk koneksi pencadangan dan pemulihan. 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
Namespace cluster database 1440h0m0s (60 hari)
Sertifikat server database Mengamankan koneksi klien bidang data ke instance database. dbs-al-cert-DB_CLUSTER_NAME Namespace cluster database 87600h0m0s (10 tahun)
Sertifikat kueri autentikasi PgBouncer Sertifikat klien database yang digunakan oleh Deployment PgBouncer untuk terhubung ke database dan melakukan penggabungan koneksi. Hanya dibuat saat Anda membuat resource PgBouncer. dbs-al-pgb-cert-PGBOUNCER_NAME Namespace cluster database 87600h0m0s (10 tahun)
Sertifikat CA yang ditandatangani sendiri dan dikelola operator Sertifikat CA root yang digunakan oleh penerbit default yang ditandatangani sendiri oleh operator untuk menandatangani sertifikat operator, agen bidang kontrol, cadangan, dan server database. 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
Namespace operator dan namespace cluster database 87600h0m0s (10 tahun)

Dalam tabel ini, nama Secret menggunakan placeholder berikut:

  • INSTANCE_ID: ID 4 karakter yang dihasilkan untuk instance database.
  • DB_CLUSTER_NAME: nama resource DBCluster Anda.
  • DATA_PLANE_ISSUER_NAME: nama penerbit cert-manager kustom yang dikonfigurasi di spec.primarySpec.tls.dataPlaneCertIssuer.name, jika ditentukan.
  • BACKUP_REPO_NAME: nama resource BackupRepository Anda, jika dikonfigurasi.
  • PGBOUNCER_NAME: nama resource PgBouncer Anda.

Mengonfigurasi penerbit kustom

Anda dapat mengonfigurasi penerbit sertifikat kustom untuk cluster database, operator AlloyDB Omni, dan PgBouncer.

Untuk mengonfigurasi penerbit sertifikat, Anda harus membuat penerbit cert-manager terlebih dahulu yang terkait dengan CA yang Anda inginkan untuk menandatangani sertifikat. Anda dapat menggunakan salah satu jenis penerbit cert-manager atau penerbit eksternal yang kompatibel. Operator AlloyDB Omni mereferensikan penerbit ini saat membuat sertifikat.

Penerbit sertifikat cert-manager kustom harus mengisi kolom ca.crt di rahasia sertifikat yang dihasilkan dengan sertifikat root CA.

Sertifikat cluster database

Ada dua kolom spesifikasi cluster database untuk mengonfigurasi penerbit sertifikat:

  • spec.primarySpec.tls.dataPlaneCertIssuer: referensi ke penerbit cert-manager yang menyediakan sertifikat bidang data. CA penerbit adalah CA yang dapat dipercaya oleh klien database untuk memverifikasi database selama koneksi TLS.

  • spec.primarySpec.tls.controlPlaneAgentsCertIssuer: referensi ke penerbit cert-manager yang menyediakan sertifikat bidang kontrol. Sertifikat ini digunakan untuk koneksi internal.

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

Ganti kode berikut:

  • DATA_PLANE_ISSUER_NAME: nama penerbit cert-manager yang menyediakan sertifikat bidang data, seperti untuk server database.

  • DATA_PLANE_ISSUER_KIND: jenis API penerbit cert-manager. Nilai defaultnya adalah Issuer.

  • DATA_PLANE_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalah cert-manager.io.

  • CONTROL_PLANE_ISSUER_NAME: nama penerbit cert-manager yang menyediakan sertifikat bidang kontrol untuk komponen internal.

  • CONTROL_PLANE_ISSUER_KIND: jenis API penerbit cert-manager. Nilai defaultnya adalah Issuer.

  • CONTROL_PLANE_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalah cert-manager.io.

Sertifikat operator

Langkah-langkah untuk mengonfigurasi penerbit cert-manager untuk sertifikat operator bergantung pada metode yang digunakan untuk menginstal operator AlloyDB Omni.

Mengonfigurasi menggunakan Helm

Jika Anda menginstal operator AlloyDB Omni untuk pertama kalinya, gunakan helm install dan tetapkan nilai yang sesuai. Hal ini mengasumsikan bahwa Anda mengikuti petunjuk untuk men-deploy operator menggunakan 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

Jika Anda sudah menginstal operator dan perlu menetapkan penerbit sertifikat, gunakan helm upgrade untuk menetapkan nilai yang sesuai:

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

Ganti kode berikut:

  • OPERATOR_VERSION: versi operator AlloyDB Omni yang akan diinstal.

  • OPERATOR_CERT_ISSUER_NAME: nama penerbit cert-manager yang menyediakan sertifikat operator, yang digunakan untuk koneksi internal.

  • OPERATOR_CERT_ISSUER_KIND: jenis API penerbit cert-manager. Nilai defaultnya adalah Issuer.

  • OPERATOR_CERT_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalah cert-manager.io.

Mengonfigurasi menggunakan Operator Lifecycle Manager

Jika Anda menggunakan Operator Lifecycle Manager (OLM) untuk menginstal operator AlloyDB Omni, Anda dapat mengubah kolom spec.config.env resource Subscription untuk menetapkan variabel lingkungan CERT_MANAGER_ISSUER_NAME, CERT_MANAGER_ISSUER_KIND, dan CERT_MANAGER_ISSUER_GROUP dari operator Deployment.

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

Ganti kode berikut:

  • OPERATOR_CERT_ISSUER_NAME: nama penerbit cert-manager yang menyediakan sertifikat operator, yang digunakan untuk koneksi internal.

  • OPERATOR_CERT_ISSUER_KIND: jenis API penerbit cert-manager. Nilai defaultnya adalah Issuer.

  • OPERATOR_CERT_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalah cert-manager.io.

Sertifikat PgBouncer

Untuk mendukung penerbit kustom, pengontrol PgBouncer memeriksa kolom DBCluster spec.primarySpec.tls.dataPlaneCertIssuer dan menggunakannya untuk menyediakan sertifikat PgBouncer. Pengontrol PgBouncer juga menggunakan atribut yang dikonfigurasi di spec.primarySpec.tls.dataPlaneCertRequest untuk menyediakan sertifikat PgBouncer. Hal ini membantu memastikan bahwa PgBouncer menggunakan sertifikat dari CA yang sama yang memiliki atribut yang sama dengan database.

Mengonfigurasi atribut sertifikat kustom

Anda dapat menyesuaikan atribut sertifikat TLS yang dihasilkan oleh operator, seperti durasi sertifikat, periode perpanjangan, nama alternatif subjek (SAN), nama umum, dan konfigurasi kunci pribadi.

Konfigurasikan atribut sertifikat kustom di manifes DBCluster Anda:

  • spec.primarySpec.tls.dataPlaneCertRequest: menentukan atribut untuk sertifikat bidang data, termasuk server pgBackRest, kueri autentikasi PgBouncer, dan sertifikat server database.
  • spec.primarySpec.tls.controlPlaneAgentsCertRequest: menentukan atribut untuk menyediakan sertifikat bidang kontrol. Sertifikat ini digunakan untuk koneksi internal.

Mengonfigurasi permintaan sertifikat

Tentukan properti permintaan dalam format berikut:

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

Ganti kode berikut:

  • DATABASE_COMMON_NAME: (Opsional, khusus bidang data) nama umum sertifikat database.
  • DATABASE_DNS_NAME_1, DATABASE_DNS_NAME_2: (Opsional, hanya bidang data) daftar nama alternatif subjek (SAN) untuk sertifikat database.
  • DATA_PLANE_DURATION dan CONTROL_PLANE_DURATION: durasi validitas sertifikat yang diminta sebagai durasi string—misalnya, 720h0m0s untuk durasi kustom 30 hari. Di setiap blok permintaan sertifikat, Anda harus menentukan duration dan renewBefore (dengan renewBefore kurang dari duration) atau menghilangkan kedua kolom tersebut. Jika kedua kolom dihilangkan, durasi defaultnya adalah 1440h0m0s, atau 60 hari, untuk sertifikat bidang kontrol dan cadangan, serta 87600h0m0s, atau 10 tahun, untuk sertifikat kueri autentikasi PgBouncer dan server database.
  • DATA_PLANE_RENEW_BEFORE dan CONTROL_PLANE_RENEW_BEFORE: durasi sebelum masa berlaku berakhir saat cert-manager harus memulai upaya perpanjangan—misalnya, 120h0m0s untuk lima hari sebelum masa berlaku berakhir. Di setiap blok permintaan sertifikat, Anda harus menentukan duration dan renewBefore (dengan renewBefore kurang dari duration) atau menghilangkan kedua kolom tersebut. Jika kedua kolom dihilangkan, periode perpanjangan default adalah 120h0m0s, atau lima hari, untuk sertifikat bidang kontrol dan cadangan, serta 1440h0m0s, atau 60 hari, untuk sertifikat kueri autentikasi server database dan PgBouncer.
  • DATA_PLANE_ALGORITHM dan CONTROL_PLANE_ALGORITHM: algoritma kunci pribadi. Nilai yang valid adalah RSA, ECDSA, atau Ed25519.
  • DATA_PLANE_KEY_SIZE dan CONTROL_PLANE_KEY_SIZE: ukuran kunci pribadi dalam bit. Jika algoritmanya adalah RSA, nilai yang valid adalah 4096 atau 8192 (defaultnya adalah 4096). Jika algoritmanya adalah ECDSA, nilai yang valid adalah 384 atau 521 (defaultnya adalah 384). Jika algoritmanya adalah Ed25519, ukuran akan diabaikan.
  • DATA_PLANE_ROTATION_POLICY dan CONTROL_PLANE_ROTATION_POLICY: kebijakan yang mengontrol pembuatan ulang kunci pribadi. Nilai yang valid adalah Always atau Never.

Sertifikat klien operator dan cadangan

Untuk menyesuaikan atribut sertifikat bagi operator dan klien cadangan (yang dibagikan di semua instance dalam namespace dan tidak dikelola oleh spesifikasi cluster database), ubah resource kustom Certificate. Operator mempertahankan modifikasi manual ini.

Membersihkan secret sertifikat

Saat Anda menghapus resource DBCluster, operator AlloyDB Omni akan menghapus resource Certificate terkait, tetapi cert-manager tidak akan membersihkan resource Secret sertifikat secara default. Untuk mengonfigurasi pengontrol cert-manager agar membersihkan secret saat sertifikat dihapus, lihat Membersihkan secret saat sertifikat dihapus dalam dokumentasi cert-manager.

Jika Anda telah menghapus resource DBCluster tanpa mengonfigurasi pembersihan otomatis, hapus secret sertifikat yang tidak terpakai secara manual:

kubectl delete secret CERTIFICATE_SECRET_NAME -n NAMESPACE

Ganti kode berikut:

  • CERTIFICATE_SECRET_NAME: nama secret sertifikat yang akan dihapus.
  • NAMESPACE: namespace cluster database.

Verifikasi

Untuk memverifikasi bahwa operator Deployment berfungsi dengan baik dan variabel lingkungan CERT_MANAGER_ISSUER_NAME, CERT_MANAGER_ISSUER_KIND, dan CERT_MANAGER_ISSUER_GROUP telah ditetapkan, jalankan perintah berikut:

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

Untuk memverifikasi bahwa penerbit yang benar digunakan, periksa objek Certificate sebagai berikut:

kubectl get certificate -n NAMESPACE

Ganti NAMESPACE dengan namespace cluster database Anda atau alloydb-omni-system untuk sertifikat operator.

Periksa kolom issuerRef dalam output untuk setiap sertifikat guna mengonfirmasi bahwa sertifikat tersebut cocok dengan penerbit kustom Anda.

Mengurangi masa berlaku sertifikat klien operator di versi operator sebelum 1.8.2

Di operator AlloyDB Omni versi sebelum 1.8.2, Deployment local-controller-manager meng-cache sertifikat klien mTLS dbs-al-cert-l2-operator 60 hari dalam memori untuk koneksi health check HA ke agen bidang kontrol. Meskipun cert-manager otomatis memperpanjang Secret dbs-al-cert-l2-operator lima hari sebelum masa berlakunya habis, Deployment local-controller-manager tidak akan memuat ulang sertifikat yang diperpanjang hingga Pod operator dimulai ulang. Saat masa berlaku sertifikat yang di-cache berakhir pada hari ke-60, koneksi ulang health check berikutnya akan gagal dengan error tls: expired certificate dan dapat memicu failover HA yang tidak direncanakan.

Untuk menyelesaikan masalah ini secara permanen, upgrade operator AlloyDB Omni ke versi 1.8.2 atau yang lebih baru.

Jika Anda tidak dapat langsung mengupgrade ke operator versi 1.8.2 atau yang lebih baru, rotasikan Secret dbs-al-cert-l2-operator dan mulai ulang Deployment local-controller-manager setidaknya 10 hari sebelum masa berlaku sertifikat berakhir. Prosedur ini tidak memulai ulang Pod database atau mengganggu traffic database.

Sebelum memulai

Sebelum menjalankan skrip rotate_cert.sh, pastikan lingkungan Anda memenuhi persyaratan berikut:

  • Instal bash, kubectl, openssl, dan base64 di PATH Anda.
  • Konfigurasikan akses ke cluster Kubernetes Anda dan tetapkan konteks kubectl aktif ke cluster target. Untuk mengonfirmasi konteks aktif, jalankan kubectl config current-context. Ulangi prosedur ini untuk setiap cluster yang menjalankan versi operator sebelum 1.8.2.
  • Pastikan akun Anda memiliki izin kontrol akses berbasis peran (RBAC) Kubernetes di namespace operator, yang secara default ditetapkan ke alloydb-omni-system:
    • get pada resource Certificate dan log Pod
    • get dan list di Pod resource
    • get dan delete di Secret dbs-al-cert-l2-operator (ditambah create dan patch untuk memulihkan Secret yang dicadangkan)
    • get dan patch pada Deployment local-controller-manager
    • delete di resource CertificateRequest (untuk memulihkan Secret yang dicadangkan)

Merotasi sertifikat klien operator

Skrip rotate_cert.sh mendukung dua mode dan argumen namespace opsional, yang secara default ditetapkan ke alloydb-omni-system:

  • ./rotate_cert.sh check: melakukan pemeriksaan hanya baca dan mencetak informasi berikut:
    • Nomor seri dan tanggal validitas sertifikat saat ini
    • Batas waktu rotasi yang direkomendasikan, ditetapkan 10 hari sebelum masa berlaku habis
    • Waktu mulai container local-controller-manager
    • Status sertifikat dalam memori [OK] atau [WARNING]
    • Perintah pencadangan kubectl
  • ./rotate_cert.sh rotate: melakukan tindakan berikut:
    • Menghapus Secret dbs-al-cert-l2-operator
    • Menunggu cert-manager menerbitkan nomor seri sertifikat baru dan memperbarui resource Certificate dbs-al-cert-request-l2-operator
    • Memulai ulang Deployment local-controller-manager
    • Memeriksa log Pod baru dan mencetak tanggal habis masa berlaku yang baru

Untuk memeriksa dan merotasi sertifikat klien operator, ikuti langkah-langkah berikut:

  1. Simpan skrip berikut ke file bernama rotate_cert.sh, lalu buat file tersebut dapat dieksekusi:

    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. Jalankan skrip rotate_cert.sh dalam mode check untuk memeriksa tanggal habis masa berlaku sertifikat saat ini, tanggal rotasi yang direkomendasikan, dan status dalam memori operator:

    ./rotate_cert.sh check
    
  3. Opsional: Cadangkan Secret dbs-al-cert-l2-operator sebelum Anda merotasi sertifikat:

    kubectl get secret dbs-al-cert-l2-operator -n alloydb-omni-system \
      -o yaml > dbs-al-cert-l2-operator-backup.yaml
    
  4. Jika output check menampilkan [WARNING], atau jika tanggal saat ini adalah pada atau sebelum tanggal Recommended Rotate By, jalankan skrip rotate_cert.sh dalam mode rotate:

    ./rotate_cert.sh rotate
    

    Pastikan output diakhiri dengan [SUCCESS] dan menampilkan nomor seri sertifikat baru, tanggal habis masa berlaku, dan tanggal rotasi berikutnya yang direkomendasikan. Jika output menampilkan [ERROR] atau skrip keluar dengan status bukan nol, jalankan kembali ./rotate_cert.sh check dan periksa log operator dengan menjalankan kubectl logs deployment/local-controller-manager -n alloydb-omni-system -c local-manager (atau -c manager di versi operator sebelum 1.6.0).

  5. Opsional: Jika Anda membuat file cadangan di langkah 3, hapus file cadangan lokal setelah mengonfirmasi bahwa rotasi berhasil karena file tersebut berisi kunci pribadi lama:

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

Memulihkan sertifikat yang dicadangkan

Jika cert-manager gagal menerbitkan sertifikat baru selama rotasi dan Anda perlu melakukan roll back ke file dbs-al-cert-l2-operator-backup.yaml yang belum habis masa berlakunya, ikuti langkah-langkah berikut:

  1. Hapus resource CertificateRequest yang tertunda atau gagal untuk sertifikat dbs-al-cert-request-l2-operator agar cert-manager tidak menolak kunci pribadi yang dipulihkan dengan alasan SecretMismatch dan menimpa Secret yang dipulihkan:

    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. Hapus kolom metadata.resourceVersion dan metadata.uid level teratas dari file dbs-al-cert-l2-operator-backup.yaml dan terapkan Secret menggunakan penerapan sisi server:

    grep -vE '^  (resourceVersion|uid):' dbs-al-cert-l2-operator-backup.yaml \
      | kubectl apply --server-side --force-conflicts -f -
    
  3. Mulai ulang Deployment local-controller-manager untuk memuat sertifikat yang dipulihkan ke dalam memori:

    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. Jalankan skrip rotate_cert.sh dalam mode check untuk mengonfirmasi bahwa nilai Certificate Serial cocok dengan nomor seri sertifikat yang dicadangkan dan bahwa skrip melaporkan [OK]:

    ./rotate_cert.sh check
    

    Sertifikat yang dipulihkan akan mempertahankan tanggal habis masa berlaku aslinya, jadi Anda tetap harus merotasi sertifikat pada atau sebelum tanggal Recommended Rotate By.

  5. Hapus file cadangan lokal setelah Anda mengonfirmasi pemulihan:

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