Bermigrasi ke operator AlloyDB Omni Kubernetes versi terbaru

Pilih versi dokumentasi:

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

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 nama cluster database yang Anda deklarasikan saat membuatnya.

  • NAMESPACE: namespace Kubernetes 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 lebih lama dari 1.0.0, ikuti petunjuk di Mengupgrade dari operator AlloyDB Omni versi sebelum 1.0.0. Jika tidak, lanjutkan dengan Periksa nomor versi target Anda.

Periksa nomor versi target Anda

Jika Anda menjalankan operator AlloyDB Omni versi 1.0.0 atau yang lebih baru, langkah selanjutnya 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 15.7.0 mendukung PostgreSQL versi 15.7 dan tidak memiliki patch rilis AlloyDB Omni.

Pilih opsi penginstalan yang sesuai untuk 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 set rilis AlloyDB Omni yang mendukung versi minor PostgreSQL tertentu memiliki nomor versi operator AlloyDB Omni sendiri, yang dapat Anda temukan di catatan rilis untuk versi AlloyDB Omni. 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. Periksa tabel kompatibilitas versi operator AlloyDB Omni dan catatan rilis sebelum Anda mengupgrade untuk menentukan apakah Anda juga perlu mengupdate operator AlloyDB Omni.
Semua skenario lainnya Ikuti langkah-langkah di mengupgrade operator AlloyDB Omni.

Mengupgrade operator AlloyDB Omni

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

  1. Tentukan variabel lingkungan:

    export GCS_BUCKET=alloydb-omni-operator
export OPERATOR_VERSION=OPERATOR_VERSION
export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

    Ganti OPERATOR_VERSION dengan versi operator AlloyDB Omni yang akan Anda upgrade—misalnya, 1.3.0.

  2. Download operator AlloyDB Omni terbaru:

    gcloud storage cp -r gs://$GCS_BUCKET/$HELM_PATH ./
tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

  3. Terapkan definisi resource kustom operator AlloyDB Omni terbaru:

    kubectl apply -f alloydbomni-operator/crds

  4. Upgrade diagram Helm operator AlloyDB Omni:

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

    Untuk mengupdate dbCluster, Anda harus mengupdate databaseVersion dan controlPlaneAgentsVersion versi dalam file manifes. Berikut adalah bagian dari file manifes yang menentukan databaseVersion versi 15.7.0 dan controlPlaneAgentsVersion versi 1.3.0:

    apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
name: DB_CLUSTER_NAME
spec:
databaseVersion: "15.7.0"
controlPlaneAgentsVersion: "1.3.0"
...