セルフサービス メンテナンスを実施する

セルフサービス メンテナンスを使用すると、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 を使用してインスタンスをアップグレードするには、updateMask クエリ パラメータに targetVersion を指定して、インスタンス エンドポイントに PATCH リクエストを送信します。

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: update コマンドから返されたオペレーション ID。
  • LOCATION: インスタンスが配置されているゾーン。

アップグレードの進行中は、インスタンスの状態が UPGRADING と表示され、完了すると ACTIVE に戻ります。

REST

GET リクエストを operations.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 時間前までにセルフサービス アップグレードが開始された場合に発生します。