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 i periodi 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 la console Google Cloud o gcloud CLI.

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

Console

Per creare un'istanza con periodi di manutenzione, consulta Crea istanze.

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 essere compreso tra 1 e 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 numero di 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 la console Google Cloud o gcloud CLI.

Console

1. Nella console Google Cloud , vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi impostare una finestra preferita.

3. Nella pagina Istanza a colpo d'occhio, scorri fino a visualizzare la scheda Manutenzione.

4. Accanto al campo Finestra di manutenzione, fai clic su Modifica ().

   Se accanto al campo vengono visualizzati un giorno e un'ora, significa che hai già impostato la periodo di manutenzionee per l'istanza.

5. Nella finestra di dialogo Modifica periodo di manutenzione, procedi nel seguente modo:

   1. Seleziona Personalizzato.
   2. Nel menu Giorno, seleziona il giorno in cui vuoi che venga eseguita la manutenzione.
   3. Dal menu Ora, seleziona l'ora di inizio del periodo di manutenzione.
   4. Fai clic su Aggiorna istanza.

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

Se pianifichi la manutenzione per un'istanza Memorystore for Valkey, puoi utilizzare la console Google Cloud per attivare le notifiche di manutenzione per l'istanza.

1. Nella console Google Cloud , vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi attivare le notifiche di manutenzione.

3. Nella pagina Istanza a colpo d'occhio, scorri fino a visualizzare la scheda Manutenzione.

4. Fai clic su Modifica preferenze di notifica.

   Se questo link è disattivato, non hai pianificato la manutenzione per l'istanza.

5. Fai clic su Notifiche di prodotto.

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

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

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

Console

1. Nella console Google Cloud , vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi trovare la manutenzione pianificata.

3. Nella pagina Istanza a colpo d'occhio, scorri fino a visualizzare la scheda Manutenzione.

   Accanto al campo Periodo di manutenzione, vengono visualizzati il giorno e l'ora della manutenzione pianificata.

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 pianificata è 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 pianificato 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 la console Google Cloud o gcloud CLI per riprogrammare la manutenzione di un'istanza Memorystore for Valkey. Di conseguenza, puoi posticipare un aggiornamento di manutenzione fino a due settimane dalla data in cui l'aggiornamento è originariamente pianificato 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 in blocco 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.

Console

1. Nella console Google Cloud , vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi ripianificare la manutenzione.

3. Nella pagina Istanza a colpo d'occhio, scorri fino a visualizzare la scheda Manutenzione.

4. Accanto al campo Manutenzione imminente, fai clic su Modifica ().

   Se accanto a questo campo viene visualizzato lo stato Nessuna manutenzione programmata al momento, significa che la manutenzione non è pianificata per l'istanza.

5. Nella finestra di dialogo Ripianifica manutenzione imminente, procedi nel seguente modo:

   1. Nel menu Scegli un nuovo orario, seleziona Orario specifico.
   2. Nel campo Data, fai clic su Calendario (), quindi seleziona la data in cui vuoi che venga eseguita la manutenzione.
   3. Dal menu Ora, indica un orario specifico per l'aggiornamento. Questo periodo di tempo non deve superare i 14 giorni dalla data della periodo di manutenzione originale.
   4. Fai clic su Ripianifica.

   Puoi anche utilizzare la finestra di dialogo Ripianifica manutenzione imminente per fare in modo che Memorystore for Valkey esegua immediatamente la manutenzione dell'istanza. In questa finestra di dialogo, seleziona Aggiorna ora dal menu Scegli un nuovo orario e poi fai clic su Aggiorna ora.

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.

Rimuovi una policy di manutenzione da un'istanza

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

Console

1. Nella console Google Cloud , vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi rimuovere un criterio di manutenzione.

3. Nella pagina Istanza a colpo d'occhio, scorri fino a visualizzare la scheda Manutenzione.

4. Accanto al campo Finestra di manutenzione, fai clic su Modifica ().

   Se accanto al campo non vengono visualizzati un giorno e un'ora, significa che hai già rimosso la policy di manutenzione dall'istanza.

5. Nella finestra di dialogo Modifica periodo di manutenzione, procedi nel seguente modo:

   1. Seleziona Predefinito.
   2. Fai clic su Aggiorna 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 i periodi di manutenzione di un'istanza Memorystore for Valkey.