迁移到最新版本的 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 operator 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"
...