Managed Lustre インスタンスを作成する

Google Cloud Managed Lustre インスタンスは、クラウド内の完全な Lustre ファイル システムです。Compute Engine VM または Kubernetes Engine クラスタにマウントできます。標準の POSIX 用語を使用して、インスタンスのデータにアクセスします。

Managed Lustre インスタンスを作成するときは、次のプロパティを定義する必要があります。

• Google Cloudで使用されるインスタンスの名前。
• クライアントサイド ツール（lfs など）で使用されるファイル システム名。
• ストレージ容量（ギビバイト（GiB）単位）。容量は 9,000 GiB ～ 12,240,000 GiB（11.67 PiB）の範囲で指定できます。インスタンスの最大サイズは、パフォーマンス ティアによって異なります。
• パフォーマンス階層。Managed Lustre には、TiB あたり 125 MBps から TiB あたり 1,000 MBps までのパフォーマンス ティアが用意されています。
• 場所。パフォーマンスを最大限に高めるには、クライアント VM または GKE クラスタと同じゾーンにインスタンスを配置します。
• このインスタンスの VPC ネットワーク。これは、VM またはクラスタで使用されているネットワークと同じである必要があります。
• このインスタンスに Kubernetes Engine（GKE）クラスタからアクセスするかどうか。Lustre と GKE はどちらもデフォルトでポート 988 を使用するため、この設定により Lustre ポートが変更され、競合が回避されます。

パフォーマンス ティアと最大ストレージ容量

Managed Lustre には 4 つのパフォーマンス ティアがあり、それぞれ TiB あたりの最大スループット速度が異なります。パフォーマンス ティアは、インスタンスの最小サイズと最大サイズ、許容可能な容量値間のステップサイズにも影響します。

階層	最小容量	最大容量	ステップサイズ
1 TiB あたり 125 MBps	72,000 GiB	12,240,000 GiB（11.67 PiB）	72,000 GiB
TiB あたり 250 MBps	36,000 GiB	6,120,000 GiB（5.84 PiB）	36,000 GiB
TiB あたり 500 MBps	18,000 GiB	3,060,000 GiB（2.92 PiB）	18,000 GiB
TiB あたり 1,000 MBps	9,000 GiB	1,530,000 GiB（1.46 PiB）	9,000 GiB

インスタンスの作成後にパフォーマンス ティアを変更することはできません。

重要: 利用可能なストレージ容量の割り当ては、インスタンスのロケーションやリクエストされたパフォーマンス ティアなど、多くの要因によって異なります。プロジェクトとロケーションで使用可能な割り当てがある場合、デフォルトで TiB あたり 500 MBps のパフォーマンス ティアに適用されます。プロジェクトで使用可能な割り当てがない場合や、割り当てが不足している場合、または TiB あたり 125 MBps、TiB あたり 250 MBps、TiB あたり 1,000 MBps のティアを使用する場合は、追加の割り当てをリクエストする必要があります。

必要な権限

新しい Managed Lustre インスタンスを作成するには、プロジェクトに対する Managed Lustre 管理者（roles/lustre.admin）IAM 権限が必要です。

詳しくは、IAM によるアクセス制御をご覧ください。

また、Managed Lustre API を有効にする必要があります。

インスタンスの作成

次のインターフェースから新しい Managed Lustre インスタンスを作成できます。

gcloud

新しい Managed Lustre インスタンスを作成するには、gcloud lustre instances create コマンドを使用します。

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FILESYSTEM \
  --location=LOCATION \
  --network=NETWORK_PATH

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

• INSTANCE_ID は、この Managed Lustre インスタンスの名前です。次の条件を満たす必要があります。

  • 小文字、数字、ハイフンのみを使用する。
  • 先頭には英字を使用してください。
  • 1 ～ 63 文字にする必要があります。
  • 末尾は数字または英字にしてください。
  • プロジェクトとロケーション内で一意であること。

• --per-unit-storage-throughput は、インスタンスの最大スループット（TiB あたりの MBps）です。有効な値は 125、250、500、1000 です。選択したスループットは、インスタンスの最小ストレージ容量と最大ストレージ容量に影響します。

