Crea una instancia de Managed Lustre

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

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

  • Es el nombre de la instancia, que usa Google Cloud.
  • Es el nombre del sistema de archivos, que usan las herramientas del cliente, como lfs.
  • Es la capacidad de almacenamiento en gibibytes (GiB). La capacidad puede variar de 9,000 GiB a 84,016,000 GiB (80.1 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, así como un nivel dinámico que optimiza el rendimiento en función de los patrones de acceso a los datos, con una capacidad de procesamiento agregada de 25 MBps por TiB.
  • La ubicación Para obtener el 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.

Niveles de rendimiento y capacidades máximas de almacenamiento

Managed Lustre ofrece 4 niveles de rendimiento establecidos y un nivel dinámico. Los niveles de rendimiento afectan el tamaño mínimo y máximo de la instancia, y el tamaño del paso entre los valores de capacidad aceptables. No puedes cambiar el nivel de rendimiento de una instancia después de crearla.

Consulta los niveles de rendimiento para obtener más detalles.

Puedes aumentar la capacidad de almacenamiento de una instancia después de crearla, hasta el valor máximo permitido para su nivel de rendimiento y tamaño del paso.

Calculadora de capacidad

Selecciona un nivel de rendimiento y, luego, ingresa tu capacidad objetivo para encontrar el tamaño válido más cercano. Los tamaños válidos se redondean hacia arriba según el mínimo y el tamaño del paso del nivel.

Cuotas

Tu proyecto tiene cuotas de capacidad de procesamiento y capacidad que se consumen cuando creas una instancia. Si no tienes suficiente cuota en la zona de la instancia y la red de VPC para el tamaño de la instancia y el nivel de rendimiento que seleccionas, la solicitud de creación fallará. Para obtener más información, consulta Cuotas y límites.

Permisos necesarios

Para crear una instancia nueva de Managed Lustre, debes tener permisos de IAM de administrador de Managed Lustre (roles/lustre.admin) en 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. La misma debe:

    • Contener solo letras minúsculas, números y guiones
    • Comienza con una letra.
    • Tener entre 1 y 63 caracteres
    • Debe terminar con un número o una letra.
    • Debe ser único en el 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 0, 125, 250, 500 y 1000. La elección de la capacidad de procesamiento afecta la capacidad de almacenamiento mínima y máxima de la instancia.

    Para especificar el nivel dinámico, configúralo como 0 y, luego, incluye la marca --dynamic-tier-options-mode=DEFAULT_CACHE. Por ejemplo:

    gcloud lustre instances create my-dynamic-tier-instance \
  --per-unit-storage-throughput=0 \
  --dynamic-tier-options-mode=DEFAULT_CACHE \
  ...

  • --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 de 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 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 que se usen varias instancias desde un solo nodo de GKE.

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

  • --network es la ruta de acceso completa a 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 del proyecto de Google Cloud .

Las marcas opcionales son las siguientes:

  • --dynamic-tier-options-mode especifica el nivel dinámico para esta instancia. Establece el valor de esta marca en DEFAULT_CACHE y configura --per-unit-storage-throughput=0 para habilitar el nivel dinámico.

  • --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.

  • --maintenance-policy-weekly-windows y --maintenance-policy-exclusion-window definen las políticas de mantenimiento para esta instancia. Consulta Eventos y políticas de mantenimiento para obtener más detalles.

  • --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 una instancia tarda aproximadamente 15 minutos para una instancia con una capacidad de 9,000 GiB, hasta varias horas para una instancia con una capacidad de 84,016,000 GiB (80.1 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
}

Se deben especificar los siguientes valores:

  • PROJECT_ID es el ID del proyecto de Google Cloud .

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

  • INSTANCE_ID es el nombre de esta instancia de Managed Lustre. La misma debe:

    • Contener solo letras minúsculas, números y guiones
    • Comienza con una letra.
    • Tener entre 1 y 63 caracteres
    • Debe terminar con un número o una letra.
    • Debe ser único en el proyecto y la ubicación.

  • filesystem es el nombre que se asignará a este sistema de archivos de 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 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 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 0, 125, 250, 500 y 1000. La elección de la capacidad de procesamiento afecta la capacidad de almacenamiento mínima y máxima de la instancia.

    Para especificar el nivel dinámico, configúralo como 0 y, luego, incluye el objeto dynamicTierOptions. Por ejemplo:

    "perUnitStorageThroughput": 0,
"dynamicTierOptions": {
  "mode": "DEFAULT_CACHE"
}

  • 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:

  • dynamicTierOptions habilita el nivel dinámico para esta instancia. El campo mode dentro del objeto dynamicTierOptions debe establecerse en DEFAULT_CACHE y perUnitStorageThroughput debe ser 0 para habilitar el nivel dinámico.

  • kmsKey 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.

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 mostrará la página Crea 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 para el 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 quieras 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 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 Managed Lustre.

  9. Opcional: Para controlar cuándo se puede realizar el mantenimiento en esta instancia, expande la sección Política de mantenimiento y configura un período de mantenimiento o un período de exclusión. Consulta Eventos y políticas de mantenimiento para obtener más detalles.

  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 en función de 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.

Anota la dirección IP en el campo mountPoint y el nombre del sistema de archivos. Necesitarás estos valores cuando actives la 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 instancia.

Soluciona problemas

Se agotó el rango de direcciones IP

Si la creación de la instancia falla con un error de rango de direcciones IP agotado, haz lo siguiente:

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

o:

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

Sigue las instrucciones que se indican en Configura el acceso privado a servicios para modificar la conexión privada existente y agregar rangos de direcciones IP.

Recomendamos una longitud de prefijo de, al menos, /20 (4,096 direcciones).

No se intercambió tráfico con la red

Si la creación de la instancia falla con un error de intercambio de tráfico entre redes, haz lo siguiente:

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

Este error se produce cuando la red de VPC especificada en --network no se intercambió con los servicios administrados por Google con el acceso privado a servicios.

Para resolver este problema, sigue las instrucciones que se indican en Crea y configura la VPC para asignar un rango de direcciones IP y establecer la conexión de intercambio de tráfico entre VPC.

¿Qué sigue?