执行自助维护

借助自助维护，您可以按需对 Managed Lustre 实例应用维护升级。

Managed Lustre 发布新软件版本后，该版本会立即提供给自助维护。这通常是在自动维护到达您的实例前几周。

版本发布后，您可以随时执行自助维护。如果您的实例具有维护政策，则您可以在预定的维护窗口开始前 1 小时内执行自助维护。

如需简要了解维护影响和政策，请参阅维护概览。

查看可用的维护版本

Managed Lustre 实例使用以下版本字段跟踪维护版本：

  • effectiveVersion：仅限输出。实例上运行的软件发布版本。例如 Lustre_20260516.00_p00。
  • availableVersion：仅限输出。您的实例可以升级到的符合条件的较新软件发布版本。如果此字段为空，则表示您的实例已在运行最新的可用版本。
  • targetVersion：仅限输入。在更新请求中指定的参数，用于启动升级到候选版本或 latest。

如需验证实例的当前版本并检查是否有可用的升级，请执行以下操作：

Google Cloud 控制台

  1. 在 Google Cloud 控制台中，前往 Managed Lustre 页面：

    前往 Managed Lustre

  2. 在实例列表中，找到您的实例。如果有较新的维护版本可用，ACTIVE 状态旁边会显示有可用更新标志。

  3. 点击实例名称，打开实例详情页面，查看可用的版本字符串。

gcloud CLI

运行带有格式过滤器的 gcloud lustre instances describe 命令：

gcloud lustre instances describe INSTANCE_ID \
  --location=LOCATION \
  --format="yaml(effectiveVersion, availableVersion, state)"

替换以下内容：

  • INSTANCE_ID：Managed Lustre 实例的 ID。
  • LOCATION：实例所在的地区。

如果有新版本可用，输出将如下所示：

availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE

如果 availableVersion 为空，则表示您的实例已在运行最新的可用版本。

REST

如需查看实例的版本详细信息，请向实例端点发送 GET 请求：

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN

其中：

  • PROJECT_ID 是 Google Cloud 项目 ID。
  • LOCATION 是实例所在的可用区。
  • INSTANCE_ID 是 Managed Lustre 实例的 ID。

如果有新版本可用，响应中会包含 effectiveVersion 和 availableVersion：

{
  "name": "projects/my-project/locations/us-central1-a/instances/my-instance",
  "state": "ACTIVE",
  "effectiveVersion": "Lustre_20260516.00_p00",
  "availableVersion": "Lustre_20260716.01_p00"
}

如果省略 availableVersion 或其为空，则表示您的实例已在运行最新的可用版本。

如需了解详情，请参阅 instances.get API 参考文档。

执行自助升级

如需将实例升级到可用的软件版本，请执行以下操作：

gcloud CLI

运行带有 --target-version 标志的 gcloud lustre instances update 命令：

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=latest

替换以下内容：

  • INSTANCE_ID：Managed Lustre 实例的 ID。
  • LOCATION：实例所在的地区。

如需升级到特定合格发布版本（而非 latest），请传递版本字符串：

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=TARGET_VERSION

将 TARGET_VERSION 替换为 availableVersion 中的版本字符串。例如 Lustre_20260716.01_p00。

REST

如需使用 REST API 升级实例，请向实例端点发送 PATCH 请求，并在 updateMask 查询参数中指定 targetVersion：

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN

{
  "targetVersion": "latest"
}

其中：

  • PROJECT_ID 是 Google Cloud 项目 ID。
  • LOCATION 是实例所在的可用区。
  • INSTANCE_ID 是 Managed Lustre 实例的 ID。

如需升级到特定的合格发布版本（而非 latest），请在请求正文中指定版本字符串，例如 "targetVersion": "Lustre_20260716.01_p00"。

如需了解详情，请参阅 instances.patch API 参考文档。

跟踪维护进度

升级作为异步长时间运行的操作执行。自助维护不会触发自动邮件通知。

如需实时跟踪进度，请执行以下操作：

gcloud CLI

使用 gcloud lustre operations describe 命令轮询操作状态：

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

替换以下内容：

  • OPERATION_ID：更新命令返回的操作 ID。
  • LOCATION：实例所在的地区。

升级过程中，实例状态会显示为 UPGRADING，升级完成后会恢复为 ACTIVE。

REST

向 operations.get 端点发送 GET 请求：

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Authorization: Bearer ACCESS_TOKEN

其中：

  • PROJECT_ID 是 Google Cloud 项目 ID。
  • LOCATION 是实例所在的可用区。
  • OPERATION_ID 是更新请求返回的操作 ID。

如需了解详情，请参阅 operations.get API 参考文档。

升级成功后：

  1. 实例会返回到 ACTIVE 状态。
  2. effectiveVersion 反映了新应用的版本字符串。
  3. availableVersion 会被清除，并从 API 响应中省略。

与计划内维护的互动

如果您的实例有即将进行的计划内维护，则成功完成自助升级会自动取消该即将进行的计划内维护。如果您订阅了维护通知，则会收到系统自动发送的维护已取消电子邮件通知。

如果自助升级失败，待处理的计划内维护窗口不会取消。实例会返回到当前版本的 ACTIVE 状态，并保留预定的维护窗口。

您无法在即将到来的预定维护窗口前 1 小时内触发自助升级。在此期间尝试启动升级会返回 409 CONFLICT 错误，以避免与即将进行的计划内维护重叠。

错误消息

可能的自助维护错误包括：

  • Instance is already running version "<CURRENT>"：如果您尝试升级到实例上已运行的软件版本，则会发生此错误。
  • Downgrading to a lower version is not supported.：如果您尝试降级到较低的软件版本，则会发生此错误。
  • Version "<TARGET>" is not a valid update version.：如果指定的版本与实例的 availableVersion 字符串或 latest 不匹配，则会发生此错误。
  • Instance must be in ACTIVE state to update version：如果实例未处于 ACTIVE 状态时启动升级，则会发生此错误。
  • Cannot trigger self-service update within 1 hour of a scheduled maintenance window：如果自助升级在即将到来的预定维护窗口开始前不到 1 小时启动，则会发生此错误。