Bermigrasi ke Operator Kubernetes AlloyDB Omni versi terbaru

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

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. Ini adalah nama cluster database yang sama dengan 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 AlloyDB Omni Operator yang diinstal di cluster Kubernetes, jalankan perintah ini:

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, perintah ini akan mencetak nomor versi Operator AlloyDB Omni yang berjalan di cluster Kubernetes Anda.

Jika Anda menjalankan versi AlloyDB Omni Operator sebelum 1.0.0, ikuti petunjuk di Mengupgrade dari AlloyDB Omni Operator pre-1.0.0.

Jika tidak, lanjutkan ke bagian Memeriksa nomor versi target.

Memeriksa nomor versi target

Kubernetes

Jika Anda menjalankan versi AlloyDB Omni Operator 1.0.0 atau yang lebih baru, langkah berikutnya akan bergantung pada versi AlloyDB Omni yang ingin Anda upgrade. Hal ini, pada gilirannya, 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 patch versi 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 Operator AlloyDB Omni itu sendiri, bersama dengan cluster database Anda. Setiap kumpulan rilis AlloyDB Omni yang mendukung versi minor PostgreSQL tertentu memiliki nomor versi AlloyDB Omni Operator-nya 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 dapat mengupgrade cluster database saja, tanpa perlu mengupgrade Operator AlloyDB Omni itu sendiri.

Jika tidak, lanjutkan ke bagian Mengupgrade Operator AlloyDB Omni.

Mengupgrade Operator AlloyDB Omni

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

  2. Download Operator AlloyDB Omni terbaru:

    gsutil 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

Setelah menyelesaikan upgrade Operator AlloyDB Omni, ikuti petunjuk di Melakukan upgrade in-place 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

Contoh manifes dengan kolom controlPlaneAgentsVersion terlihat seperti berikut:

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