• --capacity-gib は、インスタンスのストレージ容量（ギビバイト（GiB）単位）です。使用できる値は、指定したストレージ スループット ティアによって異なります。詳細については、パフォーマンス ティアと最大ストレージ容量をご覧ください。

• --filesystem は、この Lustre ファイル システムに割り当てる名前です。この名前は、mount や lfs などのクライアントサイド コマンドで使用されます。8 文字以下で、文字と数字のみを使用でき、大文字と小文字が区別されます。

  VPC 内のすべての Managed Lustre インスタンスで一意の名前を選択することをおすすめします。これにより、単一の GKE ノードから複数のインスタンスを使用できます。

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

• --network は、インスタンスが属する VPC ネットワークの完全パス（projects/PROJECT_ID/global/networks/NETWORK 形式）です。VPC ネットワークを構成するをご覧ください。

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

省略可能なフラグは次のとおりです。

• --kms-key-name は、このインスタンスの暗号化に使用する顧客管理の暗号鍵を指定します。詳細については、Managed Lustre の顧客管理の暗号鍵をご覧ください。

• --gke-support-enabled は、Google Kubernetes Engine クラスタで使用できるインスタンスを作成します。Lustre LNet accept_port を 6988 に設定します。

  --gke-support-enabled が指定されているときに Compute Engine VM から接続するには、VM の LNet 構成ファイルを更新する必要があります。gke-support-enabled インスタンスの LNet を構成するをご覧ください。

• --async（省略可）は、コマンドを非同期で実行します。インスタンスの作成が完了するのを待つ代わりに、Google Cloud CLI はコマンドのステータスのクエリに使用できるオペレーション ID を返します。

リクエストが成功すると、オペレーション ID が返されます。

Create request issued for: [$INSTANCE_ID]
Waiting for operation [projects/$PROJECT_ID/locations/us-central1-a/operations/
operation-1234567890-609d21deae6f0-befaf0bc-867b1aa1] to complete...

インスタンスの作成には、容量が 9,000 GiB のインスタンスで約 15 分、容量が 12,240,000 GiB（11.67 PiB）のインスタンスで最大 1 時間かかります。リクエストのステータスを確認する手順については、インスタンス作成ステータスをクエリするをご覧ください。

REST

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

POST https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances?instanceId=INSTANCE_ID
Authorization: Bearer AUTH_TOKEN
{
  "filesystem": string,
  "perUnitStorageThroughput": int64,
  "capacityGib": int64,
  "network": string,
  "gkeSupportEnabled": boolean
}

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

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

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

• INSTANCE_ID は、このマネージド Lustre インスタンスの名前です。次の条件を満たす必要があります。

  • 小文字、数字、ハイフンのみを使用する。
  • 先頭には英字を使用してください。
  • 1 ～ 63 文字にする必要があります。
  • 末尾は数字または英字にしてください。
  • プロジェクトとロケーション内で一意であること。

• filesystem は、この Lustre ファイル システムに割り当てる名前です。この名前は、mount や lfs などのクライアントサイド コマンドで使用されます。8 文字以下で、文字と数字のみを使用でき、大文字と小文字が区別されます。

  VPC 内のすべての Managed Lustre インスタンスで一意のファイル システム名を選択することをおすすめします。これにより、単一の GKE ノードから複数のインスタンスを使用できます。

• perUnitStorageThroughput は、インスタンスの最大スループット（TiB あたりの MBps）です。有効な値は 125、250、500、1000 です。選択したスループットは、インスタンスの最小ストレージ容量と最大ストレージ容量に影響します。

• capacityGib は、インスタンスのストレージ容量（ギビバイト（GiB）単位）です。使用できる値は、指定したストレージ スループット ティアによって異なります。詳細については、パフォーマンス ティアと最大ストレージ容量をご覧ください。

• network は、インスタンスが属する VPC ネットワークの完全パスです（projects/PROJECT_ID/global/networks/NETWORK 形式）。VPC ネットワークを構成するをご覧ください。

次のフィールドは省略可能です。

• kmsKey は、このインスタンスの暗号化に使用する顧客管理の暗号鍵を指定します。詳細については、Managed Lustre の顧客管理の暗号鍵をご覧ください。

