Aumentare la capacità di un'istanza Managed Lustre

Puoi aumentare la capacità di archiviazione della tua istanza Managed Lustre. Non è possibile ridurre la capacità.

Quando aumenti la capacità di un'istanza, puoi continuare a utilizzarla mentre l'operazione di aggiornamento è in corso.

Limitazioni all'aumento della capacità

Per i livelli di prestazioni con due diverse dimensioni dei passaggi, la capacità attuale dell'istanza determina la dimensione massima possibile.

Se la capacità di un'istanza è pari o inferiore alla soglia della dimensione del passo, la sua dimensione può essere aumentata fino al valore della soglia stessa. Non può essere espanso oltre questo limite.

Ad esempio, nel livello da 250 MBps per TiB, la soglia in cui cambia la dimensione del passo è 10.224.000 GiB. Qualsiasi istanza creata con una capacità pari o inferiore a questa soglia può essere espansa solo fino al limite di 10.224.000 GiB.

Calcola la nuova capacità

Puoi aggiornare la capacità di un'istanza fino al valore massimo consentito per il livello di prestazioni e la dimensione del passo. Questi valori sono i seguenti:

Livello prestazioni Capacità minima Capacità massima Dimensione passo
1000 MBps per TiB 9.000 GiB 10.008.000 GiB (9,5 PiB) Per capacità di archiviazione fino a 2.556.000 GiB: 9000 GiB
Per capacità di archiviazione superiori: 72.000 GiB
500 MBps per TiB 18.000 GiB 20.016.000 GiB (19,1 PiB) Per capacità di archiviazione fino a 5.112.000 GiB: 18.000 GiB
Per capacità di archiviazione superiori: 144.000 GiB
250 MBps per TiB 36.000 GiB 40.032.000 GiB (38,2 PiB) Per capacità di archiviazione fino a 10.224.000 GiB: 36.000 GiB
Per capacità di archiviazione superiori: 288.000 GiB
125 MBps per TiB 72.000 GiB 20.448.000 GiB (19,5 PiB) 72.000 GiB
Dinamico (25 MBps per TiB) 472.000 GiB 84.016.000 GiB (80,1 PiB) 472.000 GiB

La capacità aggiornata deve essere un multiplo della dimensione del passo e non può superare il valore massimo per quella dimensione del passo.

Il tuo progetto Google Cloud ha quote di throughput e capacità che influiscono sulla capacità disponibile per rete Virtual Private Cloud (VPC) per zona. Prima di aumentare la capacità dell'istanza, potresti dover richiedere una quota di throughput o capacità aggiuntiva. Per maggiori dettagli, consulta Quote e limiti.

Calcolatore della capacità

Utilizza il seguente calcolatore per trovare una capacità valida per il livello di prestazioni selezionato.

Aggiorna la capacità dell'istanza

Puoi utilizzare la console Google Cloud o Google Cloud CLI per aggiornare la capacità dell'istanza.

Console Google Cloud

  1. Vai alla pagina Lustre gestito nella console Google Cloud .

    Vai a Managed Lustre

  2. Fai clic sul nome dell'istanza da aggiornare. Viene visualizzata la pagina Panoramica dell'istanza.

  3. Fai clic su Modifica.

  4. Inserisci il nuovo valore della capacità di archiviazione. Il valore deve essere inferiore o uguale alla capacità massima consentita e deve essere un multiplo della dimensione del passo. Per questi valori, consulta Calcola la nuova capacità.

  5. Fai clic su Invia.

gcloud

Utilizza il comando gcloud lustre instances update per aumentare la capacità di archiviazione dell'istanza:

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

Dove:

  • INSTANCE_NAME è l'istanza da aggiornare.
  • LOCATION è la zona in cui si trova l'istanza.
  • NEW_CAPACITY è la nuova capacità di archiviazione per questa istanza in gibibyte (GiB). Il valore non può superare la capacità massima consentita e deve essere un multiplo della dimensione del passaggio. Per questi valori, consulta Calcola la nuova capacità.

REST

Per aggiornare un'istanza utilizzando l'API REST, invia una richiesta PATCH al relativo endpoint specifico:

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

{
  "capacityGib": NEW_CAPACITY
}

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID progetto Google Cloud .
  • ZONE è la zona Google Cloud dell'istanza.
  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da aggiornare.
  • updateMask=capacityGib specifica il campo da aggiornare. Un campo verrà sovrascritto solo se si trova nella maschera.
  • NEW_CAPACITY è la nuova capacità di archiviazione per questa istanza in gibibyte (GiB). Il valore non può superare la capacità massima consentita e deve essere un multiplo della dimensione del passaggio. Per questi valori, consulta Calcola la nuova capacità.

Per ulteriori dettagli, consulta il riferimento API instances.patch.

Una volta inviata la richiesta di aggiornamento, Managed Lustre controlla la quota disponibile. Se la quota è sufficiente, la capacità dell'istanza viene aumentata in un periodo di tempo che dipende dalla variazione delle dimensioni. Gli aumenti possono richiedere da 20 minuti a un'ora o più.

Puoi continuare a utilizzare l'istanza durante l'operazione di aggiornamento.

Visualizza lo stato dell'aggiornamento

Puoi visualizzare lo stato di una richiesta di aggiornamento dalle seguenti interfacce.

