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-certlocal-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_NAMEdbs-al-cert-al-INSTANCE_ID-DB_CLUSTER_NAME-nmdbs-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-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 |
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-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 |
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 resourceDBClusterAnda.DATA_PLANE_ISSUER_NAME: nama penerbit cert-manager kustom yang dikonfigurasi dispec.primarySpec.tls.dataPlaneCertIssuer.name, jika ditentukan.BACKUP_REPO_NAME: nama resourceBackupRepositoryAnda, jika dikonfigurasi.PGBOUNCER_NAME: nama resourcePgBouncerAnda.
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 adalahIssuer.DATA_PLANE_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalahcert-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 adalahIssuer.CONTROL_PLANE_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalahcert-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 adalahIssuer.OPERATOR_CERT_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalahcert-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 adalahIssuer.OPERATOR_CERT_ISSUER_GROUP: grup API penerbit. Nilai defaultnya adalahcert-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_DURATIONdanCONTROL_PLANE_DURATION: durasi validitas sertifikat yang diminta sebagai durasi string—misalnya,720h0m0suntuk durasi kustom 30 hari. Di setiap blok permintaan sertifikat, Anda harus menentukandurationdanrenewBefore(denganrenewBeforekurang dariduration) atau menghilangkan kedua kolom tersebut. Jika kedua kolom dihilangkan, durasi defaultnya adalah1440h0m0s, atau 60 hari, untuk sertifikat bidang kontrol dan cadangan, serta87600h0m0s, atau 10 tahun, untuk sertifikat kueri autentikasi PgBouncer dan server database.DATA_PLANE_RENEW_BEFOREdanCONTROL_PLANE_RENEW_BEFORE: durasi sebelum masa berlaku berakhir saat cert-manager harus memulai upaya perpanjangan—misalnya,120h0m0suntuk lima hari sebelum masa berlaku berakhir. Di setiap blok permintaan sertifikat, Anda harus menentukandurationdanrenewBefore(denganrenewBeforekurang dariduration) atau menghilangkan kedua kolom tersebut. Jika kedua kolom dihilangkan, periode perpanjangan default adalah120h0m0s, atau lima hari, untuk sertifikat bidang kontrol dan cadangan, serta1440h0m0s, atau 60 hari, untuk sertifikat kueri autentikasi server database dan PgBouncer.DATA_PLANE_ALGORITHMdanCONTROL_PLANE_ALGORITHM: algoritma kunci pribadi. Nilai yang valid adalahRSA,ECDSA, atauEd25519.DATA_PLANE_KEY_SIZEdanCONTROL_PLANE_KEY_SIZE: ukuran kunci pribadi dalam bit. Jika algoritmanya adalahRSA, nilai yang valid adalah4096atau8192(defaultnya adalah4096). Jika algoritmanya adalahECDSA, nilai yang valid adalah384atau521(defaultnya adalah384). Jika algoritmanya adalahEd25519, ukuran akan diabaikan.DATA_PLANE_ROTATION_POLICYdanCONTROL_PLANE_ROTATION_POLICY: kebijakan yang mengontrol pembuatan ulang kunci pribadi. Nilai yang valid adalahAlwaysatauNever.
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, danbase64diPATHAnda. - Konfigurasikan akses ke cluster Kubernetes Anda
dan tetapkan konteks
kubectlaktif ke cluster target. Untuk mengonfirmasi konteks aktif, jalankankubectl 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:getpada resourceCertificatedan logPodgetdanlistdiPodresourcegetdandeletedi Secretdbs-al-cert-l2-operator(ditambahcreatedanpatchuntuk memulihkan Secret yang dicadangkan)getdanpatchpada Deploymentlocal-controller-managerdeletedi resourceCertificateRequest(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
Certificatedbs-al-cert-request-l2-operator - Memulai ulang Deployment
local-controller-manager - Memeriksa log Pod baru dan mencetak tanggal habis masa berlaku yang baru
- Menghapus Secret
Untuk memeriksa dan merotasi sertifikat klien operator, ikuti langkah-langkah berikut:
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.shJalankan skrip
rotate_cert.shdalam modecheckuntuk memeriksa tanggal habis masa berlaku sertifikat saat ini, tanggal rotasi yang direkomendasikan, dan status dalam memori operator:./rotate_cert.sh checkOpsional: Cadangkan Secret
dbs-al-cert-l2-operatorsebelum Anda merotasi sertifikat:kubectl get secret dbs-al-cert-l2-operator -n alloydb-omni-system \ -o yaml > dbs-al-cert-l2-operator-backup.yamlJika output
checkmenampilkan[WARNING], atau jika tanggal saat ini adalah pada atau sebelum tanggalRecommended Rotate By, jalankan skriprotate_cert.shdalam moderotate:./rotate_cert.sh rotatePastikan 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 checkdan periksa log operator dengan menjalankankubectl logs deployment/local-controller-manager -n alloydb-omni-system -c local-manager(atau-c managerdi versi operator sebelum 1.6.0).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:
Hapus resource
CertificateRequestyang tertunda atau gagal untuk sertifikatdbs-al-cert-request-l2-operatoragar cert-manager tidak menolak kunci pribadi yang dipulihkan dengan alasanSecretMismatchdan 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-foundHapus kolom
metadata.resourceVersiondanmetadata.uidlevel teratas dari filedbs-al-cert-l2-operator-backup.yamldan terapkan Secret menggunakan penerapan sisi server:grep -vE '^ (resourceVersion|uid):' dbs-al-cert-l2-operator-backup.yaml \ | kubectl apply --server-side --force-conflicts -f -Mulai ulang Deployment
local-controller-manageruntuk 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=180sJalankan skrip
rotate_cert.shdalam modecheckuntuk mengonfirmasi bahwa nilaiCertificate Serialcocok dengan nomor seri sertifikat yang dicadangkan dan bahwa skrip melaporkan[OK]:./rotate_cert.sh checkSertifikat yang dipulihkan akan mempertahankan tanggal habis masa berlaku aslinya, jadi Anda tetap harus merotasi sertifikat pada atau sebelum tanggal
Recommended Rotate By.Hapus file cadangan lokal setelah Anda mengonfirmasi pemulihan:
rm -f dbs-al-cert-l2-operator-backup.yaml