遷移至最新版 AlloyDB Omni Kubernetes 運算子

選取文件版本：

本頁說明如何將 AlloyDB Omni 運算子從 1.0.0 版升級至 1.1.0 版。

在 Kubernetes 中升級 AlloyDB Omni 的步驟，取決於您執行的 AlloyDB Omni 版本，以及要升級的版本。

確認目前的版本號碼

Kubernetes

如要查看資料庫叢集使用的 AlloyDB Omni 版本，請執行下列指令：

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

更改下列內容：

  • DB_CLUSTER_NAME：資料庫叢集的名稱。也就是您建立資料庫叢集時宣告的名稱。

  • NAMESPACE：資料庫叢集的 Kubernetes 命名空間。

如果您執行 AlloyDB Omni 運算子 1.0.0 版或更新版本，這項指令會列印資料庫叢集使用的 AlloyDB Omni 版本。

如要檢查 Kubernetes 叢集上安裝的 AlloyDB Omni Operator 版本，請執行下列指令：

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

如果您執行 AlloyDB Omni 運算子 1.0.0 版或更新版本，這個指令會列印 Kubernetes 叢集上執行的 AlloyDB Omni 運算子版本號碼。

如果您執行的 AlloyDB Omni Operator 版本早於 1.0.0，請按照「從 1.0.0 之前的 AlloyDB Omni Operator 版本升級」一文中的操作說明進行升級。

否則，請繼續參閱「檢查目標版本號碼」一節。

查看目標版本號碼

Kubernetes

如果您執行的是 AlloyDB Omni Operator 1.0.0 以上版本，接下來的步驟取決於要升級的 AlloyDB Omni 版本。因此，您必須瞭解 AlloyDB Omni 版本號碼。

AlloyDB Omni 版本號碼包含下列元件：

  • PostgreSQL 相容性的主要版本號碼
  • PostgreSQL 相容性的小版本號碼
  • 這個 AlloyDB Omni 版本的修補程式版本號碼

舉例來說，AlloyDB Omni 15.5.5 版是 AlloyDB Omni 的修補程式版本 5，支援 PostgreSQL 15.5 版。

如要升級至支援較新 PostgreSQL 版本的 AlloyDB Omni 版本，您必須一併升級 AlloyDB Omni Operator 和資料庫叢集。支援特定 PostgreSQL 次要版本的每組 AlloyDB Omni 版本，都有自己的 AlloyDB Omni Operator 版本號碼，您可以在 AlloyDB Omni 版本的發行說明中找到。

如果只想升級至較新的 AlloyDB Omni 修補程式版本，則可以只升級資料庫叢集，不需要升級 AlloyDB Omni 運算子本身。

如果不是，請繼續前往「升級 AlloyDB Omni 運算子」一節。

升級 AlloyDB Omni 運算子

Kubernetes

如要升級 AlloyDB Omni Operator，請按照下列步驟操作：

  1. 定義環境變數：

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

    將 OPERATOR_VERSION 替換為要升級的 AlloyDB Omni Operator 版本，例如 1.1.0。

  2. 下載最新版 AlloyDB Omni 運算子：

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

  3. 套用最新的 AlloyDB Omni 運算子自訂資源定義：

    kubectl apply -f alloydbomni-operator/crds

  4. 升級 AlloyDB Omni 運算子 Helm 圖表：

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

完成 AlloyDB Omni Operator 升級後，請按照「執行就地升級」一節中的操作說明，建立新的資料庫叢集。

如果 AlloyDB Omni 叢集是使用 AlloyDB Omni Operator 1.0.0 建立，請先在資訊清單中新增 controlPlaneAgentsVersion 欄位並設為 1.1.0，再將叢集升級至 15.5.5 版。否則，系統會顯示下列錯誤：

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

含有 controlPlaneAgentsVersion 欄位的資訊清單範例如下：

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