Crea una instancia de Managed Lustre

Una instancia de Google Cloud Managed Lustre es un sistema de archivos Lustre completo en la nube. Se puede activar en una VM de Compute Engine o en un clúster de Kubernetes Engine. Accedes a los datos de la instancia con la terminología estándar de POSIX.

Cuando creas una instancia de Lustre administrada, debes definir las siguientes propiedades:

  • Nombre de la instancia, que usa Google Cloud.
  • Nombre del sistema de archivos, que usan herramientas del cliente, como lfs.
  • Es la capacidad de almacenamiento en gibibytes (GiB). La capacidad puede variar de 9,000 GiB a 12,240,000 GiB (11.67 PiB). El tamaño máximo de una instancia depende de su nivel de rendimiento.
  • Es el nivel de rendimiento. Managed Lustre ofrece niveles de rendimiento que van desde 125 MBps por TiB hasta 1,000 MBps por TiB.
  • Es la ubicación. Para obtener un mejor rendimiento, ubica tu instancia en la misma zona que tus VMs de cliente o tu clúster de GKE.
  • Es la red de VPC para esta instancia. Debe ser la misma red que se usa para tus VMs o clústeres.
  • Indica si se accederá a esta instancia desde un clúster de Kubernetes Engine (GKE). Dado que tanto Lustre como GKE usan el puerto 988 de forma predeterminada, este parámetro de configuración cambia el puerto de Lustre para evitar conflictos.

Niveles de rendimiento y capacidades máximas de almacenamiento

Managed Lustre ofrece 4 niveles de rendimiento, cada uno con una velocidad de capacidad de procesamiento máxima diferente por TiB. Los niveles de rendimiento también afectan el tamaño mínimo y máximo de la instancia, y el tamaño del paso entre los valores de capacidad aceptables.

Nivel Capacidad mínima Capacidad máxima Tamaño del paso
125 MBps por TiB 72,000 GiB 12,240,000 GiB (11.67 PiB) 72,000 GiB
250 MBps por TiB 36,000 GiB 6,120,000 GiB (5.84 PiB) 36,000 GiB
500 MBps por TiB 18,000 GiB 3,060,000 GiB (2.92 PiB) 18,000 GiB
1,000 MBps por TiB 9,000 GiB 1,530,000 GiB (1.46 PiB) 9,000 GiB

No puedes cambiar el nivel de rendimiento de una instancia después de que se haya creado.

Permisos necesarios

Para crear una instancia nueva de Managed Lustre, debes tener permisos de IAM de administrador de Managed Lustre (roles/lustre.admin) para tu proyecto.

Consulta Control de acceso con IAM para obtener más detalles.

También debes habilitar la API de Managed Lustre.

Crea una instancia

Puedes crear una instancia nueva de Managed Lustre desde las siguientes interfaces.

gcloud

Para crear una instancia nueva de Lustre administrado, usa el comando 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

Se deben especificar los siguientes valores:

  • INSTANCE_ID es el nombre de esta instancia de Managed Lustre. Debe:

    • Contener solo letras minúsculas, números y guiones
    • Comienza con una letra.
    • Debe tener entre 1 y 63 caracteres.
    • Debe terminar con un número o una letra.
    • Ser único dentro del proyecto y la ubicación

  • --per-unit-storage-throughput es la capacidad de procesamiento máxima de la instancia en MBps por TiB. Los valores válidos son 125, 250, 500 y 1000. La capacidad de procesamiento que elijas afectará la capacidad de almacenamiento mínima y máxima de la instancia.

  • --capacity-gib es la capacidad de almacenamiento de la instancia en gibibytes (GiB). Los valores permitidos dependen del nivel de capacidad de procesamiento de almacenamiento que especifiques. Consulta la sección Niveles de rendimiento y capacidades de almacenamiento máximas para obtener más detalles.

  • --filesystem es el nombre que se asignará a este sistema de archivos Lustre. Los comandos del cliente, incluidos mount y lfs, usan este nombre. Debe tener 8 caracteres o menos, solo puede contener letras o números, y distingue entre mayúsculas y minúsculas.

    Se recomienda elegir un nombre que sea único en todas las instancias de Managed Lustre de la VPC. Esto permite que se usen varias instancias desde un solo nodo de GKE.

  • --location debe ser una Google Cloud zona válida compatible con Lustre administrado. Consulta Ubicaciones admitidas para obtener una lista completa.

  • --network es la ruta de acceso completa de la red de VPC a la que pertenece la instancia, en el formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configura una red de VPC.

  • --project es el ID de tu proyecto de Google Cloud .

Las marcas opcionales son las siguientes:

  • --kms-key-name especifica una clave de encriptación administrada por el cliente con la que se encriptará esta instancia. Consulta Claves de encriptación administradas por el cliente para Lustre administrado para obtener más detalles.

  • --gke-support-enabled crea una instancia que pueden usar los clústeres de Google Kubernetes Engine. Establece el accept_port de LNet de Lustre en 6988.

    Para conectarte desde una VM de Compute Engine cuando se especifica --gke-support-enabled, debes actualizar el archivo de configuración de LNet en la VM. Consulta Configura LNet para instancias de gke-support-enabled.

  • --async (opcional) ejecuta el comando de forma asíncrona. En lugar de esperar a que se complete la creación de la instancia, Google Cloud CLI devuelve un ID de operación que se puede usar para consultar el estado del comando.

Una solicitud correcta devuelve un ID de operación:

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

La creación de instancias demora aproximadamente 15 minutos para una instancia con una capacidad de 9,000 GiB y hasta una hora para una instancia con una capacidad de 12,240,000 GiB (11.67 PiB). Consulta Cómo consultar el estado de creación de la instancia para obtener instrucciones sobre cómo verificar el estado de tu solicitud.

