Google Cloud Managed Lustre インスタンスを管理する

インスタンスを作成すると、Google Cloud Managed Lustre でインスタンスの 一覧表示、取得、更新、削除を行うことができます。

インスタンスの状態

Managed Lustre インスタンスは、次のいずれかの状態になります。

状態 説明
CREATING インスタンスが作成中で、まだ使用できる状態ではありません。
ACTIVE インスタンスを使用できます。
REPAIRING インスタンスを修復しています。
MAINTENANCE または UPGRADING インスタンスはメンテナンス中です。 詳細については、 メンテナンス イベントとポリシーをご覧ください。
SUSPENDED インスタンスは一時停止しています。通常は、顧客管理の暗号鍵（CMEK）に問題があることが原因です。
DELETING インスタンスを削除しています。

インスタンスの一覧取得

プロジェクト内のすべてのインスタンスを一覧表示するには:

Google Cloud コンソール

  1. コンソールで、[Managed Lustre] ページに移動します。 Google Cloud

    Managed Lustre に移動

    プロジェクトのインスタンスが一覧表示されます。

gcloud CLI

gcloud lustre instances list コマンドを使用します。

gcloud lustre instances list --location=LOCATION

LOCATION を特定のゾーンに置き換えて、その ロケーションにあるすべてのインスタンスを一覧表示します。すべての ロケーションのプロジェクトを表示するには、値として - を入力します。次に例を示します。

gcloud lustre instances list --location=-

REST

REST API を使用してインスタンスを一覧表示するには、次のエンドポイントにリクエストを送信します。

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

次の値を指定する必要があります。

  • PROJECT_ID は Google Cloud プロジェクト ID です。

  • ZONE は、すべてのインスタンスを一覧表示するゾーンです。すべてのゾーンのインスタンスを一覧表示するには、値として - を使用します。

詳細については、instances.list API リファレンスをご覧ください。

インスタンスを取得する

インスタンスの詳細を取得するには:

Google Cloud コンソール

  1. コンソールで、[Managed Lustre] ページに移動します。 Google Cloud

    Managed Lustre に移動

  2. インスタンス名をクリックすると、特定のインスタンスの詳細が表示されます。

gcloud CLI

gcloud lustre instances describe コマンドを使用します。

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

REST API を使用して特定のインスタンスの詳細を取得するには、次のエンドポイントにリクエストを送信します。

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

次の値を指定する必要があります。

  • PROJECT_ID は Google Cloud プロジェクト ID です。

  • ZONE は、 Managed Lustre でサポートされている有効な Google Cloud ゾーンである必要があります。完全なリストについては、 サポートされているロケーションをご覧ください。

  • INSTANCE_NAME は、返される Managed Lustre インスタンスの名前です。

詳細については、instances.get API リファレンスをご覧ください。

インスタンスの更新

既存のインスタンスの次のプロパティを更新できます。

  • 説明
  • ラベル
  • ストレージ容量
  • メンテナンス ポリシー

インスタンスのストレージ容量を増やす方法については、 インスタンスの容量を増やすをご覧ください。

メンテナンス ポリシーの構成については、 メンテナンス イベントとポリシーをご覧ください。

インスタンスを更新するには:

Google Cloud コンソール

  1. コンソールで、[Managed Lustre] ページに移動します。 Google Cloud

    Managed Lustre に移動

  2. 更新するインスタンスのインスタンス名 をクリックします。インスタンスの概要ページが表示されます。

  3. [編集] をクリックします。

  4. 新しい値を入力します。

  5. [送信] をクリックします。

gcloud CLI

gcloud lustre instances update コマンドを使用します。

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION \
  --maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}

ここで

  • INSTANCE_NAME は、更新するインスタンスです。
  • LOCATION は、インスタンスが存在するゾーンです。
  • NEW_CAPACITY は、このインスタンスの新しいストレージ容量（ ギビバイト（GiB）単位）です。値は、許容される最大容量を超えないようにし、ステップサイズの倍数にする必要があります。詳細については、 インスタンスの容量を増やすをご覧ください。

  • NEW_DESCRIPTION は、説明フィールドの新しい値です。 既存の説明は上書きされます。

  • DAY: メンテナンスの時間枠の曜日（例: TUESDAY）。

  • START_TIME：メンテナンスの時間枠の UTC 開始時間（辞書 形式）（例: {hours=1,minutes=0}）。

ラベルを更新するには、 gcloud lustre instances update のドキュメントで利用可能なコマンドをご覧ください。

REST

REST API を使用してインスタンスを更新するには、特定のエンドポイントに PATCH リクエストを送信します。

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  },
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}

次の値を指定する必要があります。

  • PROJECT_ID は Google Cloud プロジェクト ID です。
  • ZONE はインスタンスの Google Cloud ゾーンです。
  • INSTANCE_NAME は、更新する Managed Lustre インスタンスの名前です。
  • UPDATE_MASK は、更新するフィールドのカンマ区切りのリストです。フィールドは、マスクに含まれている場合にのみ上書きされます。

リクエストの本文には、次のフィールドの 1 つ以上を含める必要があります。

  • capacityGiB は、このインスタンスの新しいストレージ容量（ギビバイト（GiB）単位）です。値は、許容される最大容量を超えないようにし、ステップサイズの倍数にする必要があります。詳細については、 インスタンスの容量を増やすをご覧ください。
  • description は、このインスタンスの新しい説明です。
  • labels は、このインスタンスの新しいラベルセットです。labels の値は、1 つ以上の key:value ペアを含む JSON オブジェクトです。
  • maintenancePolicy は、インスタンスのメンテナンス ポリシーです。詳細については、 メンテナンス イベントとポリシーをご覧ください。

詳細については、instances.patch API リファレンスをご覧ください。

オペレーションをキューに登録できない

インスタンスの更新時に次のようなエラーが表示される場合:

ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation

このエラーは、同じインスタンスで同じタイプの別のオペレーションがすでに進行中のときに、オペレーションを開始しようとすると発生します。 Managed Lustre では、インスタンスごとに一度に 1 つのアクティブな更新が許可され、追加の更新オペレーションをキューに登録できます。

この問題を解決するには、現在のオペレーションが完了してから新しいオペレーションを開始してください。

インスタンスの削除

インスタンスを削除するには:

Google Cloud コンソール

  1. コンソールで、[Managed Lustre] ページに移動します。 Google Cloud

    Managed Lustre に移動

  2. 削除するインスタンスの横にあるその他メニューを選択します。

  3. [インスタンスを削除] を選択します。もう一度 [削除] をクリックして削除を確定します。

gcloud CLI

gcloud lustre instances delete コマンドを使用します。

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

削除を確認するよう求められます。Y と入力するか、Enter キーを押して続行します。

REST

REST API を使用してインスタンスを削除するには、次のエンドポイントにリクエストを送信します。

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

次の値を指定する必要があります。

  • PROJECT_ID は Google Cloud プロジェクト ID です。

  • ZONE は、インスタンスが存在する Google Cloud ゾーンです。

  • INSTANCE_NAME は、削除する Managed Lustre インスタンスの名前です。

詳細については、instances.delete API リファレンスをご覧ください。

削除リクエストは長時間実行されるリクエストであり、オペレーション ステータスを照会できるオペレーション ID を返します。詳細については、 operations.get リファレンスをご覧ください。