Mengupgrade operator AlloyDB Omni Kubernetes ke versi 1.7.0

Pilih versi dokumentasi:

Halaman ini menjelaskan cara mengupgrade operator AlloyDB Omni ke versi 1.7.0. Langkah-langkah untuk mengupgrade bergantung pada versi AlloyDB Omni Anda saat ini dan versi yang Anda upgrade.

Sebelum memulai

Saat Anda mengupgrade operator AlloyDB Omni, database akan dimulai ulang kecuali jika semua hal berikut benar:

  • Anda mengupgrade operator AlloyDB Omni versi 1.1.1 ke versi yang lebih baru.
  • Anda menggunakan database AlloyDB Omni versi 15.5.5 atau yang lebih baru.
  • AlloyDB AI tidak diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Membuat cluster database dengan AlloyDB AI.

Jika database dimulai ulang, tidak akan ada kehilangan data.

Mulai dari database AlloyDB Omni versi 15.7.1, ketersediaan tinggi (HA) pada cluster database AlloyDB Omni berbasis Kubernetes menggunakan arsitektur baru untuk memberikan lebih banyak penguatan dan peningkatan untuk penyiapan otomatis HA, failover, dan kemampuan pemulihan.

Jika Anda mengupgrade database AlloyDB Omni dari versi 15.7.0 (atau yang lebih lama) ke versi 15.7.1 (atau yang lebih baru), atau jika Anda melakukan downgrade versi, Anda harus menonaktifkan HA, dan Anda harus mengaktifkan kembali HA setelah proses selesai.

Menentukan versi Anda saat ini

Untuk memeriksa versi AlloyDB Omni yang digunakan oleh cluster database Anda, jalankan perintah berikut:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

Lakukan penggantian berikut:

  • DB_CLUSTER_NAME: nama cluster database Anda. Nama cluster database ini sama dengan yang Anda deklarasikan saat membuatnya. Untuk mengetahui informasi selengkapnya, lihat Menginstal AlloyDB Omni di Kubernetes.

  • NAMESPACE: namespace Kubernetes dari cluster database Anda.

Jika Anda menjalankan operator AlloyDB Omni versi 1.0.0 atau yang lebih baru, perintah ini akan mencetak versi AlloyDB Omni yang digunakan oleh cluster database Anda.

Untuk memeriksa versi operator AlloyDB Omni yang diinstal di cluster Kubernetes Anda, jalankan perintah berikut:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

Jika Anda menjalankan operator AlloyDB Omni versi 1.0.0 atau yang lebih baru, outputnya adalah nomor versi operator AlloyDB Omni yang berjalan di cluster Kubernetes Anda.

Jika Anda menjalankan operator AlloyDB Omni versi yang lebih lama dari 1.0.0, ikuti petunjuk di Mengupgrade dari operator AlloyDB Omni versi sebelum 1.0.0. Jika tidak, periksa nomor versi target Anda.

Memeriksa nomor versi target Anda

Jika Anda menjalankan operator AlloyDB Omni versi 1.0.0 atau yang lebih baru, langkah berikutnya bergantung pada versi AlloyDB Omni yang ingin Anda upgrade. Nomor versi AlloyDB Omni memiliki komponen berikut:

  • Nomor versi utama kompatibilitas PostgreSQL-nya
  • Nomor versi minor kompatibilitas PostgreSQL-nya
  • Nomor versi patch rilis AlloyDB Omni ini

Misalnya, AlloyDB Omni versi 18.1.0 mendukung PostgreSQL versi 15.7 dan tidak memiliki patch rilis AlloyDB Omni.

Pilih opsi penginstalan yang sesuai dengan versi target Anda:

Skenario penginstalan Langkah-langkah update
Anda ingin mengupgrade ke versi AlloyDB Omni yang mendukung PostgreSQL versi yang lebih baru. Upgrade operator AlloyDB Omni dan cluster database Anda. Setiap kumpulan rilis AlloyDB Omni yang mendukung versi minor PostgreSQL tertentu memiliki nomor versi operator AlloyDB Omni sendiri. Gunakan tabel kompatibilitas versi operator AlloyDB Omni untuk memverifikasi bahwa versi operator AlloyDB Omni Anda kompatibel dengan versi operator Anda.
Anda hanya ingin mengupgrade ke versi patch AlloyDB Omni yang lebih baru. Upgrade hanya cluster database Anda.
Semua skenario lainnya Ikuti langkah-langkah di mengupgrade operator AlloyDB Omni.

Mengupgrade operator AlloyDB Omni

Untuk mengupgrade operator AlloyDB Omni, ikuti langkah-langkah berikut:

Helm Kubernetes

  1. Perbarui definisi resource kustom (CRD) dengan menarik diagram dan menerapkannya secara manual:

    helm pull oci://gcr.io/alloydb-omni/alloydbomni-operator --version 1.7.0 --untar
kubectl apply -f ./alloydbomni-operator/crds

  2. Upgrade diagram Helm operator AlloyDB Omni:

    helm upgrade alloydbomni-operator oci://gcr.io/alloydb-omni/alloydbomni-operator \
  --version 1.7.0 \
  --namespace alloydb-omni-system \
  --atomic \
  --timeout 5m

