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

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

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

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

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

容量計算ツール

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

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

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

デフォルトのストレージ容量割り当ては、ゾーンごとの 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)です。有効な値は 01252505001000 です。スループットの選択は、インスタンスの最小ストレージ容量と最大ストレージ容量に影響します。

    動的階層を指定するには、これを 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 ファイル システムに割り当てる名前です。この名前は、mountlfs などのクライアントサイド コマンドで使用されます。8 文字以下で、文字または数字のみを使用できます。大文字と小文字は区別されます。

    VPC 内のすべての Managed Lustre インスタンスで一意の名前を選択することをおすすめします。これにより、単一の 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 の顧客管理の暗号鍵をご覧ください。

  • --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 ファイル システムに割り当てる名前です。この名前は、mountlfs などのクライアントサイド コマンドで使用されます。8 文字以下で、文字または数字のみを使用できます。大文字と小文字は区別されます。

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

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

    動的階層を指定するには、これを 0 に設定し、dynamicTierOptions オブジェクトを含めます。次に例を示します。

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

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

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

  • dynamicTierOptions を使用すると、このインスタンスの動的階層が有効になります。dynamicTierOptions オブジェクト内の mode フィールドを DEFAULT_CACHE に設定し、perUnitStorageThroughput0 に設定して、動的階層を有効にする必要があります。

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

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

次のステップ