Bermigrasi ke Operator Kubernetes AlloyDB Omni versi terbaru

Pilih versi dokumentasi:

Halaman ini membahas petunjuk untuk mengupgrade dari versi 1.0.0 ke versi 1.1.0 AlloyDB Omni Operator.

Langkah-langkah yang Anda lakukan untuk mengupgrade AlloyDB Omni di Kubernetes bergantung pada versi AlloyDB Omni yang Anda jalankan, dan versi yang Anda upgrade.

Menentukan nomor versi saat ini

Kubernetes

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

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

Ganti kode berikut:

  • DB_CLUSTER_NAME: nama cluster database Anda. Nama cluster database ini sama dengan yang Anda deklarasikan saat Anda membuatnya.

  • NAMESPACE: namespace Kubernetes dari cluster database Anda.

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

Untuk memeriksa versi AlloyDB Omni Operator yang diinstal di cluster Kubernetes Anda, jalankan perintah ini:

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

Jika Anda menjalankan AlloyDB Omni Operator versi 1.0.0 atau yang lebih baru, perintah ini akan mencetak nomor versi AlloyDB Omni Operator yang berjalan di cluster Kubernetes Anda.

Jika Anda menjalankan versi AlloyDB Omni Operator yang lebih lama dari 1.0.0, ikuti petunjuk di Mengupgrade dari AlloyDB Omni Operator versi sebelum 1.0.0.

Jika tidak, lanjutkan ke bagian Memeriksa nomor versi target.

Memeriksa nomor versi target

Kubernetes

Jika Anda menjalankan AlloyDB Omni Operator versi 1.0.0 atau yang lebih baru, langkah berikutnya bergantung pada versi AlloyDB Omni yang ingin Anda upgrade. Hal ini memerlukan pemahaman tentang nomor versi AlloyDB Omni.

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.5.5 adalah versi patch 5 dari AlloyDB Omni yang mendukung PostgreSQL versi 15.5.

Jika ingin mengupgrade ke versi AlloyDB Omni yang mendukung PostgreSQL versi yang lebih baru, Anda harus mengupgrade AlloyDB Omni Operator itu sendiri, bersama dengan cluster database Anda. Setiap kumpulan rilis AlloyDB Omni yang mendukung versi minor PostgreSQL tertentu memiliki nomor versi AlloyDB Omni Operator sendiri, yang dapat Anda temukan di catatan rilis untuk versi AlloyDB Omni.

Jika hanya ingin mengupgrade ke versi patch AlloyDB Omni yang lebih baru, Anda hanya dapat mengupgrade cluster database, tanpa perlu mengupgrade AlloyDB Omni Operator itu sendiri.

Jika tidak, lanjutkan ke bagian Mengupgrade AlloyDB Omni Operator.

Mengupgrade AlloyDB Omni Operator

Kubernetes

Untuk mengupgrade AlloyDB Omni Operator, 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 AlloyDB Omni Operator yang Anda upgrade—misalnya, 1.1.0.

  2. Download AlloyDB Omni Operator terbaru:

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

  3. Terapkan definisi resource kustom AlloyDB Omni Operator terbaru:

    kubectl apply -f alloydbomni-operator/crds

  4. Upgrade diagram Helm AlloyDB Omni Operator:

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

Setelah menyelesaikan upgrade AlloyDB Omni Operator, ikuti petunjuk di Melakukan upgrade di tempat untuk membuat cluster database baru.

Jika cluster AlloyDB Omni Anda dibuat dengan AlloyDB Omni Operator 1.0.0, tambahkan kolom controlPlaneAgentsVersion ke manifes dan tetapkan ke 1.1.0 sebelum mengupgrade cluster ke versi 15.5.5. Jika tidak, error berikut akan ditampilkan:

admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.5 and/or control plane agents version 1.0.0

Manifes contoh dengan kolom controlPlaneAgentsVersion terlihat sebagai berikut:

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