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 abbia un impatto sui tempi di inattività. Oltre alla manutenzione delle istanze eseguita da Memorystore for Valkey, puoi personalizzare le pianificazioni di manutenzione in base alle esigenze della tua applicazione e ridurre al minimo le interruzioni. Per personalizzare le pianificazioni di manutenzione, puoi configurare i periodi di manutenzione per le istanze.

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

• Crea un'istanza con periodi di manutenzione
• Imposta un periodo preferito per la manutenzione
• Attiva le notifiche di manutenzione
• Trova la manutenzione pianificata
• Ripianifica la manutenzione
• Rimuovi una policy di manutenzione da un'istanza

Per una panoramica degli aggiornamenti di 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 periodi di manutenzione utilizzando la Google Cloud console o gcloud CLI.

Importante: prima di seguire i passaggi descritti in questa sezione, completa i passaggi nelle sezioni Prima di iniziare e Configura 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 gcloud memorystore instances create comando:

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

Assicurati di sostituire quanto segue:

• INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey che stai creando. L'ID istanza deve essere composto 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 progetto o il numero del Google Cloud progetto 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 ulteriori informazioni sulle specifiche dell'istanza, consulta Specifiche di istanza e nodo.

• 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 accettabili 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 periodi di manutenzione, la crittografia in transito viene disattivata e la rete autorizzata è default.

Imposta un periodo preferito per la manutenzione

Puoi impostare un periodo di manutenzione per un'istanza Memorystore for Valkey utilizzando la Google Cloud console o gcloud CLI.

Console

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

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi impostare un periodo preferito.

3. Nella pagina Istanza in sintesi, scorri fino alla scheda Manutenzione.

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

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

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

   1. Seleziona Personalizzato.
   2. Dal 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 gcloud memorystore instances update comando:

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

Assicurati di sostituire quanto segue:

• INSTANCE_ID: l'ID dell'istanza.
• PROJECT_ID: l'ID o il numero del Google Cloud progetto 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 accettabili sono 0 - 23.

Attiva le notifiche di manutenzione

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

1. Nella Google Cloud console, 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 in sintesi, scorri fino alla scheda Manutenzione.

4. Fai clic su Modifica preferenze di notifica.

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

5. Fai clic su Notifiche prodotto.

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

7. Nella riga di Memorystore, attiva il pulsante dell'email 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 la ricezione 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 del team).

Trova la manutenzione pianificata

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

Console

1. Nella Google Cloud console, 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 in sintesi, scorri fino alla 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 gcloud memorystore instances describe comando.

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

Assicurati di sostituire quanto segue:

• INSTANCE_ID: l'ID dell'istanza
• PROJECT_ID: l'ID progetto o il numero del Google Cloud progetto 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 sul periodo di manutenzione settimanale per l'istanza.
  • DAY è il giorno della settimana in cui viene eseguita la manutenzione.
  • HOUR è l'ora (in ora 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 di 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 pianificato per l'istanza.

Ripianifica la manutenzione

Puoi utilizzare la Google Cloud console o la gcloud CLI per ripianificare 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 per l'istanza.

Attenzione: anche se Memorystore for Valkey non ti offre la possibilità di ripianificare la manutenzione per più istanze contemporaneamente, puoi ripianificare la manutenzione in blocco a livello di programmazione. Se ripianifichi in blocco, raggruppa le operazioni in richieste di dimensioni appropriate. Ti consigliamo di limitare la dimensione del batch a 100 istanze e di attendere un tempo sufficiente tra le richieste. In caso contrario, potresti aver riscontrato errori durante la ripianificazione degli eventi. Per ulteriori informazioni, consulta Manutenzione pianificata.

Console

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

   Memorystore for Valkey

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

3. Nella pagina Istanza in sintesi, scorri fino alla scheda Manutenzione.

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

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

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

   1. Dal menu Scegli una nuova ora, seleziona Ora specifica.
   2. Nel campo Data, fai clic su Calendario (), quindi seleziona la data in cui vuoi che venga eseguita la manutenzione.
   3. Dal menu Ora, seleziona un'ora specifica per l'aggiornamento. Questa ora non deve superare i 14 giorni dall'ora del 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 una nuova ora, quindi fai clic su Aggiorna ora.

gcloud

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

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

Assicurati di sostituire quanto segue:

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

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

  • IMMEDIATE: avvia immediatamente l'aggiornamento di manutenzione.
  • SPECIFIC_TIME: seleziona un'ora specifica per l'aggiornamento. Questa ora non deve superare i 14 giorni dall'ora del 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 ora 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 Google Cloud console o la gcloud CLI per rimuovere la policy dall'istanza.

Console

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

   Memorystore for Valkey

2. Fai clic sull'istanza per cui vuoi rimuovere una policy di manutenzione.

3. Nella pagina Istanza in sintesi, scorri fino alla scheda Manutenzione.

4. Accanto al campo Periodo 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 gcloud memorystore instances update comando.

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

Assicurati di sostituire quanto segue:

• INSTANCE_ID: l'ID dell'istanza da cui vuoi rimuovere la policy di manutenzione
• PROJECT_ID: l'ID progetto o il numero del Google Cloud progetto 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 per un'istanza Memorystore for Valkey.