Individuazione e impostazione dei periodi di manutenzione

Memorystore for Valkey aggiorna regolarmente le istanze eseguendo la manutenzione per garantire che il servizio sia affidabile, efficiente, sicuro, aggiornato e non influisca sui tempi di inattività. Oltre alla manutenzione delle istanze eseguita da Memorystore for Valkey, puoi personalizzare le pianificazioni della manutenzione in modo che siano in linea con le esigenze della tua applicazione e per ridurre al minimo le interruzioni. Per personalizzare le pianificazioni di manutenzione, puoi configurare i periodi di manutenzione per le tue istanze.

Questa pagina fornisce istruzioni su come completare le seguenti attività per personalizzare le finestre di manutenzione:

• Crea un'istanza con periodi di manutenzione
• Impostare un periodo preferito per la manutenzione
• Attivare le notifiche di manutenzione
• Trovare la manutenzione pianificata
• Ripianifica la manutenzione
• Rimuovere una policy di manutenzione da un'istanza

Per una panoramica degli aggiornamenti della manutenzione e dei periodi di manutenzione, consulta Informazioni sulla manutenzione.

Crea un'istanza con periodi di manutenzione

Puoi creare un'istanza Memorystore for Valkey con finestre di manutenzione utilizzando gcloud CLI.

Importante :prima di seguire i passaggi descritti in questa sezione, completa quelli delle sezioni Prima di iniziare e Configurare la rete.

gcloud

Per creare un'istanza con periodi di manutenzione, utilizza il comando gcloud memorystore instances create:

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID \
--shard-count=SHARD_COUNT \
--maintenance-policy-weekly-window=day=DAY,startTime=hours=HOUR

Effettua le seguenti sostituzioni:

• INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey che stai creando. L'ID istanza deve contenere da 1 a 63 caratteri e utilizzare solo lettere minuscole, numeri o trattini. Deve iniziare con una lettera minuscola e terminare con una lettera minuscola o un numero.

• PROJECT_ID: l'ID o il numero del progetto Google Cloud in cui vuoi creare l'istanza.

• REGION_ID: la regione in cui vuoi che si trovi l'istanza.

  Nota: puoi creare istanze solo nelle regioni supportate per Memorystore for Valkey.

• NETWORK_ID: l'ID della rete che vuoi utilizzare per creare l'istanza.

• SHARD_COUNT: il numero di shard nell'istanza. Il conteggio degli shard determina la capacità di memoria totale per l'archiviazione dei dati dell'istanza. Per maggiori informazioni sulle specifiche delle istanze, consulta Specifiche di istanze e nodi.

• DAY: il giorno in cui vuoi che venga eseguita la manutenzione. I valori accettabili sono
  MONDAY - SUNDAY.

• HOUR: l'ora del giorno (in ora UTC) in cui inizia il periodo di manutenzione. I valori accettati sono 0 - 23.

Ad esempio:

gcloud memorystore instances create my-instance \
--project=my-project \
--location=us-central1 \
--psc-auto-connections=network=projects/my-project/global/networks/default \
--shard-count=8 \
--maintenance-policy-weekly-window=day=MONDAY,startTime=hours=9

Per impostazione predefinita, quando crei un'istanza con finestre di manutenzione, la crittografia in transito è disattivata e la rete autorizzata è default.

Impostare un periodo preferito per la manutenzione

Puoi impostare una periodo di manutenzione per un'istanza Memorystore for Valkey utilizzando gcloud CLI.

gcloud

Per impostare un periodo di manutenzione per un'istanza, utilizza il comando gcloud memorystore instances update:

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--maintenance-policy-weekly-window=day=DAY,startTime=hours=HOUR

Effettua le seguenti sostituzioni:

• INSTANCE_ID: l'ID dell'istanza.
• PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza.
• REGION_ID: la regione in cui si trova l'istanza.
• DAY: il giorno in cui vuoi che venga eseguita la manutenzione. I valori accettabili sono
  MONDAY - SUNDAY.
• HOUR: l'ora del giorno (in ora UTC) in cui inizia il periodo di manutenzione. I valori accettati sono 0 - 23.

Attivare le notifiche di manutenzione

Puoi attivare le notifiche di manutenzione per un'istanza Memorystore for Valkey utilizzando la console Google Cloud .

Nota :anche se attivi le notifiche di manutenzione, non riceverai notifiche a meno che tu non imposti un periodo di manutenzione per l'istanza.

1. Nella console Google Cloud , vai alla pagina Comunicazione.

   Comunicazione

2. Fai clic su Notifiche di prodotto.

3. Dal menu, seleziona il tuo progetto Google Cloud .

4. Nella riga di Memorystore, attiva il pulsante email impostandolo su ON.

Un'email di notifica di manutenzione utilizza questo titolo: "Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]". Ogni indirizzo email che deve ricevere le notifiche deve attivare l'opzione separatamente.

