Aumenta la capacidad de una instancia de Managed Lustre

Puedes aumentar la capacidad de almacenamiento de tu instancia de Managed Lustre. La capacidad no se puede disminuir.

Cuando aumentas la capacidad de una instancia, puedes seguir usándola mientras la operación de actualización está en curso.

Limitaciones para aumentar la capacidad

En el caso de los niveles de rendimiento con dos tamaños de paso diferentes, la capacidad actual de la instancia determina su tamaño máximo posible.

Si la capacidad de una instancia es igual o inferior al umbral del tamaño del paso, su tamaño se puede aumentar hasta el valor del umbral. No se puede expandir más allá de este límite.

Por ejemplo, en el nivel de 250 MBps por TiB, el umbral en el que cambia el tamaño del paso es de 10,224,000 GiB. Cualquier instancia creada con una capacidad igual o inferior a este umbral solo se puede expandir hasta ese límite de 10,224,000 GiB.

Calcula tu nueva capacidad

Puedes actualizar la capacidad de una instancia hasta el valor máximo permitido para su nivel de rendimiento y tamaño del paso. Estos valores son los siguientes:

Nivel de rendimiento Capacidad mínima Capacidad máxima Tamaño del paso
1,000 MBps por TiB 9,000 GiB 10,008,000 GiB (9.5 PiB) Para capacidades de almacenamiento de hasta 2,556,000 GiB: 9,000 GiB
Para capacidades de almacenamiento más grandes: 72,000 GiB
500 MBps por TiB 18,000 GiB 20,016,000 GiB (19.1 PiB) Para capacidades de almacenamiento de hasta 5,112,000 GiB: 18,000 GiB
Para capacidades de almacenamiento más grandes: 144,000 GiB
250 MBps por TiB 36,000 GiB 40,032,000 GiB (38.2 PiB) Para capacidades de almacenamiento de hasta 10,224,000 GiB: 36,000 GiB
Para capacidades de almacenamiento más grandes: 288,000 GiB
125 MBps por TiB 72,000 GiB 20,448,000 GiB (19.5 PiB) 72,000 GiB
Dinámico (25 MBps por TiB) 472,000 GiB 84,016,000 GiB (80.1 PiB) 472,000 GiB

La capacidad actualizada debe ser un múltiplo del tamaño del paso y no puede superar el máximo para ese tamaño del paso.

Tu proyecto de Google Cloud tiene cuotas de capacidad de procesamiento y capacidad que afectan la capacidad disponible por red de nube privada virtual (VPC) por zona. Es posible que debas solicitar una cuota de capacidad de procesamiento o capacidad adicional antes de aumentar la capacidad de tu instancia. Consulta Cuotas y límites para obtener más detalles.

Calculadora de capacidad

Usa la siguiente calculadora para encontrar una capacidad válida para el nivel de rendimiento que seleccionaste.

Actualiza la capacidad de la instancia

Puedes usar la consola de Google Cloud o Google Cloud CLI para actualizar la capacidad de la instancia.

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 que deseas actualizar. Se mostrará la página de resumen de la instancia.

  3. Haz clic en Editar.

  4. Ingresa el nuevo valor de capacidad de almacenamiento. El valor debe ser igual o menor que la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Calcula tu nueva capacidad para obtener estos valores.

  5. Haz clic en Enviar.

gcloud

Usa el comando gcloud lustre instances update para aumentar la capacidad de almacenamiento de tu instancia:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY

Aquí:

  • INSTANCE_NAME es la instancia que se actualizará.
  • LOCATION es la zona en la que reside la instancia.
  • NEW_CAPACITY es la nueva capacidad de almacenamiento de esta instancia en gibibytes (GiB). El valor no puede superar la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Calcula tu nueva capacidad para obtener estos valores.

REST

Para actualizar una instancia con la API de REST, envía una solicitud PATCH a su extremo específico:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=capacityGib
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": NEW_CAPACITY
}

Donde se deben especificar los siguientes valores:

  • PROJECT_ID es el ID del proyecto de Google Cloud .
  • ZONE es la zona de la Google Cloud instancia.
  • INSTANCE_NAME es el nombre de la instancia de Managed Lustre que deseas actualizar.
  • updateMask=capacityGib especifica el campo que se actualizará. Un campo solo se reemplazará si está en la máscara.
  • NEW_CAPACITY es la nueva capacidad de almacenamiento de esta instancia en gibibytes (GiB). El valor no puede superar la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Calcula tu nueva capacidad para obtener estos valores.

Consulta la referencia de la API de instances.patch para obtener más detalles.

Una vez que se envía la solicitud de actualización, Managed Lustre verifica tu cuota disponible. Si hay suficiente cuota, la capacidad de la instancia se aumenta durante un período, según el cambio de tamaño. Los aumentos pueden tardar entre 20 minutos y una hora o más.

Puedes seguir usando tu instancia durante la operación de actualización.

Cómo ver el estado de la actualización

Puedes ver el estado de una solicitud de actualización desde las siguientes interfaces.

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 actualización de la instancia.

gcloud

De forma predeterminada, el comando gcloud lustre instances update espera a que se complete antes de mostrar el símbolo del sistema:

Request issued for: [my-instance]
Waiting for operation [projects/my-project/locations/us-central1-a/operations/operation-1234567890-123] to complete...