Console Google Cloud

  1. Vai alla pagina Lustre gestito nella console Google Cloud .

    Vai a Managed Lustre

  2. Fai clic sul nome dell'istanza nell'elenco. Viene visualizzata la pagina Dettagli istanza, che include lo stato attuale della richiesta di aggiornamento dell'istanza.

gcloud

Per impostazione predefinita, il comando gcloud lustre instances update attende il completamento prima di restituire il prompt della shell:

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

Al termine, la riga di comando visualizza Updated instance [my-instance] insieme ai dettagli dell'istanza, inclusa la capacità aggiornata.

Se hai eseguito il comando di aggiornamento con il flag --async o se devi eseguire una query sullo stato dell'aggiornamento dalla riga di comando, puoi recuperare i dettagli dell'operazione per verificare se l'aggiornamento dell'istanza è stato completato:

gcloud lustre operations describe OPERATION_ID \
  --location=ZONE

Durante l'aggiornamento dell'istanza, la risposta mostra un valore done: false. Al termine, done viene impostato su true.

Ad esempio:

$ 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

Per eseguire una query sullo stato di un'operazione di aggiornamento, utilizza l'ID operazione della risposta. L'ID operazione ha il seguente formato:

  • operation-1234567890123-6127783ad26ea-88913969-02748053

Invia una richiesta al seguente endpoint:

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

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Prestazioni dopo l'aumento della capacità

Il throughput massimo di un'istanza Managed Lustre è determinato dalla capacità di archiviazione e dal livello di prestazioni. L'aumento della capacità di archiviazione di un'istanza esistente aumenta anche il suo throughput massimo.

L'aumento delle prestazioni potrebbe non essere visibile fino alla scrittura di nuovi dati. Le prestazioni di throughput migliorano gradualmente man mano che i nuovi dati vengono scritti e ridistribuiti nello spazio di archiviazione aggiuntivo.

Errori "Spazio esaurito sul dispositivo"

Quando il file system si avvicina alla capacità massima (in genere un utilizzo superiore al 90%), potresti iniziare a ricevere errori prematuri No space left on device o FILESYSTEM_NO_SPACE_ON_DEVICE (ENOSPC), anche se gli strumenti di monitoraggio indicano che lo spazio libero aggregato è ancora disponibile.

Questo comportamento può verificarsi a causa di diversi meccanismi sottostanti nei file system distribuiti:

  • Squilibrio degli OST: Lustre suddivide i dati dei file in più target di archiviazione di oggetti (OST). Tuttavia, alcuni pattern di workload possono riempire un singolo OST, indipendentemente dalla configurazione di striping. Le cause più comuni includono la scrittura di file in modalità di aggiunta (O_APPEND) o la gestione di file di grandi dimensioni non collegati.

  • Errori post-espansione: potresti continuare a ricevere errori ENOSPC anche dopo aver aggiunto capacità al cluster. L'espansione della capacità aggiunge nuovi OST, ma non riequilibra automaticamente i file preesistenti sui target appena aggiunti.

  • Concessioni di spazio client: i client di Compute Engine prenotano dinamicamente porzioni di spazio su disco per migliorare le prestazioni. Questo spazio di concessione riservato riduce il pool fisico disponibile, il che significa che le metriche di capacità potrebbero non riflettere lo spazio già richiesto dai client distribuiti.

  • Esaurimento degli inode: i workload che generano milioni di file possono esaurire gli inode disponibili del file system prima di raggiungere i limiti di spazio di archiviazione fisico, causando errori ENOSPC durante la creazione di nuovi file.

Strategie di mitigazione consigliate:

  • Monitora la capacità e configura gli avvisi: monitora l'utilizzo della capacità per OST e le metriche dei singoli inode, oltre alla capacità aggregata del cluster. Esegui il comando lfs df da un client montato per visualizzare l'utilizzo della capacità per target, utilizza lfs df -i per l'utilizzo degli inode per target o consulta Monitora istanze e operazioni per i dettagli sulle metriche di monitoraggio.

    Configura avvisi automatici da attivare quando la capacità aggregata o l'utilizzo di un singolo OST supera l'80% (consulta Crea un avviso sulla capacità di archiviazione).

  • Aumenta la capacità: quando la capacità aggregata raggiunge l'80-90%, valuta la possibilità di aumentare la capacità dell'istanza Managed Lustre. Prima dell'espansione, potrebbe essere necessario richiedere una quota aggiuntiva.

  • Ribilancia lo spazio di archiviazione: utilizza il comando lfs migrate, preferibilmente in modalità non bloccante (-n), per trasferire manualmente i file dagli OST sovrautilizzati a quelli più vuoti o appena aggiunti.

  • Controlla la presenza di file non collegati sui client: i file non collegati aperti sono file di grandi dimensioni mantenuti aperti da un processo anche dopo essere stati scollegati dallo spazio dei nomi del file system. Questi file orfani rimangono sul disco, consumando spazio, ma non sono visibili negli elenchi di directory standard. In questo caso, le metriche sulla capacità di Cloud Monitoring e il comando lfs df segnalano un utilizzo dello spazio maggiore rispetto a du o lfs find. Utilizza il comando lsof sui client per identificare questi file cercando le voci contrassegnate come (deleted). Una volta identificato, termina il processo che contiene l'handle del file o riavvia l'applicazione per liberare lo spazio del file system.