Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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 までのパフォーマンスティアが用意されています。また、データアクセスパターンに基づいてパフォーマンスを最適化する Dynamic ティアもあり、TiB あたりの合計スループットは 25 MBps です。
場所。パフォーマンスを最大限に高めるには、クライアント VM または GKE クラスタと同じゾーンにインスタンスを配置します。
このインスタンスの VPC ネットワーク。これは、VM またはクラスタで使用されているネットワークと同じである必要があります。

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

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

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

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

容量計算ツール

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

割り当て

プロジェクトには、インスタンスの作成時に消費されるスループットと容量の割り当てがあります。選択したインスタンスサイズとパフォーマンスティアに対して、インスタンスのゾーンと VPC ネットワークに十分な割り当てがない場合、作成リクエストは失敗します。詳細については、割り当てと上限をご覧ください。

必要な権限

新しい 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 インスタンスで一意の名前を選択することをおすすめします。これにより、1 つの GKE ノードから複数のインスタンスを使用できます。
--location は、Managed Lustre でサポートされている有効な Google Cloud ゾーンにする必要があります。完全なリストについては、サポートされているロケーションをご覧ください。
--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 の顧客管理の暗号鍵をご覧ください。
--maintenance-policy-weekly-windows と --maintenance-policy-exclusion-window は、このインスタンスのメンテナンスポリシーを定義します。詳細については、メンテナンスイベントとポリシーをご覧ください。
--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
}

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

PROJECT_ID は Google Cloud プロジェクト ID です。
ZONE は、Managed Lustre でサポートされている有効な Google Cloud ゾーンにする必要があります。完全なリストについては、サポートされているロケーションをご覧ください。
INSTANCE_ID は、この Managed Lustre インスタンスの名前です。それには次の条件を満たす必要があります。
- 英小文字、数字、ハイフンのみを使用する。
- 先頭には英字を使用してください。
- 1 ～ 63 文字である。
- 末尾は数字または英字にしてください。
- プロジェクトとロケーション内で一意である。
filesystem は、この Lustre ファイルシステムに割り当てる名前です。この名前は、mount や lfs などのクライアントサイドコマンドで使用されます。長さは 8 文字以下で、英字または数字のみを使用できます。大文字と小文字は区別されます。

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

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

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

dynamicTierOptions は、このインスタンスのダイナミックティアを有効にします。Dynamic ティアを有効にするには、dynamicTierOptions オブジェクト内の mode フィールドを DEFAULT_CACHE に設定し、perUnitStorageThroughput を 0 に設定する必要があります。
kmsKey は、このインスタンスの暗号化に使用する顧客管理の暗号鍵を指定します。詳細については、Managed Lustre の顧客管理の暗号鍵をご覧ください。

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

Google Cloud コンソール

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

[Managed Lustre] に移動
[作成] をクリックします。[インスタンスの作成] ページが表示されます。
一意のインスタンス名を入力します。必要に応じて説明も入力します。インスタンス名は、 Google Cloud がこのインスタンスを識別するために使用します。
[ファイルシステム] 名を入力します。これは、lfs などのクライアントサイドツールで使用される名前です。長さは 8 文字以下で、英字または数字のみを使用できます。大文字と小文字は区別されます。
このインスタンスを作成するリージョンとゾーンを選択します。インスタンスは、接続する Compute Engine VM または Google Kubernetes Engine クラスタと同じリージョンとゾーンに配置する必要があります。
このインスタンスのパフォーマンス階層を選択します。
インスタンスのストレージ容量をギビバイト（GiB）単位で指定します。有効な値は、選択したストレージスループットティアによって異なります。詳細については、パフォーマンスティアと最大ストレージ容量をご覧ください。
[暗号化] セクションで、[Google が管理する暗号鍵] または [Cloud Key Management Service 鍵] を選択します。Cloud Key Management Service 鍵オプションの詳細については、Managed Lustre の顧客管理の暗号鍵をご覧ください。
省略可: このインスタンスでメンテナンスを実行できるタイミングを制御するには、[メンテナンスポリシー] セクションを開き、メンテナンスの時間枠または除外の時間枠を構成します。詳細については、メンテナンスイベントとポリシーをご覧ください。
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 コンソール

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

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

トラブルシューティング

IP アドレス範囲が枯渇している

IP アドレス範囲の枯渇エラーでインスタンスの作成が失敗した場合:

FAILED_PRECONDITION: Invalid resource state for "NETWORK_RANGES_NOT_AVAILABLE": IP address range exhausted

または

Private Service Access IP address range exhausted or does not exist.

プライベートサービスアクセスを構成するの手順に沿って、既存のプライベート接続を変更して IP アドレス範囲を追加します。

プレフィックス長は /20（4,096 アドレス）以上にすることをおすすめします。

ネットワークがピアリングされていない

ネットワークピアリングエラーでインスタンスの作成が失敗した場合:

INVALID_ARGUMENT: the network has not been peered with Google managed services.

このエラーは、--network で指定された VPC ネットワークが、プライベートサービスアクセスを使用して Google マネージドサービスとピアリングされていない場合に発生します。

この問題を解決するには、VPC を作成して構成するの手順に沿って IP アドレス範囲を割り振り、VPC ピアリング接続を確立します。

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

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

容量計算ツール

割り当て

必要な権限

インスタンスの作成

gcloud

REST

Google Cloud コンソール

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

gcloud

REST

Google Cloud コンソール

トラブルシューティング

IP アドレス範囲が枯渇している

ネットワークがピアリングされていない

次のステップ

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

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