Le notifiche di manutenzione vengono impostate a livello di progetto anziché sulle istanze. Memorystore for Valkey invia notifiche all'indirizzo email associato al tuo Account Google. Non puoi configurare un alias email personalizzato (ad esempio, un alias email di team).

Trovare la manutenzione programmata

Se pianifichi la manutenzione per un'istanza Memorystore for Valkey, puoi visualizzarla utilizzando gcloud CLI.

gcloud

Per trovare la manutenzione pianificata per un'istanza, utilizza il comando gcloud memorystore instances describe.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Effettua le seguenti sostituzioni:

• INSTANCE_ID: l'ID dell'istanza
• PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza
• REGION_ID: la regione in cui si trova l'istanza

L'output per la manutenzione programmata è il seguente:

maintenancePolicy:
  weeklyMaintenanceWindow:
  - day: DAY
      duration: 3600 seconds
  - startTime
       hour: HOUR
maintenanceSchedule:
  endTime: 'END_DATE_AND_TIME_STAMP'
  scheduleDeadlineTime: 'SCHEDULED_DATE_AND_TIME_STAMP'
  startTime: 'START_DATE_AND_TIME_STAMP'

Dove:

• maintenancePolicy mostra informazioni sull'ora di creazione della policy di manutenzione preferita.
• weeklyMaintenanceWindow mostra informazioni sulla periodo di manutenzione settimanale per l'istanza.
  • DAY è il giorno della settimana in cui viene eseguita la manutenzione.
  • HOUR è l'ora (in formato UTC) in cui inizia la manutenzione.
• maintenanceSchedule mostra informazioni sulla manutenzione pianificata per l'istanza.
  • END_DATE_AND_TIME_STAMP indica quando termina un aggiornamento della manutenzione pianificata per l'istanza.
  • SCHEDULED_DATE_AND_TIME_STAMP indica quando è prevista la fine di un aggiornamento di manutenzione per l'istanza.
  • START_DATE_AND_TIME_STAMP indica quando inizia un aggiornamento di manutenzione pianificata per l'istanza.

Ripianifica manutenzione

Puoi utilizzare gcloud CLI per riprogrammare la manutenzione per un'istanza Memorystore for Valkey. Di conseguenza, puoi posticipare un aggiornamento di manutenzione fino a due settimane dalla data di pianificazione originale dell'aggiornamento per l'istanza.

Attenzione :anche se Memorystore for Valkey non ti offre la possibilità di riprogrammare la manutenzione per più istanze contemporaneamente, puoi riprogrammare la manutenzione collettivamente a livello di programmazione. Se riprogrammi in blocco, raggruppa le operazioni in richieste di dimensioni appropriate. Ti consigliamo di limitare le dimensioni del batch a 100 istanze e di attendere un tempo sufficiente tra le richieste. In caso contrario, potresti non essere riuscito a riprogrammare gli eventi. Per saperne di più, consulta Manutenzione pianificata.

gcloud

Per riprogrammare la manutenzione di un'istanza, utilizza il comando gcloud memorystore instances reschedule-maintenance.

gcloud memorystore instances reschedule-maintenance INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESCHEDULE_TIME]

Effettua le seguenti sostituzioni:

• INSTANCE_ID: l'ID dell'istanza.
• PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza.
• REGION_ID: la regione in cui si trova l'istanza.

• RESCHEDULE_TYPE: il tipo di aggiornamento riprogrammato. I valori disponibili sono:

  • IMMEDIATE: avvia l'aggiornamento della manutenzione immediatamente.
  • SPECIFIC_TIME: specifica un orario specifico per l'aggiornamento. Questo periodo di tempo non deve superare i 14 giorni dal periodo di manutenzione originale.

• RESCHEDULE_TIME: la data e l'ora in cui Memorystore for Valkey ripianifica l'aggiornamento di manutenzione.

  Nota: per specificare un valore per il parametro RESCHEDULE_TIME, devi impostare il parametro RESCHEDULE_TYPE su SPECIFIC_TIME. Questo valore utilizza lo standard ISO 8601 (ad esempio, 2025-02-16T16:56:00.000Z). L'ora è impostata in formato UTC.

Rimuovere una policy di manutenzione da un'istanza

Se non hai più bisogno di una norma di manutenzione per un'istanza Memorystore for Valkey e vuoi utilizzare l'impostazione predefinita del servizio per la manutenzione, puoi utilizzare gcloud CLI per rimuovere la norma dall'istanza.

gcloud

Per rimuovere una policy di manutenzione da un'istanza, utilizza il comando gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-maintenance-policy-weekly-window

Effettua le seguenti sostituzioni:

• INSTANCE_ID: l'ID dell'istanza da cui vuoi rimuovere la policy di manutenzione
• PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza
• REGION_ID: la regione in cui si trova l'istanza

Passaggi successivi

• Visualizza le autorizzazioni necessarie per gestire le finestre di manutenzione per un'istanza Memorystore for Valkey.