迁移到最新版本的 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 操作器版本，请运行以下命令：

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 操作器升级中的说明操作。

否则，请继续阅读检查目标版本号部分。

检查目标版本号

Kubernetes

如果您运行的是 AlloyDB Omni 操作器 1.0.0 版或更高版本，则后续步骤取决于您要升级到的 AlloyDB Omni 版本。这进而需要了解 AlloyDB Omni 版本号。

AlloyDB Omni 版本号包含以下组成部分：

  • PostgreSQL 兼容性的主要版本号
  • PostgreSQL 兼容性的次要版本号
  • 此 AlloyDB Omni 发布版本的补丁版本号

例如，AlloyDB Omni 15.5.5 版是支持 PostgreSQL 15.5 版的 AlloyDB Omni 的第 5 个补丁版本。

如果您希望升级到支持较新版本 PostgreSQL 的 AlloyDB Omni 版本，则必须将 AlloyDB Omni 操作器本身与您的数据库集群一起升级。每组支持特定 PostgreSQL 次要版本的 AlloyDB Omni 发布版本都有自己的 AlloyDB Omni 操作器版本号，您可以在 AlloyDB Omni 版本的版本说明中找到该版本号。

如果您只想升级到较新的 AlloyDB Omni 补丁版本，则可以只升级数据库集群，而无需升级 AlloyDB Omni 操作器本身。

否则，请继续阅读升级 AlloyDB Omni 操作器部分。

升级 AlloyDB Omni 操作器

Kubernetes

如需升级 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.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 操作器升级后，请按照执行就地升级中的说明创建新的数据库集群。

如果您的 AlloyDB Omni 集群是使用 AlloyDB Omni 操作器 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"
...