Eventi e policy di manutenzione

Per mantenere aggiornate le istanze Google Cloud Managed Lustre, Google Cloud esegui periodicamente la manutenzione. Gli eventi di manutenzione possono includere aggiornamenti del software o dell'infrastruttura sottostanti. Questi eventi potrebbero causare un downtime temporaneo, durante il quale le operazioni di I/O sull'istanza potrebbero smettere di rispondere. Le operazioni di I/O interessate riprendono al termine della manutenzione. Il downtime è in genere compreso tra 2 e 25 minuti.

Durante la manutenzione, lo stato di un'istanza è UPGRADING. Al termine della manutenzione, l'istanza torna allo stato ACTIVE.

Le policy di manutenzione consentono di controllare quando si verificano questi eventi di manutenzione. Puoi configurare una policy di manutenzione per ogni istanza per specificare i periodi di manutenzione e i periodi in cui la manutenzione deve essere esclusa. Se non è configurata alcuna policy di manutenzione su un'istanza, la manutenzione può essere eseguita in qualsiasi momento.

Puoi anche ripianificare un evento di manutenzione in modo che inizi immediatamente, durante il prossimo periodo disponibile o in un momento specifico fino a 28 giorni dopo.

Istanze di scalabilità estrema

Alcune configurazioni di Managed Lustre che offrono prestazioni e scalabilità estreme potrebbero richiedere un downtime pianificato fino a 4 ore per la manutenzione periodica dell'host. Google coordina in anticipo questi eventi di manutenzione con te.

Informazioni sulle policy di manutenzione

Puoi configurare una policy di manutenzione su ogni istanza Managed Lustre. Una policy di manutenzione include quanto segue:

  • Periodo di manutenzione settimanale: un periodo ricorrente di un'ora durante la settimana in cui è accettabile che Managed Lustre avvii un evento di manutenzione.
  • Periodo di esclusione della manutenzione: un periodo durante il quale Managed Lustre non è autorizzato ad avviare un evento di manutenzione. Puoi definire un periodo di esclusione per istanza, con una durata massima di due settimane. Se non viene specificato alcun anno nelle date di inizio e fine, il periodo di esclusione si ripete ogni anno.

Un periodo di esclusione ha la precedenza su un normale periodo di manutenzione. Se un evento pianificato rientra in questo periodo, Managed Lustre lo rimanda al prossimo periodo disponibile o lo salta completamente. L'aggiornamento viene applicato durante il ciclo di manutenzione successivo.

Notifiche relative alla manutenzione

Puoi abbonarti alle notifiche via email per gli eventi di manutenzione imminenti per pianificare eventuali interruzioni. Gli abbonamenti alle notifiche di manutenzione vengono gestiti tramite la pagina Comunicazione della console Google Cloud :

Vai alla pagina Comunicazione

Una volta effettuato l'abbonamento, vengono inviate le seguenti notifiche:

  • Notifica anticipata: inviata da 7 a 14 giorni prima di un evento di manutenzione pianificato o dopo che un evento di manutenzione è stato ripianificato dal cliente.
  • Annullata: inviata se un evento di manutenzione pianificato viene annullato da Google o ripianificato dal cliente.
  • In corso: inviata all'inizio di un evento di manutenzione.
  • Completata: inviata al termine di un evento di manutenzione.

Puoi anche visualizzare le pianificazioni di manutenzione imminenti nella pagina dei dettagli dell'istanza in the Google Cloud console oppure puoi utilizzare Cloud Logging per visualizzare i log di manutenzione.

Configurare un periodo di manutenzione

Un periodo di manutenzione richiede un giorno della settimana e un'ora di inizio UTC per il periodo di un'ora.

Google Cloud Console

Per configurare un periodo di manutenzione durante la creazione di un'istanza, consulta Crea un'istanza.

gcloud

Crea un'istanza con un periodo di manutenzione specificando il flag --maintenance-policy-weekly-windows:

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FS_NAME \
  --location=LOCATION \
  --network=NETWORK_PATH \
  --maintenance-policy-weekly-windows='dayOfWeek=DAY,startTime={START_TIME}'

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • PER_UNIT_STORAGE_THROUGHPUT è il livello di prestazioni in MBps per TiB. I valori validi sono 0, 125, 250, 500 e 1000. Per specificare il [livello dinamico][dynamic-tier], imposta questo valore su 0 e includi il flag --dynamic-tier-options-mode=DEFAULT_CACHE.
  • CAPACITY: la capacità dell'istanza in GiB.
  • FS_NAME: il nome del file system.
  • LOCATION: la località dell'istanza Managed Lustre.
  • NETWORK_PATH: il percorso completo della rete VPC a cui appartiene l'istanza, nel formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configura una rete VPC.
  • 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 ulteriori dettagli sulla creazione di un'istanza, consulta Crea un'istanza Managed Lustre.

API REST

Per specificare un periodo di manutenzione per un'istanza, includi l'oggetto maintenancePolicy durante la creazione di un'istanza.

Di seguito è riportato un esempio di oggetto maintenancePolicy:

