Crea un'istanza Managed Lustre

Un'istanza Google Cloud Managed Lustre è un file system Lustre completo nel cloud. Può essere montato su una VM di Compute Engine o su un cluster Kubernetes Engine. 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 12.240.000 GiB (11,67 PiB). La dimensione massima di un'istanza dipende dal suo livello di prestazioni.
  • Il livello prestazioni. Managed Lustre offre livelli di prestazioni che vanno da 125 MBps per TiB a 1000 MBps per TiB.
  • La posizione. 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.
  • Indica se verrà eseguito l'accesso a questa istanza da un cluster Kubernetes Engine (GKE). Poiché sia Lustre che GKE utilizzano la porta 988 per impostazione predefinita, questa impostazione modifica la porta Lustre per evitare conflitti.

Livelli di prestazioni e capacità di archiviazione massime

Managed Lustre offre 4 livelli di prestazioni, ognuno con una velocità di throughput massima diversa per TiB. I livelli di prestazioni influiscono anche sulle dimensioni minime e massime dell'istanza e sulla dimensione del passo tra i valori di capacità accettabili.

Livello Capacità minima Capacità massima Dimensione passo
125 MBps per TiB 72.000 GiB 12.240.000 GiB (11,67 PiB) 72.000 GiB
250 MBps per TiB 36.000 GiB 6.120.000 GiB (5,84 PiB) 36.000 GiB
500 MBps per TiB 18.000 GiB 3.060.000 GiB (2,92 PiB) 18.000 GiB
1000 MBps per TiB 9.000 GiB 1.530.000 GiB (1,46 PiB) 9.000 GiB

Non puoi modificare il livello di prestazioni di un'istanza dopo la creazione.

Autorizzazioni obbligatorie

Per creare una nuova istanza Managed Lustre, devi disporre delle autorizzazioni IAM Managed Lustre Admin (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

Devono essere specificati i seguenti valori:

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

    • Deve contenere solo lettere minuscole, numeri e trattini.
    • Deve iniziare con una lettera.
    • Deve avere una lunghezza compresa tra 1 e 63 caratteri.
    • Deve 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 125, 250, 500 e 1000. La scelta della velocità effettiva influisce sulla capacità di archiviazione minima e massima dell'istanza.

  • --capacity-gib è la capacità di archiviazione dell'istanza in gibibyte (GiB). I valori consentiti dipendono dal livello di throughput di archiviazione specificato. Per i 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. Deve contenere al 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 Google Cloud valida supportata da Managed Lustre. Consulta l'elenco completo delle località supportate.

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

  • --project è l'ID progetto Google Cloud .

I flag facoltativi sono i seguenti:

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

  • --gke-support-enabled crea un'istanza che può essere utilizzata dai cluster Google Kubernetes Engine. Imposta accept_port di Lustre LNet su 6988.

    Per connetterti da una VM Compute Engine quando è specificato --gke-support-enabled, devi aggiornare il file di configurazione LNet sulla VM. Consulta Configura LNet per le istanze gke-support-enabled.

  • --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 9000 GiB di capacità, fino a un'ora per un'istanza con 12.240.000 GiB (11,67 PiB) di capacità. Consulta Stato di creazione dell'istanza di query per istruzioni su come controllare lo stato della richiesta.

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,
  "gkeSupportEnabled": boolean
}

Devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID progetto Google Cloud .

  • ZONE deve essere una zona Google Cloud valida supportata da Managed Lustre. Consulta l'elenco completo delle località supportate.

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

    • Deve contenere solo lettere minuscole, numeri e trattini.
    • Deve iniziare con una lettera.
    • Deve avere una lunghezza compresa tra 1 e 63 caratteri.
    • Deve 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. Deve contenere al massimo 8 caratteri, può contenere solo lettere e/o numeri e fa distinzione tra maiuscole e minuscole.

    Ti consigliamo di scegliere un nome del 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 125, 250, 500 e 1000. La scelta della velocità effettiva influisce sulla capacità di archiviazione minima e massima dell'istanza.

  • capacityGib è la capacità di archiviazione dell'istanza in gibibyte (GiB). I valori consentiti dipendono dal livello di throughput di archiviazione specificato. Per i 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 Configura una rete VPC.

I seguenti campi sono facoltativi:

L'API supporta campi facoltativi aggiuntivi per le istanze. Consulta la documentazione di riferimento delle risorse Instance per un elenco completo e le descrizioni.

Console Google Cloud

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

    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 filesystem. Questo è il nome utilizzato dagli strumenti lato client come lfs. Deve contenere al 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 velocità effettiva di archiviazione selezionato. Per i 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. Se ti connetterai a questa istanza da un cluster GKE, seleziona Abilita il supporto di GKE. Questa opzione imposta accept_port Lustre LNet su 6988.

    Per connetterti da una VM Compute Engine quando è specificata l'opzione Abilita supporto GKE, devi aggiornare il file di configurazione LNet sulla VM. Consulta Configura LNet per le istanze gke-support-enabled.

  10. Seleziona la rete che hai creato in Crea una rete VPC.

La sezione Riepilogo della pagina viene aggiornata per mostrare una stima dei costi in base alle tue 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.

Stato di creazione dell'istanza di query

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 monterai 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 una query sullo stato di un'operazione di creazione, 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.

Console Google Cloud

  1. Vai alla pagina Managed Lustre 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 creazione dell'istanza.

Passaggi successivi