Crea una instancia de Managed Lustre

Una instancia de Managed Lustre de Google Cloud 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 POSIX estándar.

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

  • El nombre de la instancia, que usa Google Cloud.
  • El nombre del sistema de archivos, que usan las herramientas del cliente, como lfs.
  • 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.
  • El nivel de rendimiento. Managed Lustre ofrece niveles de rendimiento que van desde 125 MBps por TiB hasta 1,000 MBps por TiB.
  • La ubicación. Para obtener un mejor rendimiento, ubica tu instancia en la misma zona que tus VMs cliente o el clúster de GKE.
  • La red de VPC para esta instancia. Debe ser la misma red que se usa para tus VMs o clústeres.
  • Si se accederá a esta instancia desde un clúster de Kubernetes Engine (GKE). Como Lustre y GKE usan el puerto 988 de forma predeterminada, esta 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 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 crearla.

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 haber habilitado 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 Managed Lustre, 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 cumplir con lo siguiente:

    • Contener solo letras minúsculas, números y guiones
    • Comenzar con una letra
    • Tener entre 1 y 63 caracteres
    • 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. Tu elección de capacidad de procesamiento afecta 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 máximas de almacenamiento para obtener más detalles.

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

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

  • --location debe ser una zona válida compatible con Managed Lustre. Google Cloud 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 pertenece, en el formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configura una red de VPC.

  • --project es el ID del Google Cloud proyecto.

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 Managed Lustre para obtener más detalles.

  • --gke-support-enabled crea una instancia que pueden usar los clústeres de Google Kubernetes Engine. Establece el LNet accept_port 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 gke-support-enabled instancias.

  • --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 muestra un ID de operación que se puede usar para consultar el estado del comando.

Una solicitud correcta muestra 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 tarda 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 Consulta 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 del Google Cloud proyecto.

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

  • INSTANCE_ID es el nombre de esta instancia de Managed Lustre. Debe cumplir con lo siguiente:

    • Contener solo letras minúsculas, números y guiones
    • Comenzar con una letra
    • Tener entre 1 y 63 caracteres
    • 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 usan este nombre, incluidos mount y lfs. Debe tener 8 caracteres o menos, solo puede contener letras o números, y distingue mayúsculas de 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 usar 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. Tu elección de capacidad de procesamiento afecta 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 máximas de almacenamiento 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 siguientes campos 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.

Google Cloud Consola de

  1. Ve a la página Managed Lustre en la Google Cloud Consola de.

    Ir a Managed Lustre

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

  3. Ingresa un Nombre de instancia único y, de forma opcional, una descripción. El nombre de la instancia lo usapara identificar esta instancia. Google Cloud

  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 mayúsculas de minúsculas.

  5. Selecciona una región y una zona en las que se creará 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 en gibibytes (GiB) de tu instancia. Los valores válidos dependen del nivel de capacidad de procesamiento de almacenamiento que selecciones. Consulta la sección Niveles de rendimiento y capacidades máximas de almacenamiento 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 Managed Lustre.

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

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

  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 de costos basada en tus selecciones.

Haz clic en Enviar para continuar. El proceso de creación de instancias 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 del sistema de archivos. Necesitarás estos valores cuando actives 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.

Google Cloud Consola de

  1. Ve a la página Managed Lustre en la Google Cloud Consola de.

    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?