"maintenancePolicy": {
  "weeklyMaintenanceWindows": [
    {
      "dayOfWeek": "DAY",
      "startTime": {
        "hours": HOURS,
        "minutes": MINUTES
      }
    }
  ]
}

Sostituisci quanto segue:

  • DAY: il giorno della settimana per il periodo di manutenzione (ad es. TUESDAY).
  • HOURS: l'ora del giorno per l'ora di inizio del periodo di manutenzione (ad es. 1).
  • MINUTES: il minuto dell'ora per l'ora di inizio del periodo di manutenzione (ad es. 0).

Configurare un periodo di esclusione

Per impedire che la manutenzione venga eseguita durante determinati periodi, ad esempio festività o eventi aziendali, puoi definire un periodo di esclusione della manutenzione nella policy di manutenzione. I periodi di esclusione possono durare fino a due settimane. Per creare un periodo di esclusione ricorrente annualmente, non specificare un anno nelle date di inizio e fine.

Puoi combinare un periodo di manutenzione settimanale e un periodo di esclusione nella stessa policy.

Google Cloud Console

Per configurare un periodo di esclusione durante la creazione di un'istanza, consulta Crea un'istanza.

gcloud

Crea un'istanza con un periodo di esclusione specificando il flag --maintenance-policy-exclusion-window:

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 \
  --maintenance-policy-exclusion-window='startDate={START_DATE},endDate={END_DATE},time={TIME}'

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • PER_UNIT_STORAGE_THROUGHPUT è il livello di prestazioni in MBps per TiB. I valori validi sono 0, 125, 250, 500 e 1000. Per specificare il [livello dinamico][dynamic-tier], imposta questo valore su 0 e includi il flag --dynamic-tier-options-mode=DEFAULT_CACHE.
  • CAPACITY: la capacità dell'istanza in GiB.
  • FS_NAME: il nome del file system.
  • LOCATION: la località dell'istanza Managed Lustre.
  • NETWORK_PATH: il percorso completo della rete VPC a cui appartiene l'istanza, nel formato projects/PROJECT_ID/global/networks/NETWORK. Consulta Configura una rete VPC.
  • START_DATE: la data di inizio del periodo di esclusione della manutenzione in formato dizionario (ad es. {day=08,month=06,year=2026}). Per la ricorrenza annuale, ometti la chiave year.
  • END_DATE: la data di fine del periodo di esclusione della manutenzione in formato dizionario (ad es. {day=08,month=06,year=2026}). Per la ricorrenza annuale, ometti la chiave year.
  • TIME: l'ora di inizio e di fine UTC del periodo di esclusione in formato dizionario (ad es. {hours=1,minutes=0}).

API REST

Di seguito è riportato un esempio di oggetto maintenancePolicy con un periodo di esclusione:

"maintenancePolicy": {
  "maintenanceExclusionWindow": [
    {
      "startDate": {
        "day": START_DAY,
        "month": START_MONTH,
        "year": START_YEAR
      },
      "endDate": {
        "day": END_DAY,
        "month": END_MONTH,
        "year": END_YEAR
      },
      "time": {
        "hours": HOURS,
        "minutes": MINUTES
      }
    }
  ]
}

Sostituisci quanto segue:

  • START_YEAR: l'anno della data di inizio del periodo di esclusione (ad es. 2026). Ometti questo campo e END_YEAR per creare un periodo ricorrente annualmente .
  • START_MONTH: il mese della data di inizio del periodo di esclusione (ad es. 12).
  • START_DAY: il giorno della data di inizio del periodo di esclusione (ad es. 24).
  • END_YEAR: l'anno della data di fine del periodo di esclusione (ad es. 2027). Ometti questo campo e START_YEAR per creare un periodo ricorrente annualmente .
  • END_MONTH: il mese della data di fine del periodo di esclusione (ad es. 1).
  • END_DAY: il giorno della data di fine del periodo di esclusione (ad es. 7).
  • HOURS: l'ora del giorno per l'ora del periodo di esclusione (ad es. 0).
  • MINUTES: il minuto dell'ora per l'ora del periodo di esclusione (ad es. 0).

Aggiornare una policy di manutenzione

Per aggiungere o modificare la policy di manutenzione per un'istanza esistente:

Google Cloud Console

Per aggiornare la policy di manutenzione per un'istanza, consulta Gestire le istanze.

gcloud

Il seguente esempio di gcloud aggiorna la policy di manutenzione per un'istanza:

gcloud lustre instances update INSTANCE_ID \
--location=LOCATION \
--maintenance-policy-weekly-windows='dayOfWeek=DAY,startTime={START_TIME}'

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • LOCATION: la località dell'istanza Managed Lustre.
  • 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}).

API REST

Per specificare un periodo di manutenzione per un'istanza, includi l'oggetto maintenancePolicy durante l'aggiornamento di un'istanza. Devi anche specificare maintenancePolicy nel parametro di query updateMask.

Il seguente esempio di curl aggiorna la policy di manutenzione per un'istanza:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=maintenancePolicy"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION LOCATION: la località dell'istanza Managed Lustre.
  • INSTANCE_ID L'ID dell'istanza Managed Lustre.
  • DAY: il giorno della settimana per il periodo di manutenzione (ad es. TUESDAY).
  • HOURS HOURS: l'ora del giorno per l'ora di inizio del periodo di manutenzione (ad es. 3).
  • MINUTES MINUTES: il minuto dell'ora per l'ora di inizio del periodo di manutenzione (ad es. 45).