OLM OperatorHub.io

Saat penginstalan, Anda menggunakan strategi persetujuan upgrade manual atau otomatis. Jika Anda memilih strategi upgrade otomatis, OLM akan mengupgrade versi operator Anda ke versi terbaru saat dirilis. Jika Anda memilih strategi upgrade manual, ikuti petunjuk OLM untuk menyetujui paket penginstalan saat rilis baru tersedia. Untuk mengetahui informasi selengkapnya, lihat Menyetujui Upgrade Secara Manual melalui Langganan.

OLM Red Hat OpenShift

Saat penginstalan, Anda menggunakan strategi persetujuan upgrade manual atau otomatis. Jika Anda memilih strategi upgrade otomatis, OLM akan mengupgrade versi operator Anda ke versi terbaru saat dirilis. Jika Anda memilih strategi upgrade manual, ikuti petunjuk OLM untuk menyetujui paket penginstalan saat rilis baru tersedia. Untuk mengetahui informasi selengkapnya, lihat Menyetujui Upgrade Secara Manual melalui Langganan.

Anda dapat menyetujui upgrade operator menggunakan konsol web OpenShift untuk versi OpenShift yang Anda gunakan.

Mengupdate cluster database OpenShift dari versi 1.4.1 atau yang lebih lama

Mulai versi 1.5.0, operator AlloyDB Omni kompatibel dengan batasan konteks keamanan restricted-v2 default OpenShift. Untuk cluster database baru di OpenShift yang menjalankan controlPlaneAgentsVersion 1.5.0 atau yang lebih baru, OpenShift akan menyisipkan ID pengguna arbitrer untuk workload database. Untuk cluster database yang menjalankan versi yang lebih lama, workload database harus terus berjalan sebagai ID pengguna default 999.

Untuk mengupdate cluster database di OpenShift dari controlPlaneAgentsVersion yang lebih lama dari 1.5.0, ikuti langkah-langkah berikut:

  1. Berikan izin akun layanan cluster database untuk menggunakan batasan konteks keamanan anyuid. Hal ini memungkinkan workload database berjalan sebagai ID pengguna default.

    oc adm policy add-scc-to-user anyuid system:serviceaccount:NAMESPACE:DB_CLUSTER_NAME-sa

  2. Anotasikan cluster database dengan openshift.io/scc=anyuid. Operator AlloyDB Omni versi 1.5.0 atau yang lebih baru mengenali anotasi ini dan menjalankan workload database sebagai ID pengguna default di OpenShift, bukan mengizinkan platform untuk menyisipkan ID arbitrer.

    kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE openshift.io/scc=anyuid

  3. Lanjutkan dengan langkah-langkah untuk mengupdate cluster database ke versi terbaru.

Mengupdate cluster database

Untuk mengupdate dbCluster, selesaikan langkah-langkah berikut:

  1. Jika Anda mengupgrade cluster database AlloyDB Omni HA dari database versi 15.7.0 (atau yang lebih lama) ke versi 15.7.1 (atau yang lebih baru), ikuti langkah-langkah berikut untuk menonaktifkan HA.

    1. Tetapkan numberOfStandbys ke 0 dalam manifes cluster.
    spec:
  availability:
    numberOfStandbys: 0
    1. Untuk menonaktifkan HA, terapkan kembali manifes.

  2. Perbarui versi databaseVersion dan controlPlaneAgentsVersion dalam manifes cluster, lalu terapkan kembali manifes.

    Jalankan contoh berikut, yang merupakan bagian dari file manifes yang menentukan databaseVersion versi 18.1.0 dan controlPlaneAgentsVersion versi 1.7.0:

    apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
  namespace: NAMESPACE
spec:
  databaseVersion: "18.1.0"
  controlPlaneAgentsVersion: "1.7.0"
...

    Ganti variabel berikut:

    • DB_CLUSTER_NAME: nama cluster database Anda. Nama cluster database ini sama dengan yang Anda deklarasikan saat membuatnya. Untuk mengetahui informasi selengkapnya, lihat Menginstal AlloyDB Omni di Kubernetes.
    • NAMESPACE: namespace Kubernetes dari cluster database Anda.

  3. Tunggu hingga upgrade berhasil diselesaikan.

  4. Jika Anda menonaktifkan HA sebelum upgrade, selesaikan langkah-langkah berikut.

    1. Tetapkan numberOfStandbys kembali ke angka sebelum upgrade dalam manifes cluster.

    2. Terapkan kembali manifes untuk mengaktifkan kembali HA.

Mengupdate alloydb_omni_instance_postgresql_wait_time_second_total

Jika Anda menggunakan metrik alloydb_omni_instance_postgresql_wait_time_second_total, Anda harus mengupdatenya ke alloydb_omni_instance_postgresql_wait_time_us_total. Untuk menggunakan kedua metrik, gunakan operator OR Prometheus.

(promQL A) OR (promQL A, but replace all occurrences of alloydb_omni_instance_postgresql_wait_time_second_total to alloydb_omni_instance_postgresql_wait_time_us_total)

Jika Anda menggunakan seconds sebagai unit untuk metrik ini, Anda harus mengonversinya ke us.

Untuk mengetahui informasi selengkapnya, lihat catatan rilis.