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

選取說明文件版本：

本頁說明如何升級 AlloyDB Omni 運算子。在 Kubernetes 中升級 AlloyDB Omni 的步驟，取決於目前的 AlloyDB Omni 版本和升級版本。

判斷目前的版本

如要查看資料庫叢集使用的 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 運算子版本，請執行下列指令：

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 運算子版本早於 1.0.0，請按照「從 1.0.0 之前的 AlloyDB Omni 運算子升級」一文中的操作說明進行升級。否則，請繼續進行「檢查目標版本號碼」。

查看目標版本號碼

如果您執行的是 AlloyDB Omni 運算子 1.0.0 以上版本，接下來的步驟取決於要升級的 AlloyDB Omni 版本。AlloyDB Omni 版本號碼包含下列元件：

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

舉例來說，AlloyDB Omni 15.7.0 版支援 PostgreSQL 15.7 版，且沒有 AlloyDB Omni 發布修補程式。

選擇適合目標版本的安裝選項：

安裝情境 更新步驟
您想升級至支援較新版 PostgreSQL 的 AlloyDB Omni 版本。 升級 AlloyDB Omni 運算子和資料庫叢集。 支援特定 PostgreSQL 次要版本的每組 AlloyDB Omni 版本，都有自己的 AlloyDB Omni 運算子版本號碼，您可以在 AlloyDB Omni 版本的版本資訊中找到。請參閱 AlloyDB Omni 運算子版本相容性表，確認 AlloyDB Omni 運算子版本與運算子版本是否相容。
您只想升級至較新的 AlloyDB Omni 修補程式版本。 升級 資料庫叢集。升級前，請先查看 AlloyDB Omni 運算子版本相容性表格和版本資訊，判斷是否也需要更新 AlloyDB Omni 運算子。
所有其他情境 按照升級 AlloyDB Omni 運算子中的步驟操作。

升級 AlloyDB Omni 運算子

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

  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 運算子版本，例如 1.3.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

    如要更新 dbCluster，請更新資訊清單檔案中的 databaseVersion 和 controlPlaneAgentsVersion 版本。以下是資訊清單檔案的一部分，指定 databaseVersion 的版本為 15.7.0，controlPlaneAgentsVersion 的版本為 1.3.0：

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