執行自助式維護

自助式維護功能可讓您視需要對 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 狀態旁會顯示「Update available」徽章。

  3. 按一下執行個體名稱，開啟「Instance details」(執行個體詳細資料) 頁面，查看可用的版本字串。

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

執行 gcloud lustre instances update 指令並加上 --target-version 旗標：

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 小時啟動，就會發生這種情況。