• gkeSupportEnabled は、このインスタンスが Google Kubernetes Engine クラスタで使用される可能性があることを指定します。Lustre LNet accept_port を 6988 に設定します。

  gkeSupportEnabled が指定されているときに Compute Engine VM から接続するには、VM の LNet 構成ファイルを更新する必要があります。gke-support-enabled インスタンスの LNet を構成するをご覧ください。

API は、インスタンスの追加のオプション フィールドをサポートしています。完全なリストと説明については、Instance リソースのリファレンス ドキュメントをご覧ください。

Google Cloud コンソール

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

   Managed Lustre に移動

2. [作成] をクリックします。[インスタンスの作成] ページが表示されます。

3. 一意のインスタンス名を入力します。必要に応じて説明も入力します。インスタンス名は、 Google Cloud がこのインスタンスを識別するために使用します。

4. ファイル システム名を入力します。これは、lfs などのクライアントサイド ツールで使用される名前です。8 文字以下で、文字と数字のみを使用でき、大文字と小文字が区別されます。

5. このインスタンスを作成するリージョンとゾーンを選択します。インスタンスは、接続先の Compute Engine VM または Google Kubernetes Engine クラスタと同じリージョンとゾーンに配置する必要があります。

6. このインスタンスのパフォーマンス階層を選択します。

7. インスタンスのストレージ容量をギビバイト（GiB）単位で指定します。有効な値は、選択したストレージ スループット ティアによって異なります。詳細については、パフォーマンス ティアと最大ストレージ容量をご覧ください。

8. [暗号化] セクションで、[Google が管理する暗号鍵] または [Cloud Key Management Service 鍵] を選択します。Cloud Key Management Service 鍵オプションについては、Managed Lustre の顧客管理の暗号鍵をご覧ください。

9. GKE クラスタからこのインスタンスに接続する場合は、[GKE サポートを有効にする] を選択します。このオプションは、Lustre LNet accept_port を 6988 に設定します。

   [Enable GKE support] が指定されている場合に Compute Engine VM から接続するには、VM の LNet 構成ファイルを更新する必要があります。gke-support-enabled インスタンスの LNet を構成するをご覧ください。

10. VPC ネットワークを作成するで作成したネットワークを選択します。

ページの [概要] セクションが更新され、選択した内容に基づいて費用の見積もりが表示されます。

[送信] をクリックして続行します。インスタンスの作成プロセスには、インスタンスの容量に応じて 15 分から 1 時間かかります。

インスタンス作成ステータスをクエリする

次のインターフェースから作成リクエストのステータスをクエリできます。

gcloud

作成オペレーションのステータスをクエリするには、オペレーションまたはインスタンスを取得します。

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

gcloud lustre instances describe INSTANCE_NAME \
  --location=ZONE

作成ステータスは state の値です。

オペレーションを取得するには、インスタンス作成レスポンスのオペレーション ID を使用します。オペレーション ID の形式は次のとおりです。

• operation-1234567890123-6127783ad26ea-88913969-02748053

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

作成ステータスは done の値です。

インスタンスが作成されると、インスタンスに対する GET リクエストの結果は次のレスポンスのようになります。

mountPoint フィールドの IP アドレスとファイル システム名をメモします。これらの値は、インスタンスをマウントするときに必要になります。

capacityGib: '27000'
createTime: '2025-03-14T00:07:34.308574307Z'
filesystem: lustre-fs
mountPoint: 10.115.0.3@tcp:/testfs
name: projects/$PROJECT/locations/us-central1-a/instances/$INSTANCE_NAME
network: projects/$PROJECT/global/networks/default
state: ACTIVE
updateTime: '2025-03-14T00:15:37.101024263Z'

REST

作成オペレーションのステータスをクエリするには、レスポンスのオペレーション ID を使用します。オペレーション ID の形式は次のとおりです。

• operation-1234567890123-6127783ad26ea-88913969-02748053

次のエンドポイントにリクエストを送信します。

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

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

Google Cloud コンソール

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

   Managed Lustre に移動

2. リスト内のインスタンス名をクリックします。[インスタンスの詳細] ページが表示され、インスタンス作成リクエストの現在のステータスが表示されます。

次のステップ

• Compute Engine クライアントから接続する
• Google Kubernetes Engine から接続する