REST

Para crear una instancia con la API de REST, envía una solicitud al siguiente extremo:

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
}

Se deben especificar los siguientes valores:

  • PROJECT_ID es el ID de tu proyecto de Google Cloud .

  • ZONE debe ser una Google Cloud zona válida compatible con Lustre administrado. Consulta Ubicaciones admitidas para obtener una lista completa.

  • INSTANCE_ID es el nombre de esta instancia de Lustre administrada. Debe:

    • Contener solo letras minúsculas, números y guiones
    • Comienza con una letra.
    • Debe tener entre 1 y 63 caracteres.
    • Debe terminar con un número o una letra.
    • Ser único dentro del proyecto y la ubicación

  • filesystem es el nombre que se asignará a este sistema de archivos Lustre. Los comandos del cliente, incluidos mount y lfs, usan este nombre. Debe tener 8 caracteres o menos, solo puede contener letras o números, y distingue entre mayúsculas y minúsculas.

    Se recomienda elegir un nombre de sistema de archivos que sea único en todas las instancias de Managed Lustre de la VPC. Esto permite que se usen varias instancias desde un solo nodo de GKE.

  • perUnitStorageThroughput es la capacidad de procesamiento máxima de la instancia en MBps por TiB. Los valores válidos son 125, 250, 500 y 1000. La capacidad de procesamiento que elijas afectará la capacidad de almacenamiento mínima y máxima de la instancia.

  • capacityGib es la capacidad de almacenamiento de la instancia en gibibytes (GiB). Los valores permitidos dependen del nivel de capacidad de procesamiento de almacenamiento que especifiques. Consulta la sección Niveles de rendimiento y capacidades de almacenamiento máximas para obtener más detalles.

  • network es la ruta de acceso completa de la red de VPC a la que pertenece la instancia, en el formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configura una red de VPC.

Los campos siguientes son opcionales:

La API admite campos opcionales adicionales para las instancias. Consulta la documentación de referencia del recurso Instance para obtener una lista completa y descripciones.

Consola de Google Cloud

  1. Ve a la página Lustre administrado en la consola de Google Cloud .

    Ir a Managed Lustre

  2. Haz clic en Crear. Se muestra la página Crear una instancia.

  3. Ingresa un Nombre de instancia único y, de forma opcional, una descripción. Google Cloud usa el nombre de la instancia para identificarla.

  4. Ingresa un nombre de sistema de archivos. Este es el nombre que usan las herramientas del cliente, como lfs. Debe tener 8 caracteres o menos, solo puede contener letras o números, y distingue entre mayúsculas y minúsculas.

  5. Selecciona una región y una zona en las que crearás esta instancia. Debes colocar tu instancia en la misma región y zona que las VMs de Compute Engine o los clústeres de Google Kubernetes Engine que se conectarán a ella.

  6. Selecciona el nivel de rendimiento para esta instancia.

  7. Especifica la capacidad de almacenamiento de tu instancia en gibibytes (GiB). Los valores válidos dependen del nivel de capacidad de procesamiento de almacenamiento que selecciones. Consulta la sección Niveles de rendimiento y capacidades de almacenamiento máximas para obtener más detalles.

  8. En la sección Encriptación, selecciona Clave de encriptación administrada por Google o Clave de Cloud Key Management Service. Para obtener información sobre la opción de clave de Cloud Key Management Service, consulta Claves de encriptación administradas por el cliente para Lustre administrado.

  9. Si te conectarás a esta instancia desde un clúster de GKE, selecciona Habilitar la compatibilidad con GKE. Esta opción establece el accept_port de Lustre LNet en 6988.

    Para conectarte desde una VM de Compute Engine cuando se especifica Habilitar la compatibilidad con GKE, debes actualizar el archivo de configuración de LNet en la VM. Consulta Configura LNet para instancias de gke-support-enabled.

  10. Selecciona la red que creaste en Crea una red de VPC.

La sección Resumen de la página se actualiza para mostrar una estimación del costo según tus selecciones.

Haz clic en Enviar para continuar. El proceso de creación de la instancia tarda entre 15 minutos y una hora, según la capacidad de la instancia.

Consulta el estado de creación de la instancia

Puedes consultar el estado de una solicitud de creación desde las siguientes interfaces.

gcloud

Para consultar el estado de una operación de creación, puedes obtener la operación o la instancia.

Para obtener la instancia, haz lo siguiente:

gcloud lustre instances describe INSTANCE_NAME \
  --location=ZONE

El estado de creación es el valor de state.

Para obtener la operación, usa el ID de operación de la respuesta de creación de la instancia. El ID de operación tiene el siguiente formato:

  • operation-1234567890123-6127783ad26ea-88913969-02748053
gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

El estado de creación es el valor de done.

Cuando se crea la instancia, el resultado de una solicitud get en la instancia es similar a la siguiente respuesta.

Ten en cuenta la dirección IP en el campo mountPoint y el nombre de tu sistema de archivos. Necesitarás estos valores cuando montes tu instancia.

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

Para consultar el estado de una operación de creación, usa el ID de operación de la respuesta. El ID de operación tiene el siguiente formato:

  • operation-1234567890123-6127783ad26ea-88913969-02748053

Envía una solicitud al siguiente extremo:

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

Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de operación.

Consola de Google Cloud

  1. Ve a la página Lustre administrado en la consola de Google Cloud .

    Ir a Managed Lustre

  2. Haz clic en el nombre de la instancia en la lista. Aparecerá la página Detalles de la instancia, que incluye el estado actual de tu solicitud de creación de instancias.

¿Qué sigue?