Gestisci le istanze Google Cloud Managed Lustre

Dopo aver creato un'istanza, Google Cloud Managed Lustre ti consente di elencare, recuperare, aggiornare ed eliminare le istanze.

Stati delle istanze

Un'istanza Managed Lustre può essere in uno dei seguenti stati:

Stato Descrizione
CREATING L'istanza è in fase di creazione e non è ancora pronta per l'uso.
ACTIVE L'istanza è disponibile per l'uso.
REPAIRING È in corso la riparazione dell'istanza.
MAINTENANCE o UPGRADING L'istanza è in fase di manutenzione. Per ulteriori informazioni, consulta Eventi e policy di manutenzione.
SUSPENDED L'istanza è sospesa, in genere a causa di un problema con una chiave di crittografia gestita dal cliente (CMEK).
DELETING L'istanza verrà eliminata.

Elenca istanze

Per elencare tutte le istanze in un progetto:

Google Cloud Console

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

    Vai a Managed Lustre

    Vengono elencate le istanze del progetto.

gcloud CLI

Utilizza il gcloud lustre instances list comando:

gcloud lustre instances list --location=LOCATION

Sostituisci LOCATION con una zona specifica per elencare tutte le istanze in quella località. Per visualizzare i progetti in tutte le località, inserisci - come valore. Ad esempio:

gcloud lustre instances list --location=-

REST

Per elencare le istanze utilizzando l'API REST, invia una richiesta al seguente endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID del Google Cloud progetto.

  • ZONE è la zona per la quale elencare tutte le istanze. Per elencare le istanze di tutte le zone, utilizza - come valore.

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

Recupera un'istanza

Per recuperare i dettagli di un'istanza:

Google Cloud Console

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

    Vai a Managed Lustre

  2. Fai clic sul nome dell'istanza per visualizzare i dettagli di un'istanza specifica.

gcloud CLI

Utilizza il gcloud lustre instances describe comando:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Per recuperare i dettagli di una determinata istanza utilizzando l'API REST, invia una richiesta al seguente endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID del Google Cloud progetto.

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

  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da restituire.

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

Aggiorna un'istanza

Puoi aggiornare le seguenti proprietà di un'istanza esistente:

  • Descrizione
  • Etichette
  • Capacità dello spazio di archiviazione
  • Policy di manutenzione

Per informazioni sull'aumento della capacità di archiviazione di un'istanza, consulta Aumentare la capacità di un'istanza.

Per informazioni sulla configurazione delle policy di manutenzione, consulta Eventi e policy di manutenzione.

Per aggiornare un'istanza:

Google Cloud Console

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

    Vai a Managed Lustre

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

  3. Fai clic su Modifica.

  4. Inserisci i nuovi valori.

  5. Fai clic su Invia.

gcloud CLI

Utilizza il gcloud lustre instances update comando:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION \
  --maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}

Dove:

  • INSTANCE_NAME è l'istanza da aggiornare.
  • LOCATION è la zona in cui risiede 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 passo. Per ulteriori dettagli, consulta Aumentare la capacità di un'istanza.

  • NEW_DESCRIPTION è un nuovo valore per il campo della descrizione, che sovrascrive qualsiasi descrizione esistente.

  • DAY: il giorno della settimana per il periodo di manutenzione (ad es. TUESDAY).

  • START_TIME: l'ora di inizio UTC del periodo di manutenzione in formato dizionario (ad es. {hours=1,minutes=0}).

Per aggiornare le etichette, consulta i comandi disponibili nella documentazione di gcloud lustre instances update.

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=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  },
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID del Google Cloud progetto.
  • ZONE è la zona dell'istanza Google Cloud .
  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da aggiornare.
  • UPDATE_MASK è un elenco separato da virgole dei campi da aggiornare. Un campo verrà sovrascritto solo se è presente nella maschera.

Il corpo della richiesta deve contenere uno o più dei seguenti campi:

  • capacityGiB è 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 passo. Per ulteriori dettagli, consulta Aumentare la capacità di un'istanza.
  • description è la nuova descrizione per questa istanza.
  • labels è il nuovo insieme di etichette per questa istanza. Il valore di labels è un oggetto JSON contenente una o più coppie chiave-valore.
  • maintenancePolicy è la policy di manutenzione per l'istanza. Per i dettagli, consulta Eventi e policy di manutenzione.

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

Impossibile mettere in coda l'operazione

Se viene visualizzato un errore simile al seguente quando tenti di aggiornare un'istanza:

ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation

Questo errore si verifica quando tenti di avviare un'operazione mentre un'altra operazione dello stesso tipo è già in corso sulla stessa istanza. Managed Lustre consente un aggiornamento attivo per istanza alla volta e consente di mettere in coda un'operazione di aggiornamento aggiuntiva.

Per risolvere il problema, attendi il completamento dell'operazione corrente prima di avviarne una nuova.

Elimina un'istanza

Per eliminare un'istanza:

Google Cloud Console

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

    Vai a Managed Lustre

  2. Seleziona il menu con tre puntini accanto all'istanza da eliminare.

  3. Seleziona Elimina istanza. Conferma l'eliminazione facendo di nuovo clic su Elimina.

gcloud CLI

Utilizza il gcloud lustre instances delete comando:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Ti viene chiesto di confermare l'eliminazione. Digita Y o premi Invio per continuare.

REST

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

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID del Google Cloud progetto.

  • ZONE è la Google Cloud zona in cui si trova l'istanza.

  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da eliminare.

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

Le richieste di eliminazione sono richieste a lunga esecuzione e restituiscono un ID operazione su cui è possibile eseguire query per lo stato dell'operazione. Per i dettagli, consulta il riferimento operations.get.