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

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

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

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

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

Managed Lustre には、4 つの固定パフォーマンスティアと動的ティアが用意されています。パフォーマンスティアは、インスタンスの最小サイズと最大サイズ、許容可能な容量値間のステップサイズに影響します。インスタンスの作成後にパフォーマンスティアを変更することはできません。

詳細については、パフォーマンスティアをご覧ください。

インスタンスの作成後、パフォーマンスティアとステップサイズで許容される最大値まで、インスタンスのストレージ容量を増やすことができます。

容量計算ツール

パフォーマンスティアを選択し、目標容量を入力して、最も近い有効なサイズを見つけます。有効なサイズは、ティアの最小サイズとステップサイズに基づいて切り上げられます。

ストレージ容量の割り当て

使用可能なストレージ容量の割り当ては、インスタンスのロケーションやリクエストされたパフォーマンスティアなど、多くの要因によって異なります。

デフォルトのストレージ容量の割り当ては、ゾーンごとに Virtual Private Cloud（VPC）ネットワークごとにで、すべてのパフォーマンスティアで共有されます。1 つのティアで容量を使用すると、他のティアで使用可能なストレージ容量の割り当てが減少します。

詳細については、割り当てと上限をご覧ください。

必要な権限

新しい 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）です。有効な値は 0、125、250、500、1000 です。選択したスループットは、インスタンスの最小ストレージ容量と最大ストレージ容量に影響します。

動的ティアを指定するには、これを 0 に設定し、フラグを含めます。--dynamic-tier-options-mode=DEFAULT_CACHE次に例を示します。
```
gcloud lustre instances create my-dynamic-tier-instance \
  --per-unit-storage-throughput=0 \
  --dynamic-tier-options-mode=DEFAULT_CACHE \
  ...
```
--capacity-gib は、ギビバイト（GiB）単位のインスタンスのストレージ容量です。許容される値は、指定するストレージスループットティアによって異なります。詳細については、パフォーマンスティアと最大ストレージ容量をご覧ください。
--filesystem は、この Lustre ファイルシステムに割り当てる名前です。この名前は、mount や lfs などのクライアントサイドコマンドで使用されます。8 文字以下にする必要があります。文字または数字のみを含めることができ、大文字と小文字が区別されます。

VPC 内のすべての Managed Lustre インスタンスで一意の名前を選択することをおすすめします。これにより、単一の GKE ノードから複数のインスタンスを使用できます。
--location は、 Google Cloud Managed Lustre でサポートされている有効なゾーンである必要があります。完全なリストについては、サポートされているロケーションをご覧ください。
--network は、インスタンスが属する VPC ネットワークの完全パスです（projects/PROJECT_ID/global/networks/NETWORK 形式）。VPC ネットワークを構成するをご覧ください。
--project は Google Cloud プロジェクト ID です。

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

--dynamic-tier-options-mode は、このインスタンスの動的ティアを指定します。このフラグの値を DEFAULT_CACHE に設定し、--per-unit-storage-throughput=0 を設定して、動的ティアを有効にします。
--kms-key-name は、このインスタンスの暗号化に使用する顧客管理の暗号鍵を指定します。詳細については、 Managed Lustre の顧客管理の暗号鍵をご覧ください。
--gke-support-enabled は、Google Kubernetes Engine クラスタで使用できるインスタンスを作成します。Lustre LNet accept_port を 6988 に設定します。

--gke-support-enabled が指定されている場合に Compute Engine VM から接続するには、VM の LNet 構成ファイルを更新する必要があります。インスタンスの LNet を構成するをご覧ください。gke-support-enabled
--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 分、容量が 84,016,000 GiB（80.1 PiB）のインスタンスの場合は数時間かかります。リクエストのステータスを確認する手順については、インスタンス作成ステータスのクエリをご覧ください。

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 は、この Managed Lustre インスタンスの名前です。次の条件を満たす必要があります。
- 小文字、数字、ハイフンのみを含める。
- 先頭には英字を使用してください。
- 1 ～ 63 文字にする。
- 末尾は数字または文字にする。
- プロジェクトとロケーション内で一意にする。
filesystem は、この Lustre ファイルシステムに割り当てる名前です。この名前は、mount や lfs などのクライアントサイドコマンドで使用されます。8 文字以下にする必要があります。文字または数字のみを含めることができ、大文字と小文字が区別されます。

