Crea un'istanza Managed Lustre

Un'istanza Google Cloud Managed Lustre è un file system Lustre completo nel cloud. Può essere montato su una VM Compute Engine o su un cluster Google Kubernetes Engine (GKE). Accedi ai dati sull'istanza utilizzando la terminologia POSIX standard.

Quando crei un'istanza Managed Lustre, devi definire le seguenti proprietà:

  • Il nome dell'istanza, utilizzato da Google Cloud.
  • Il nome del file system, utilizzato da strumenti lato client come lfs.
  • La capacità di archiviazione in gibibyte (GiB). La capacità può variare da 9000 GiB a 84.016.000 GiB (80,1 PiB). La dimensione massima di un'istanza dipende dal relativo livello di prestazioni.
  • Il livello di prestazioni. Managed Lustre offre livelli di prestazioni che vanno da 125 MBps per TiB a 1000 MBps per TiB, nonché un livello dinamico che ottimizza le prestazioni in base ai pattern di accesso ai dati, con un throughput aggregato di 25 MBps per TiB.
  • La località. Per ottenere prestazioni ottimali, individua l'istanza nella stessa zona delle VM client o del cluster GKE.
  • La rete VPC per questa istanza. Deve essere la stessa rete utilizzata per le VM o i cluster.

Livelli di prestazioni e capacità di archiviazione massime

Managed Lustre offre 4 livelli di prestazioni impostati e un livello dinamico. I livelli di prestazioni influiscono sulla dimensione minima e massima dell'istanza e sulla dimensione del passo tra i valori di capacità accettabili. Non puoi modificare il livello di prestazioni di un'istanza dopo la creazione.

Per maggiori dettagli, consulta Livelli di prestazioni.

Puoi aumentare la capacità di archiviazione di un'istanza dopo la creazione, fino al valore massimo consentito per il relativo livello di prestazioni e la dimensione del passo.

Calcolatore della capacità

Seleziona un livello di prestazioni e inserisci la capacità target per trovare la dimensione valida più vicina. Le dimensioni valide vengono arrotondate per eccesso in base alla dimensione minima e del passo del livello.

Quota di capacità di archiviazione

La quota di capacità di archiviazione disponibile dipende da molti fattori, tra cui la località dell'istanza e il livello di prestazioni richiesto.

La quota di capacità di archiviazione predefinita è per rete Virtual Private Cloud (VPC) per zona ed è condivisa tra tutti i livelli di prestazioni. L'utilizzo della capacità in un livello riduce la quota di capacità di archiviazione disponibile negli altri livelli.

Per maggiori dettagli, consulta Quote e limiti.

Autorizzazioni obbligatorie

Per creare una nuova istanza Managed Lustre, devi disporre delle autorizzazioni IAM di amministratore di Managed Lustre (roles/lustre.admin) per il tuo progetto.

Per maggiori dettagli, consulta Controllo dell'accesso con IAM.

Devi anche aver abilitato l'API Managed Lustre.

Crea un'istanza

Puoi creare una nuova istanza Managed Lustre dalle seguenti interfacce.

gcloud

Per creare una nuova istanza Managed Lustre, utilizza il 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

Devi specificare i seguenti valori:

  • INSTANCE_ID è il nome di questa istanza Managed Lustre. Deve:

    • Contenere solo lettere minuscole, numeri e trattini.
    • Iniziare con una lettera.
    • Avere una lunghezza compresa tra 1 e 63 caratteri.
    • Terminare con un numero o una lettera.
    • Essere univoco all'interno del progetto e della località.

  • --per-unit-storage-throughput è il throughput massimo dell'istanza in MBps per TiB. I valori validi sono 0, 125, 250, 500 e 1000. La scelta del throughput influisce sulla capacità di archiviazione minima e massima dell'istanza.

    Per specificare il livello Dinamico, imposta questo valore su 0 e includi il flag --dynamic-tier-options-mode=DEFAULT_CACHE. Ad esempio:

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

  • --capacity-gib è la capacità di archiviazione dell'istanza in gibibyte (GiB). I valori consentiti dipendono dal livello di throughput di archiviazione specificato. Per maggiori dettagli, consulta la sezione Livelli di prestazioni e capacità di archiviazione massime.

  • --filesystem è il nome da assegnare a questo file system Lustre. Questo nome viene utilizzato dai comandi lato client, inclusi mount e lfs. La lunghezza deve essere di massimo 8 caratteri, può contenere solo lettere e/o numeri e fa distinzione tra maiuscole e minuscole.

    Ti consigliamo di scegliere un nome univoco per tutte le istanze Managed Lustre nel VPC. In questo modo è possibile utilizzare più istanze da un singolo nodo GKE.

  • --location deve essere una zona valida supportata da Managed Lustre. Google Cloud Per un elenco completo, consulta Località supportate.

  • --network è il percorso completo della rete VPC a cui appartiene l'istanza, nel formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configurare una rete VPC.

  • --project è il tuo Google Cloud ID progetto.

I flag facoltativi sono i seguenti:

  • --dynamic-tier-options-mode specifica il livello dinamico per questa istanza. Imposta il valore di questo flag su DEFAULT_CACHE e --per-unit-storage-throughput=0 per abilitare il livello dinamico.

  • --kms-key-name specifica una chiave di crittografia gestita dal cliente con cui criptare questa istanza. Per maggiori dettagli, consulta Chiavi di crittografia gestite dal cliente per Managed Lustre.

  • --async (facoltativo) esegue il comando in modo asincrono. Anziché attendere il completamento della creazione dell'istanza, Google Cloud CLI restituisce un ID operazione che può essere utilizzato per eseguire query sullo stato del comando.