Una vez que se complete, la línea de comandos mostrará Updated instance [my-instance] junto con los detalles de la instancia, incluida la capacidad actualizada.

Si ejecutaste el comando de actualización con la marca --async o, de lo contrario, necesitas consultar el estado de la actualización desde la línea de comandos, puedes recuperar los detalles de la operación para ver si la instancia terminó de actualizarse:

gcloud lustre operations describe OPERATION_ID \
  --location=ZONE

Mientras se actualiza la instancia, la respuesta muestra un valor done: false. Una vez que se complete, done se establecerá en true.

Por ejemplo:

$ gcloud lustre operations describe operation-1234567890-123abc456-789def012-a1b2c3d4 \
    --location=us-central1-a

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.lustre.v1.OperationMetadata
  apiVersion: v1
  createTime: '2025-08-27T18:13:49.771203623Z'
  requestedCancellation: false
  target: projects/my-project/locations/us-central1-a/instances/my-instance
  verb: update
name: projects/my-project/locations/us-central1-a/operations/operation-1234567890-123abc456-789def012-a1b2c3d4

REST

Para consultar el estado de una operación de actualizació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.

Rendimiento después de aumentar la capacidad

La capacidad de procesamiento máxima de una instancia de Managed Lustre se determina según su capacidad de almacenamiento y su nivel de rendimiento. Aumentar la capacidad de almacenamiento de una instancia existente también aumenta su capacidad de procesamiento máxima.

Es posible que el aumento del rendimiento no se vea hasta que se escriban datos nuevos. El rendimiento de la capacidad de procesamiento mejora de forma gradual a medida que se escriben datos nuevos y se redistribuyen en el almacenamiento adicional.

Errores de tipo "No queda espacio en el dispositivo"

A medida que el sistema de archivos se acerca a su capacidad máxima (por lo general, más del 90% de uso), es posible que comiences a recibir errores prematuros de No space left on device o FILESYSTEM_NO_SPACE_ON_DEVICE (ENOSPC), incluso si las herramientas de supervisión indican que el espacio libre agregado aún está disponible.

Este comportamiento puede ocurrir debido a varios mecanismos subyacentes en los sistemas de archivos distribuidos:

  • Desequilibrio de OST: Lustre distribuye los datos de los archivos en varios destinos de almacenamiento de objetos (OST). Sin embargo, ciertos patrones de carga de trabajo pueden llenar un solo OST, independientemente de tu configuración de striping. Entre las causas comunes, se incluyen escribir archivos en modo de adición (O_APPEND) o mantener archivos grandes desvinculados.

  • Errores posteriores a la expansión: Es posible que sigas recibiendo errores ENOSPC incluso después de agregar capacidad a tu clúster. Si bien expandir la capacidad agrega OST nuevos, no rebalancea automáticamente tus archivos preexistentes en los destinos recién agregados.

  • Otorgamientos de espacio del cliente: Los clientes de Compute Engine reservan de forma dinámica partes del espacio en el disco para mejorar el rendimiento. Este espacio de asignación reservado reduce el grupo físico disponible, lo que significa que las métricas de capacidad podrían no reflejar el espacio que los clientes distribuidos ya reclamaron.

  • Agotamiento de inodos: Las cargas de trabajo que generan millones de archivos pueden agotar los inodos disponibles del sistema de archivos antes de alcanzar los límites de almacenamiento físico, lo que causa errores ENOSPC en la creación de archivos nuevos.

Estrategias de mitigación recomendadas:

  • Supervisa la capacidad y configura alertas: Supervisa el uso de la capacidad por OST y las métricas de inodos individuales, además de la capacidad agregada del clúster. Ejecuta el comando lfs df desde un cliente activado para ver el uso de la capacidad por destino, usa lfs df -i para el uso de inodos por destino o consulta Supervisa instancias y operaciones para obtener detalles sobre las métricas de supervisión.

    Configura alertas automatizadas para que se activen cuando la capacidad agregada o el uso de OST individual supere el 80% (consulta Crea una alerta de capacidad de almacenamiento).

  • Aumenta la capacidad: Una vez que la capacidad agregada alcance el 80-90%, considera aumentar la capacidad de tu instancia de Managed Lustre. Es posible que debas solicitar una cuota adicional antes de la expansión.

  • Reequilibra el almacenamiento: Usa el comando lfs migrate, preferentemente en modo sin bloqueo (-n), para realizar la transición manual de los archivos de los OST sobreutilizados a los OST más vacíos o recién agregados.

  • Verifica si hay archivos desvinculados en los clientes: Los archivos desvinculados abiertos son archivos grandes que un proceso mantiene abiertos incluso después de desvincularlos del espacio de nombres del sistema de archivos. Estos archivos huérfanos permanecen en el disco y consumen espacio, pero no son visibles en las listas de directorios estándar. En este caso, las métricas de capacidad de Cloud Monitoring y el comando lfs df informan un uso de espacio mayor que du o lfs find. Usa el comando lsof en los clientes para identificar estos archivos buscando entradas marcadas como (deleted). Una vez identificado, finalizar el proceso que contiene el identificador de archivo o reiniciar la aplicación libera el espacio del sistema de archivos.