VPC 内のすべての Managed Lustre インスタンスで一意のファイルシステム名を選択することをおすすめします。これにより、単一の GKE ノードから複数のインスタンスを使用できます。
perUnitStorageThroughput は、インスタンスの最大スループット（TiB あたりの MBps）です。有効な値は 0、125、250、500、1000 です。選択したスループットは、インスタンスの最小ストレージ容量と最大ストレージ容量に影響します。

動的ティアを指定するには、これを 0 に設定し、 the dynamicTierOptions オブジェクトを含めます。次に例を示します。
```
"perUnitStorageThroughput": 0,
"dynamicTierOptions": {
  "mode": "DEFAULT_CACHE"
}
```
capacityGib は、ギビバイト（GiB）単位のインスタンスのストレージ容量です。許容される値は、指定するストレージスループットティアによって異なります。詳細については、パフォーマンスティアと最大ストレージ容量をご覧ください。
network は、インスタンスが属する VPC ネットワークの完全パスです（projects/PROJECT_ID/global/networks/NETWORK 形式）。VPC ネットワークを構成するをご覧ください。

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

dynamicTierOptions は、このインスタンスの動的ティアを有効にします。動的ティアを有効にするには、dynamicTierOptions オブジェクト内の mode フィールドを DEFAULT_CACHE に設定し、perUnitStorageThroughput を 0 にする必要があります。
kmsKey は、このインスタンスの暗号化に使用する顧客管理の暗号鍵を指定します。詳細については、 Managed Lustre の顧客管理の暗号鍵をご覧ください。
gkeSupportEnabled は、このインスタンスを Google Kubernetes Engine クラスタで使用できることを指定します。Lustre LNet accept_port を 6988 に設定します。

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

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

Google Cloud コンソール

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

Managed Lustre に移動
[作成] をクリックします。[インスタンスの作成] ページが表示されます。
一意のインスタンス名 を入力します。必要に応じて説明を入力します。インスタンス名は、このインスタンスを識別するために使用されます。 Google Cloud
[ファイルシステム] 名を入力します。これは、lfs などのクライアントサイドツールで使用される名前です。8 文字以下にする必要があります。文字または数字のみを含めることができ、大文字と小文字が区別されます。
このインスタンスを作成するリージョンとゾーンを選択します。インスタンスは、接続する Compute Engine VM または Google Kubernetes Engine クラスタと同じリージョンとゾーンに配置する必要があります。
このインスタンスのパフォーマンスティアを選択します。
インスタンスのストレージ容量をギビバイト（GiB）単位で指定します。有効な値は、選択したストレージスループットティアによって異なります。詳細については、パフォーマンスティアと最大ストレージ容量をご覧ください。
[暗号化] セクションで、[Google マネージド暗号鍵] または [Cloud Key Management Service 鍵] を選択します。Cloud Key Management Service 鍵オプションの詳細については、 Managed Lustre の顧客管理の暗号鍵をご覧ください。
GKE クラスタからこのインスタンスに接続する場合は、[GKE サポートを有効にする] を選択します。このオプションでは、Lustre LNet accept_port が 6988 に設定されます。

[GKE サポートを有効にする] が指定されている場合に Compute Engine VM から接続するには、VM の LNet 構成ファイルを更新する必要があります。インスタンスの LNet を構成するをご覧ください。gke-support-enabled
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 コンソール

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

Managed Lustre に移動
リストでインスタンス名をクリックします。[インスタンスの詳細] ページが表示されます。このページには、インスタンス作成リクエストの現在のステータスが表示されます。

Managed Lustre インスタンスを作成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

容量計算ツール

ストレージ容量の割り当て

必要な権限

インスタンスの作成

gcloud

REST

Google Cloud コンソール

インスタンス作成ステータスのクエリ

gcloud

REST

Google Cloud コンソール

次のステップ

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

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