Una richiesta riuscita restituisce un ID operazione:

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 creazione dell'istanza richiede circa 15 minuti per un'istanza con una capacità di 9000 GiB, fino a diverse ore per un'istanza con una capacità di 84.016.000 GiB (80,1 PiB). Per istruzioni su come controllare lo stato della richiesta, consulta Eseguire query sullo stato di creazione dell'istanza.

REST

Per creare un'istanza utilizzando l'API REST, invia una richiesta al seguente endpoint:

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
}

Devi specificare i seguenti valori:

  • PROJECT_ID è il tuo Google Cloud ID progetto.

  • ZONE deve essere una zona valida supportata da Managed Lustre. Google Cloud Per un elenco completo, consulta Località supportate.

  • INSTANCE_ID è il nome di questa istanza Managed Lustre. Deve:

    • Contenere solo lettere minuscole, numeri e trattini.
    • Iniziare con una lettera.
    • Avere una lunghezza compresa tra 1 e 63 caratteri.
    • Terminare con un numero o una lettera.
    • Essere univoco all'interno del progetto e della località.

  • filesystem è il nome da assegnare a questo file system Lustre. Questo nome viene utilizzato dai comandi lato client, inclusi mount e lfs. La lunghezza deve essere di massimo 8 caratteri, può contenere solo lettere e/o numeri e fa distinzione tra maiuscole e minuscole.

    Ti consigliamo di scegliere un nome di file system univoco per tutte le istanze Managed Lustre nel VPC. In questo modo è possibile utilizzare più istanze da un singolo nodo GKE.

  • perUnitStorageThroughput è il throughput massimo dell'istanza in MBps per TiB. I valori validi sono 0, 125, 250, 500 e 1000. La scelta del throughput influisce sulla capacità di archiviazione minima e massima dell'istanza.

    Per specificare il livello dinamico, imposta questo valore su 0 e includi l'oggetto dynamicTierOptions. Ad esempio:

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

  • capacityGib è la capacità di archiviazione dell'istanza in gibibyte (GiB). I valori consentiti dipendono dal livello di throughput di archiviazione specificato. Per maggiori dettagli, consulta la sezione Livelli di prestazioni e capacità di archiviazione massime.

  • network è il percorso completo della rete VPC a cui appartiene l'istanza, nel formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configurare una rete VPC.

I seguenti campi sono facoltativi:

  • dynamicTierOptions abilita il livello dinamico per questa istanza. Il campo mode all'interno dell'oggetto dynamicTierOptions deve essere impostato su DEFAULT_CACHE e perUnitStorageThroughput deve essere 0 per abilitare il livello dinamico.

  • kmsKey specifica una chiave di crittografia gestita dal cliente con cui criptare questa istanza. Per maggiori dettagli, consulta Chiavi di crittografia gestite dal cliente per Managed Lustre.

L'API supporta altri campi facoltativi per le istanze. Per un elenco completo e le descrizioni, consulta la documentazione di riferimento della risorsa Instance.

Google Cloud Console

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

    Vai a Managed Lustre

  2. Fai clic su Crea. Viene visualizzata la pagina Crea un'istanza.

  3. Inserisci un nome istanza univoco e, facoltativamente, una descrizione. Il nome dell'istanza viene utilizzato da Google Cloud per identificare questa istanza.

  4. Inserisci un nome per il file system. Questo è il nome utilizzato dagli strumenti lato client come lfs. La lunghezza deve essere di massimo 8 caratteri, può contenere solo lettere e/o numeri e fa distinzione tra maiuscole e minuscole.

  5. Seleziona una regione e una zona in cui creare questa istanza. Devi posizionare l'istanza nella stessa regione e zona delle VM Compute Engine o dei cluster Google Kubernetes Engine che si connetteranno a essa.

  6. Seleziona il livello di prestazioni per questa istanza.

  7. Specifica la capacità di archiviazione in gibibyte (GiB) dell'istanza. I valori validi dipendono dal livello di throughput di archiviazione selezionato. Per maggiori dettagli, consulta la sezione Livelli di prestazioni e capacità di archiviazione massime.

  8. Nella sezione Crittografia, seleziona Chiave di crittografia gestita da Google o Chiave Cloud Key Management Service. Per informazioni sull'opzione della chiave Cloud Key Management Service, consulta Chiavi di crittografia gestite dal cliente per Managed Lustre.

  9. Seleziona la rete che hai creato in Creare una rete VPC.

La sezione Riepilogo della pagina viene aggiornata per mostrare una stima dei costi in base alle selezioni.

Fai clic su Invia per continuare. Il processo di creazione dell'istanza richiede da 15 minuti a un'ora, a seconda della capacità dell'istanza.

Eseguire query sullo stato di creazione dell'istanza

Puoi eseguire query sullo stato di una richiesta di creazione dalle seguenti interfacce.

gcloud

Per eseguire query sullo stato di un'operazione di creazione, puoi ottenere l'operazione o l'istanza.

Per ottenere l'istanza:

gcloud lustre instances describe INSTANCE_NAME \
  --location=ZONE

Lo stato di creazione è il valore di state.

Per ottenere l'operazione, utilizza l'ID operazione dalla risposta di creazione dell'istanza. L'ID operazione ha il seguente formato:

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

Lo stato di creazione è il valore di done.

Una volta creata l'istanza, il risultato di una richiesta get sull'istanza è simile alla seguente risposta.

Prendi nota dell'indirizzo IP nel campo mountPoint e del nome del file system; avrai bisogno di questi valori quando monti l'istanza.

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

Per eseguire query sullo stato di un'operazione di creazione, utilizza l'ID operazione dalla 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

Se l'operazione ha esito positivo, il corpo della risposta contiene un'istanza di Operation.

Google Cloud Console

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

    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 creazione dell'istanza.

Passaggi successivi