Eseguire la manutenzione self-service

La manutenzione self-service ti consente di applicare gli upgrade di manutenzione alle tue istanze Managed Lustre on demand.

Quando Managed Lustre rilascia una nuova versione software, questa diventa disponibile immediatamente per la manutenzione self-service. In genere, questo avviene diverse settimane prima che la manutenzione automatizzata raggiunga la tua istanza.

Puoi eseguire la manutenzione self-service in qualsiasi momento, non appena è disponibile una versione. Se l'istanza ha una policy di manutenzione, puoi eseguire la manutenzione self-service fino a un'ora prima di un periodo di manutenzione pianificato.

Per una panoramica dell'impatto e delle policy di manutenzione, consulta Panoramica sulla manutenzione.

Controlla le versioni di manutenzione disponibili

Le istanze di Managed Lustre monitorano le release di manutenzione utilizzando i seguenti campi della versione:

  • effectiveVersion: solo output. La versione di release del software in esecuzione nell'istanza. Ad esempio, Lustre_20260516.00_p00.
  • availableVersion: solo output. Una versione di release software più recente e idonea per l'upgrade della tua istanza. Se questo campo è vuoto, l'istanza esegue già l'ultima release disponibile.
  • targetVersion: solo input. Il parametro specificato in una richiesta di aggiornamento per avviare un upgrade a una versione candidata o a latest.

Per verificare la versione corrente dell'istanza e controllare se è disponibile un upgrade:

Console Google Cloud

  1. Nella console Google Cloud , vai alla pagina Managed Lustre:

    Vai a Managed Lustre

  2. Nell'elenco delle istanze, individua la tua istanza. Se è disponibile una versione di manutenzione più recente, accanto allo stato ACTIVE viene visualizzato il badge Aggiornamento disponibile.

  3. Fai clic sul nome dell'istanza per aprire la pagina Dettagli istanza e visualizzare la stringa della versione disponibile.

gcloud CLI

Esegui il comando gcloud lustre instances describe con un filtro di formato:

gcloud lustre instances describe INSTANCE_ID \
  --location=LOCATION \
  --format="yaml(effectiveVersion, availableVersion, state)"

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • LOCATION: la zona in cui si trova l'istanza.

Se è disponibile una versione più recente, l'output è simile al seguente:

availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE

Se availableVersion è vuoto, l'istanza esegue già l'ultima release disponibile.

REST

Per controllare i dettagli della versione di un'istanza, invia una richiesta GET all'endpoint dell'istanza:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN

Dove:

  • PROJECT_ID è l'ID progetto Google Cloud .
  • LOCATION è la zona in cui si trova l'istanza.
  • INSTANCE_ID è l'ID dell'istanza Managed Lustre.

Se è disponibile una versione più recente, la risposta contiene effectiveVersion e availableVersion:

{
  "name": "projects/my-project/locations/us-central1-a/instances/my-instance",
  "state": "ACTIVE",
  "effectiveVersion": "Lustre_20260516.00_p00",
  "availableVersion": "Lustre_20260716.01_p00"
}

Se availableVersion viene omesso o è vuoto, l'istanza esegue già l'ultima release disponibile.

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

Esegui un upgrade self-service

Per eseguire l'upgrade dell'istanza a una versione software disponibile:

gcloud CLI

Esegui il comando gcloud lustre instances update con il flag --target-version:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=latest

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • LOCATION: la zona in cui si trova l'istanza.

Per eseguire l'upgrade a una versione di release idonea specifica anziché a latest, passa la stringa della versione:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=TARGET_VERSION

Sostituisci TARGET_VERSION con la stringa della versione di availableVersion. Ad esempio: Lustre_20260716.01_p00.

REST

Per eseguire l'upgrade di un'istanza utilizzando l'API REST, invia una richiesta PATCH all'endpoint dell'istanza, specificando targetVersion nel parametro di query updateMask:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN

{
  "targetVersion": "latest"
}

Dove:

  • PROJECT_ID è l'ID progetto Google Cloud .
  • LOCATION è la zona in cui si trova l'istanza.
  • INSTANCE_ID è l'ID dell'istanza Managed Lustre.

Per eseguire l'upgrade a una versione di release idonea specifica anziché a latest, specifica la stringa della versione nel corpo della richiesta, ad esempio "targetVersion": "Lustre_20260716.01_p00".

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

Monitora l'avanzamento della manutenzione

L'upgrade viene eseguito come un'operazione a lunga esecuzione asincrona. La manutenzione self-service non attiva email di notifica automatiche.

Per monitorare i progressi in tempo reale:

gcloud CLI

Estrai lo stato di attività dell'operazione utilizzando il comando gcloud lustre operations describe:

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

Sostituisci quanto segue:

  • OPERATION_ID: l'ID operazione restituito dal comando di aggiornamento.
  • LOCATION: la zona in cui si trova l'istanza.

Lo stato dell'istanza mostra UPGRADING mentre l'upgrade è in corso e torna a ACTIVE al termine.

REST

Invia una richiesta GET all'endpoint operations.get:

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

Dove:

  • PROJECT_ID è l'ID progetto Google Cloud .
  • LOCATION è la zona in cui si trova l'istanza.
  • OPERATION_ID è l'ID operazione restituito dalla richiesta di aggiornamento.

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

Quando l'upgrade viene eseguito correttamente:

  1. L'istanza torna allo stato ACTIVE.
  2. effectiveVersion riflette la stringa della versione appena applicata.
  3. availableVersion viene cancellato e omesso dalle risposte dell'API.

Interazione con la manutenzione pianificata

Se per la tua istanza è prevista una manutenzione programmata, il completamento di un upgrade self-service annulla automaticamente la manutenzione programmata imminente. Se hai eseguito l'iscrizione alle notifiche di manutenzione, riceverai una notifica via email automatica Manutenzione annullata.

Se un upgrade self-service non va a buon fine, il periodo di manutenzione pianificato in attesa non viene annullato. L'istanza torna allo stato ACTIVE nella versione corrente e il periodo di manutenzione pianificato viene mantenuto.

Non puoi attivare un upgrade self-service entro un'ora dall'inizio di un periodo di manutenzione pianificato. Il tentativo di avviare un upgrade durante questo periodo restituisce un errore 409 CONFLICT per evitare sovrapposizioni con la manutenzione pianificata imminente.

Messaggi di errore

I possibili errori di manutenzione self-service includono:

  • Instance is already running version "<CURRENT>": si verifica se tenti di eseguire l'upgrade alla versione software già in esecuzione nell'istanza.
  • Downgrading to a lower version is not supported.: si verifica se provi a eseguire il downgrade a una versione software precedente.
  • Version "<TARGET>" is not a valid update version.: si verifica se la versione specificata non corrisponde alla stringa availableVersion o latest dell'istanza.
  • Instance must be in ACTIVE state to update version: si verifica se viene avviato un upgrade mentre l'istanza non è nello stato ACTIVE.
  • Cannot trigger self-service update within 1 hour of a scheduled maintenance window: si verifica se viene avviato un upgrade self-service meno di un'ora prima di un periodo di manutenzione pianificata imminente.