Rimuovere una policy di manutenzione

Per rimuovere una policy di manutenzione da un'istanza, cancella tutti i periodi di manutenzione settimanali e i periodi di esclusione dalla policy.

Google Cloud Console

Per rimuovere una policy di manutenzione da un'istanza, modifica l'istanza e cancella i campi della policy di manutenzione. Consulta Gestire le istanze.

gcloud

Utilizza il comando gcloud lustre instances update con i flag --clear-maintenance-policy-weekly-windows e --clear-maintenance-policy-exclusion-window:

gcloud lustre instances update INSTANCE_ID \
--location=LOCATION \
--clear-maintenance-policy-weekly-windows \
--clear-maintenance-policy-exclusion-window

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • LOCATION: la località dell'istanza Managed Lustre.

API REST

Per rimuovere una policy di manutenzione utilizzando l'API REST, utilizza il instances.patch metodo con un oggetto maintenancePolicy vuoto e il parametro di query updateMaskquery impostato su maintenancePolicy:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "maintenancePolicy": {}
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=maintenancePolicy"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la località dell'istanza Managed Lustre.
  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.

Visualizzare i log di manutenzione

Managed Lustre utilizza Cloud Logging per registrare gli eventi di manutenzione, inclusi i seguenti tipi di attività:

  • LustreAdvancedNotification: è stata pianificata la manutenzione per l'istanza.
  • LustreOngoingNotification: è iniziata la manutenzione dell'istanza. Al termine, viene registrato un altro evento LustreOngoingNotification, questa volta con is_completed=true.
  • LustreCancelledNotification: la manutenzione è stata annullata.

Puoi visualizzare i log di manutenzione utilizzando Esplora log o Google Cloud CLI.

Esplora log

Per visualizzare i log di manutenzione di Managed Lustre utilizzando Esplora log:

  1. Nella Google Cloud console, vai alla pagina Cloud Logging > Esplora log:

    Vai a Esplora log

  2. Inserisci il seguente filtro nell'editor di query e fai clic su Esegui query:

    resource.type="lustre.googleapis.com/Instance"
resource.labels.instance_id="INSTANCE_ID"
resource.labels.location="LOCATION"
logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"

gcloud CLI

Per visualizzare i log di manutenzione con Google Cloud CLI, esegui il gcloud logging read comando:

gcloud logging read 'resource.type="lustre.googleapis.com/Instance" resource.labels.instance_id="INSTANCE_ID" resource.labels.location="LOCATION" logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"' --project=PROJECT_ID

Sostituisci quanto segue:

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

Ripianificare manutenzione

Se un evento di manutenzione pianificato è in conflitto con le tue esigenze, puoi ripianificarlo. Quando ripianifichi, hai le seguenti opzioni:

  • Immediatamente: ripianifica l'evento di manutenzione in modo che inizi il prima possibile. Questa opzione ignora tutti i periodi di manutenzione e i periodi di esclusione configurati sull'istanza.
  • Prossima finestra di disponibilità: ripianifica l'evento di manutenzione al prossimo periodo di manutenzione disponibile. In genere, l'aggiornamento viene spostato di una settimana.
  • Per data: ripianifica l'evento di manutenzione in una data e un'ora specifiche. Puoi ritardare la manutenzione di un massimo di 28 giorni rispetto all'ora originariamente pianificata. Questa opzione ignora tutti i periodi di manutenzione e i periodi di esclusione configurati sull'istanza.

Per ripianificare la manutenzione:

gcloud

Per avviare l'evento di manutenzione il prima possibile:

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=immediately

Per ripianificare la manutenzione al prossimo periodo disponibile:

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=next-available-window

Per ripianificare la manutenzione a un'ora specifica:

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=by-time \
--reschedule-schedule-time=TIMESTAMP

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • LOCATION: la località dell'istanza Managed Lustre.
  • TIMESTAMP: l'ora di inizio in formato RFC 3339 (ad es. 2026-04-30T10:00:00Z). Questa non deve essere successiva a 28 giorni dall' ora originariamente pianificata.

API REST

Utilizza il instances.rescheduleMaintenance metodo.

Il seguente esempio di curl avvia l'evento di manutenzione il prima possibile:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "IMMEDIATELY"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

Il seguente esempio di curl ripianifica la manutenzione al prossimo periodo disponibile:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "NEXT_AVAILABLE_WINDOW"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

Il seguente esempio di curl ripianifica la manutenzione a un'ora specifica:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "BY_TIME",
    "scheduleTime": "TIMESTAMP"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • INSTANCE_ID: l'ID dell'istanza Managed Lustre.
  • LOCATION: la località dell'istanza Managed Lustre.
  • TIMESTAMP: l'ora di inizio in formato RFC 3339 (ad es. 2026-04-30T10:00:00Z). Questa non deve essere successiva a 28 giorni dall' ora originariamente pianificata.