执行自助维护

如果您需要尽快将最新的 AlloyDB for PostgreSQL 更新应用于集群，可以执行自助维护。更新到最新版本可以解锁 AlloyDB 功能、应用补丁，并让您设置拒绝维护期，以防止在敏感时间段内发生中断。

如需了解详情，请参阅维护概览。

自行维护使用场景

AlloyDB 通常会为您执行集群维护，通过执行维护操作来升级集群中的数据库软件。默认情况下，AlloyDB 会在区域工作时间以外执行维护。您可以选择设置维护窗口，以定义首选的预定维护时间，并接收有关即将进行的预定维护的通知。对于给定的版本和 PostgreSQL 版本，系统会先完成没有维护窗口的集群的维护，然后安排有维护窗口的集群的维护。

您可能出于以下原因决定自行维护：

  • 您的集群跳过了维护。如果您设置了拒绝期，或者集群在迁移期间处于引导状态，则会发生这种情况。
  • 您的集群需要在预定维护之前进行更新。
  • 您需要在未保持最新状态的集群上设置拒绝期限。如果集群中的实例采用的是早期版本，则不一定支持设置拒绝期。
  • 您希望以自定义或不规则的频次运行维护作业。在这种情况下，您可以设置拒绝维护期，然后在需要时执行自助维护。拒绝期不会阻止自助维护。

更新期间的资源粒度

AlloyDB 仅支持集群级维护。 在集群内，AlloyDB 会确定实例更新的顺序。AlloyDB 会尝试并完成每个实例的维护，因此实例可能处于不同的版本。例如，集群可能会因拒绝维护期而跳过对现有实例的维护，然后在之后创建最新版本的实例。

查看可用的最新版本

如需了解最新版本，请参阅 AlloyDB 维护变更日志。在所有区域的集群上应用维护后，系统会更新更改日志。如需详细了解如何将最新版本应用于区域，请参阅最新版本。

查看实例的当前版本

如需使用 gcloud CLI，您可以安装并初始化 Google Cloud CLI，也可以使用 Cloud Shell。

仅支持在实例级别查看版本。

  1. 如需查看实例的当前维护版本，请运行 gcloud alloydb instances describe 命令：

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    替换以下内容：

    • INSTANCE_ID：您正在查看的实例的 ID。
    • CLUSTER_ID：实例所在集群的 ID。
    • LOCATION_ID：相应集群所在的 Google Cloud 区域，例如 us-central1。

  2. 在响应中，找到 maintenanceVersionName 字段，查看实例正在运行的版本。例如：

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

将集群更新到最新的可用版本

gcloud

如需使用 gcloud CLI，您可以安装并初始化 Google Cloud CLI，也可以使用 Cloud Shell。

如需将集群更新到最新版本，请运行带有 maintenance-version 标志的 gcloud alloydb clusters update 命令：

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

替换以下内容：

  • CLUSTER_ID：要更新为最新版本的集群的 ID。
  • LOCATION_ID：相应集群所在的 Google Cloud 区域，例如 us-central1。

示例响应：

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST v1

此示例将相应集群更新为最新版本。如需查看此调用的完整参数列表，请参阅方法：projects.locations.clusters.patch。

在使用任何请求数据之前，请先进行以下替换：

  • CLUSTER_ID：要更新为最新版本的集群。
  • PROJECT_ID：集群所在项目的 ID。
  • LOCATION_ID：相应集群所在的 Google Cloud 区域，例如 us-central1。

如需将集群更新到最新版本，请使用以下 PATCH 请求：

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_version_selection_policy}

maintenance_version_selection_policy 查询参数用于指定要将集群的实例更新到的版本。

请求 JSON 正文如下所示：

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

后续步骤