创建 Managed Lustre 实例

Google Cloud Managed Lustre 实例是云端完整的 Lustre 文件系统。它可以挂载到 Compute Engine 虚拟机或 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 1000 MBps 的性能层级。
  • 位置。为获得最佳性能，请将实例放置在与客户端虚拟机或 GKE 集群相同的可用区中。
  • 此实例的 VPC 网络。这必须与虚拟机或集群使用的网络相同。
  • 是否将从 Kubernetes Engine (GKE) 集群访问此实例。 由于 Lustre 和 GKE 默认都使用端口 988，因此此设置会更改 Lustre 端口以避免冲突。

性能层级和最大存储容量

Managed Lustre 提供 4 个性能层级，每个层级具有不同的每 TiB 最大吞吐速度。性能层级还会影响最小和最大实例大小，以及可接受的容量值之间的步长。

层级 最小容量 最大容量 步长
每 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 1000 MBps 9,000 GiB 1,530,000 GiB (1.46 PiB) 9,000 GiB

实例创建后，您便无法更改其实例性能层级。

所需权限

如需创建新的 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 是实例的最大吞吐量，以 MBps/TiB 为单位。有效值为 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 是项目 ID。 Google Cloud

可选标志如下：

  • --kms-key-name 用于指定客户管理的加密密钥，以加密此实例。如需了解详情，请参阅 Managed Lustre 的客户管理的加密密钥 。

  • --gke-support-enabled 用于创建可供 Google Kubernetes Engine 集群使用的实例。它会将 Lustre LNet accept_port 设置为 6988。

    如需在指定 --gke-support-enabled 时从 Compute Engine 虚拟机进行连接，您必须更新虚拟机上的 LNet 配置文件。请参阅 为 gke-support-enabled 实例配置 LNet。

  • --async（可选）以异步方式运行命令。Google Cloud CLI 不会等待实例创建完成，而是会返回一个操作 ID，您可以使用该 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 必须是 Google Cloud Managed Lustre 支持的有效可用区。如需查看完整列表，请参阅 支持的位置。

  • INSTANCE_ID 是此 Managed Lustre 实例的名称。它必须满足以下条件：

    • 仅包含小写字母、数字和连字符。
    • 以字母开头。
    • 介于 1 到 63 个字符之间。
    • 以数字或字母结尾。
    • 在项目和位置内是唯一的。

  • filesystem 是要分配给此 Lustre 文件系统的名称。此名称由客户端命令（包括 mount 和 lfs）使用。其长度必须不超过 8 个字符，只能包含字母和/或数字，并且区分大小写。

    建议选择在 VPC 中的所有 Managed Lustre 实例中唯一的文件系统名称。这样，便可以从单个 GKE 节点使用多个实例。

  • perUnitStorageThroughput 是实例的最大吞吐量，以 MBps/TiB 为单位。有效值为 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 虚拟机进行连接，您必须更新虚拟机上的 LNet 配置文件。请参阅 为 gke-support-enabled 实例配置 LNet。

该 API 支持实例的其他可选字段。如需查看完整列表 和说明，请参阅 Instance资源参考文档。

Google Cloud 控制台

  1. 前往Managed Lustre页面，在 Google Cloud 控制台中。

    前往 Managed Lustre

  2. 点击创建 。系统会显示创建实例 页面。

  3. 输入唯一的实例名称 ，还可以选择输入说明。实例名称由 Google Cloud 用于标识此实例。

  4. 输入文件系统 名称。此名称由客户端工具（例如 lfs）使用。其长度必须不超过 8 个字符，只能包含字母和/或数字，并且区分大小写。

  5. 选择要在其中创建此实例的区域和可用区。您应将实例放置在与将连接到该实例的 Compute Engine 虚拟机或 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。

    如需在指定启用 GKE 支持 时从 Compute Engine 虚拟机进行连接，您必须更新虚拟机上的 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. 前往Managed Lustre页面，在 Google Cloud 控制台中。

    前往 Managed Lustre

  2. 在列表中点击实例名称。系统会显示实例详情 页面，其中包含实例创建请求的当前状态。

后续步骤