将 AlloyDB Omni Kubernetes 操作器升级到 1.5.0 版

选择文档版本：

本页面介绍如何将 AlloyDB Omni 操作器升级到 1.5.0 版。升级步骤取决于您当前的 AlloyDB Omni 版本以及您要升级到的版本。

准备工作

升级 AlloyDB Omni 操作器时，除非满足以下所有条件，否则数据库会重启：

您要将 AlloyDB Omni 操作器 1.1.1 版升级到较新版本。
您使用的是 AlloyDB Omni 数据库 15.5.5 版或更高版本。
AlloyDB AI 未启用。如需了解详情，请参阅使用 AlloyDB AI 创建数据库集群。

如果数据库重启，预期不会丢失任何数据。

从 AlloyDB Omni 数据库 15.7.1 版开始，基于 Kubernetes 的 AlloyDB Omni 数据库集群上的高可用性 (HA) 使用了一种新的架构，以便针对高可用性自动设置、故障切换和修复功能提供更强的安全加固和改进。

如果您要将 AlloyDB Omni 数据库版本从 15.7.0 版（或更低版本）升级到 15.7.1 版（或更高版本），或者如果您要降级版本，则必须先停用高可用性，并且必须在相应过程完成后重新启用高可用性。

确定您的当前版本

如需检查您的数据库集群使用的 AlloyDB Omni 版本，请运行以下命令：

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

进行以下替换：

DB_CLUSTER_NAME：您的数据库集群的名称。这是您在创建数据库集群时声明的同一个名称。如需了解详情，请参阅在 Kubernetes 上安装 AlloyDB Omni。
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 16.8.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 操作器，请按照以下步骤操作：

定义环境变量：

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.5.0。

下载最新的 AlloyDB Omni 操作器：

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

应用最新的 AlloyDB Omni 操作器自定义资源定义：
```
kubectl apply -f alloydbomni-operator/crds
```

升级 AlloyDB Omni 操作器 Helm 图表：

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

将 OpenShift 数据库集群从 1.4.1 版或更低版本更新

从 1.5.0 版开始，AlloyDB Omni 操作器与 OpenShift 的默认 restricted-v2 安全上下文限制条件兼容。对于运行 controlPlaneAgentsVersion 1.5.0 或更高版本的 OpenShift 上的新数据库集群，OpenShift 会为数据库工作负载注入任意用户 ID。对于运行更旧版本的数据库集群，数据库工作负载必须继续以默认用户 ID 999 运行。

如需将 OpenShift 上的数据库集群从低于 1.5.0 的 controlPlaneAgentsVersion 更新，请按照以下步骤操作：

为数据库集群的服务账号授予使用 anyuid 安全上下文限制条件的权限。这样，数据库工作负载便能以默认用户 ID 运行。
```
oc adm policy add-scc-to-user anyuid system:serviceaccount:NAMESPACE:DB_CLUSTER_NAME-sa
```
为数据库集群添加 openshift.io/scc=anyuid 注解。AlloyDB Omni 操作器 1.5.0 版或更高版本可识别此注解，并在 OpenShift 上以默认用户 ID 运行数据库工作负载，而不是允许平台注入任意 ID。
```
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE openshift.io/scc=anyuid
```
继续执行相关步骤，将数据库集群更新到最新版本。

更新数据库集群

如需更新 dbCluster，请完成以下步骤：

如果您要将高可用性 AlloyDB Omni 数据库集群从数据库 15.7.0 版（或更低版本）升级到 15.7.1 版（或更高版本），请先按以下步骤操作停用高可用性。

注意：如果您要从较低版本升级到 15.7.0 版（或更低版本），或者从 15.7.1 版（或更高版本）升级到较新版本，请跳过此步骤。
1. 在集群的清单中，将 numberOfStandbys 设置为 0。
```
spec:
  availability:
    numberOfStandbys: 0
```
1. 如要停用高可用性，请重新应用该清单。
更新集群清单中的 databaseVersion 和 controlPlaneAgentsVersion 版本，然后重新应用清单。

运行以下示例，该示例是清单文件的一部分，其中指定 databaseVersion 为 16.8.0 版，controlPlaneAgentsVersion 为 1.5.0 版：
```
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
  namespace: NAMESPACE
spec:
  databaseVersion: "16.8.0"
  controlPlaneAgentsVersion: "1.5.0"
...
```
执行以下变量替换操作：
- DB_CLUSTER_NAME：您的数据库集群的名称。这是您在创建数据库集群时声明的同一个名称。如需了解详情，请参阅在 Kubernetes 上安装 AlloyDB Omni。
- NAMESPACE：数据库集群的 Kubernetes 命名空间。
等待升级成功完成。
如果您在升级之前停用了高可用性，请完成以下步骤。
1. 在集群的清单中，将 numberOfStandbys 重新设置为升级前的数字。
2. 重新应用该清单以重新启用高可用性。

更新`alloydb_omni_instance_postgresql_wait_time_second_total`

如果您使用 alloydb_omni_instance_postgresql_wait_time_second_total 指标，则必须将其更新为 alloydb_omni_instance_postgresql_wait_time_us_total。如需同时使用这两个指标，请使用 Prometheus OR 运算符。

(promQL A) OR (promQL A, but replace all occurrences of alloydb_omni_instance_postgresql_wait_time_second_total to alloydb_omni_instance_postgresql_wait_time_us_total)

如果您使用 seconds 作为此指标的单位，则必须将其转换为 us。

如需了解详情，请参阅版本说明。