Rechercher et définir des intervalles de maintenance

Memorystore for Valkey met régulièrement à jour les instances en effectuant des opérations de maintenance pour s'assurer que le service est fiable, performant, sécurisé, à jour et qu'il n'a aucun impact sur les temps d'arrêt. En plus de la maintenance effectuée par Memorystore for Valkey sur vos instances, vous pouvez personnaliser les programmes de maintenance en fonction des besoins de votre application et pour minimiser les interruptions. Pour personnaliser vos programmes de maintenance, vous pouvez configurer des intervalles de maintenance pour vos instances.

Cette page explique comment effectuer les tâches suivantes pour personnaliser les intervalles de maintenance :

• Créer une instance avec des intervalles de maintenance
• Définir un intervalle souhaité pour la maintenance
• Activer les notifications de maintenance
• Rechercher la maintenance planifiée
• Reprogrammer la maintenance
• Supprimer une stratégie de maintenance d'une instance

Pour obtenir une présentation des mises à jour et des intervalles de maintenance, consultez la page À propos de la maintenance.

Créer une instance avec des intervalles de maintenance

Vous pouvez créer une instance Memorystore for Valkey avec des intervalles de maintenance en utilisant la Google Cloud console ou gcloud CLI.

Important : Avant de suivre les étapes de cette section, suivez celles des sections Avant de commencer et Configurer la mise en réseau.

Console

Pour créer une instance avec des intervalles de maintenance, consultez la section Créer des instances.

gcloud

Pour créer une instance avec des intervalles de maintenance, utilisez la gcloud memorystore instances create commande :

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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance Memorystore for Valkey que vous créez. L'ID de l'instance doit comporter entre 1 et 63 caractères et ne contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.

• PROJECT_ID : ID du projet ou numéro du Google Cloud projet dans lequel vous souhaitez créer l'instance.

• REGION_ID : région dans laquelle vous souhaitez placer l'instance.

  Remarque : Vous ne pouvez créer des instances que dans les régions compatibles avec Memorystore for Valkey.

• NETWORK_ID : ID du réseau que vous souhaitez utiliser pour créer l'instance.

• SHARD_COUNT : nombre de fragments dans l'instance. Le nombre de fragments détermine la capacité de mémoire totale pour stocker les données de l'instance. Pour en savoir plus sur les spécifications des instances, consultez la section Spécifications des instances et des nœuds.

• DAY : jour auquel vous souhaitez que la maintenance soit effectuée. Les valeurs acceptables sont
  MONDAY - SUNDAY.

• HOUR : heure du jour (au format UTC) à laquelle l'intervalle de maintenance commence. Les valeurs acceptables sont 0 - 23.

Exemple :

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

Par défaut, lorsque vous créez une instance avec des intervalles de maintenance, le chiffrement en transit est désactivé et le réseau autorisé est default.

Définir un intervalle souhaité pour la maintenance

Vous pouvez définir un intervalle de maintenance pour une instance Memorystore for Valkey à l'aide de la Google Cloud console ou de gcloud CLI.

Console

1. Dans la Google Cloud console, accédez à la Memorystore for Valkey page.

   Memorystore for Valkey

2. Cliquez sur l'instance pour laquelle vous souhaitez définir un intervalle souhaité.

3. Sur la page Aperçu de l'instance, faites défiler la page jusqu'à ce que la fiche Maintenance s'affiche.

4. À côté du champ Intervalle de maintenance, cliquez sur Modifier ().

   Si un jour et une heure s'affichent à côté du champ, cela signifie que vous avez déjà défini l'intervalle de maintenance pour l'instance.

5. Dans la boîte de dialogue Modifier l'intervalle de maintenance, procédez comme suit :

   1. Sélectionnez Personnalisé.
   2. Dans le menu Jour, sélectionnez le jour auquel vous souhaitez que la maintenance soit effectuée.
   3. Dans le menu Heure, sélectionnez l'heure à laquelle vous souhaitez que l'intervalle de maintenance commence.
   4. Cliquez sur Mettre à jour l'instance.

gcloud

Pour définir un intervalle de maintenance pour une instance, utilisez la gcloud memorystore instances update commande :

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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance
• PROJECT_ID : ID du projet ou numéro du Google Cloud projet contenant l'instance
• REGION_ID : région où se trouve l'instance
• DAY : jour auquel vous souhaitez que la maintenance soit effectuée. Les valeurs acceptables sont
  MONDAY - SUNDAY.
• HOUR : heure du jour (au format UTC) à laquelle l'intervalle de maintenance commence. Les valeurs acceptables sont 0 - 23.

Activer les notifications de maintenance

Si vous planifiez une maintenance pour une instance Memorystore for Valkey, vous pouvez utiliser la Google Cloud console pour activer les notifications de maintenance pour l'instance.

1. Dans la Google Cloud console, accédez à la page Memorystore for Valkey.

   Memorystore for Valkey

2. Cliquez sur l'instance pour laquelle vous souhaitez activer les notifications de maintenance.

3. Sur la page Aperçu de l'instance, faites défiler la page jusqu'à ce que la fiche Maintenance s'affiche.

4. Cliquez sur Modifier les préférences de notification.

   Si ce lien est désactivé, cela signifie que vous n'avez pas planifié de maintenance pour l'instance.

5. Cliquez sur Notifications concernant les produits.

6. Dans le menu, sélectionnez votre Google Cloud projet.

7. Sur la ligne Memorystore, basculez le bouton d'e-mail sur ACTIVÉ.

Un e-mail de notification de maintenance utilise l'intitulé suivant : "Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]". Chaque adresse e-mail devant recevoir des notifications doit activer elle-même l'option.

Vous définissez les notifications de maintenance au niveau du projet plutôt que sur les instances. Memorystore for Valkey envoie des notifications à l'adresse e-mail associée à votre compte Google. Vous ne pouvez pas configurer d'alias d'adresse e-mail personnalisé (par exemple, un alias d'adresse e-mail d'équipe).

Rechercher la maintenance planifiée

Si vous planifiez une maintenance pour une instance Memorystore for Valkey, vous pouvez l'afficher à l'aide de la console ou de gcloud CLI. Google Cloud

Console

1. Dans la Google Cloud console, accédez à la Memorystore for Valkey page.

   Memorystore for Valkey

2. Cliquez sur l'instance pour laquelle vous souhaitez rechercher la maintenance planifiée.

3. Sur la page Aperçu de l'instance, faites défiler la page jusqu'à ce que la fiche Maintenance s'affiche.

   À côté du champ Intervalle de maintenance, le jour et l'heure de la maintenance planifiée s'affichent.

gcloud

Pour rechercher la maintenance planifiée pour une instance, utilisez la gcloud memorystore instances describe commande.

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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance
• PROJECT_ID : ID du projet ou numéro du projet contenant l'instance Google Cloud
• REGION_ID : région où se trouve l'instance

Le résultat de la maintenance planifiée est le suivant :

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'

Où :

• maintenancePolicy affiche des informations sur l'heure de création de la stratégie de maintenance à privilégier.
• weeklyMaintenanceWindow affiche des informations sur l'intervalle de maintenance hebdomadaire de l'instance.
  • DAY correspond au jour de la semaine où la maintenance est effectuée.
  • HOUR correspond à l'heure (au format UTC) à laquelle la maintenance commence.
• maintenanceSchedule affiche des informations sur la maintenance planifiée pour l'instance.
  • END_DATE_AND_TIME_STAMP indique la fin d'une mise à jour de maintenance planifiée pour l'instance.
  • SCHEDULED_DATE_AND_TIME_STAMP indique la date et l'heure auxquelles une mise à jour de maintenance doit être terminée pour l'instance.
  • START_DATE_AND_TIME_STAMP indique le début d'une mise à jour de maintenance planifiée pour l'instance.

Reprogrammer la maintenance

Vous pouvez utiliser la Google Cloud console ou la gcloud CLI pour reprogrammer la maintenance d'une instance Memorystore for Valkey. Par conséquent, vous pouvez reporter une mise à jour de maintenance jusqu'à deux semaines à compter de la date de planification initiale de la mise à jour pour l'instance.

Attention : Bien que Memorystore for Valkey ne vous permette pas de reprogrammer la maintenance pour plusieurs instances à la fois, vous pouvez le faire de manière groupée par programmation. Si vous reprogrammez en bloc, regroupez vos opérations dans des requêtes de taille appropriée. Nous vous recommandons de limiter la taille de lot à 100 instances et d'attendre suffisamment de temps entre les requêtes. Sinon, vous risquez d'échouer à reprogrammer les événements. Pour plus d'informations, consultez la section Maintenance planifiée.

Console

1. Dans la Google Cloud console, accédez à la Memorystore for Valkey page.

   Memorystore for Valkey

2. Cliquez sur l'instance pour laquelle vous souhaitez reprogrammer la maintenance.

3. Sur la page Aperçu de l'instance, faites défiler la page jusqu'à ce que la fiche Maintenance s'affiche.

4. À côté du champ Maintenance à venir, cliquez sur Modifier ().

   Si l'état Aucune maintenance actuellement programmée s'affiche à côté de ce champ, cela signifie qu'aucune maintenance n'est programmée pour l'instance.

5. Dans la boîte de dialogue Reprogrammer la maintenance à venir, procédez comme suit :

   1. Dans le menu Choisir une nouvelle heure, sélectionnez Heure spécifique.
   2. Dans le champ Date, cliquez sur Agenda (), puis sélectionnez la date à laquelle vous souhaitez que la maintenance soit effectuée.
   3. Dans le menu Heure, indiquez une heure spécifique pour la mise à jour. Cette heure ne doit pas dépasser 14 jours à compter de l'intervalle de maintenance d'origine.
   4. Cliquez sur Reprogrammer.

   Vous pouvez également utiliser la boîte de dialogue Reprogrammer la maintenance à venir pour que Memorystore for Valkey effectue immédiatement la maintenance sur l'instance. Dans cette boîte de dialogue, sélectionnez Mettre à jour maintenant dans le menu Choisir une nouvelle heure, puis cliquez sur Mettre à jour maintenant.

gcloud

Pour reprogrammer la maintenance d'une instance, utilisez la gcloud memorystore instances reschedule-maintenance commande.

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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance
• PROJECT_ID : ID du projet ou numéro du Google Cloud projet qui contient l'instance
• REGION_ID : région où se trouve l'instance

• RESCHEDULE_TYPE : type de mise à jour reprogrammée. Les valeurs disponibles sont les suivantes :

  • IMMEDIATE : lance immédiatement la mise à jour de la maintenance.
  • SPECIFIC_TIME : permet de renseigner une heure spécifique pour la mise à jour. Cette heure ne doit pas dépasser 14 jours à compter de l'intervalle de maintenance d'origine.

• RESCHEDULE_TIME : date et heure auxquelles Memorystore for Valkey reprogramme la mise à jour de la maintenance.

  Remarque : Pour spécifier une valeur pour le paramètre RESCHEDULE_TIME, vous devez définir le paramètre RESCHEDULE_TYPE sur SPECIFIC_TIME. Cette valeur utilise la norme ISO 8601 (par exemple, 2025-02-16T16:56:00.000Z). L'heure est définie au format UTC.

Supprimer une stratégie de maintenance d'une instance

Si vous n'avez plus besoin d'une stratégie de maintenance pour une instance Memorystore for Valkey et que vous souhaitez utiliser le paramètre par défaut du service pour la maintenance , vous pouvez utiliser la Google Cloud console ou gcloud CLI pour supprimer la stratégie de l'instance.

Console

1. Dans la Google Cloud console, accédez à la Memorystore for Valkey page.

   Memorystore for Valkey

2. Cliquez sur l'instance pour laquelle vous souhaitez supprimer une stratégie de maintenance.

3. Sur la page Aperçu de l'instance, faites défiler la page jusqu'à ce que la fiche Maintenance s'affiche.

4. À côté du champ Intervalle de maintenance, cliquez sur Modifier ().

   Si aucun jour ni aucune heure ne s'affichent à côté du champ, cela signifie que vous avez déjà supprimé la stratégie de maintenance de l'instance.

5. Dans la boîte de dialogue Modifier l'intervalle de maintenance, procédez comme suit :

   1. Sélectionnez Par défaut.
   2. Cliquez sur Mettre à jour l'instance.

gcloud

Pour supprimer une stratégie de maintenance d'une instance, utilisez la gcloud memorystore instances update commande.

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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance à partir de laquelle vous souhaitez supprimer la stratégie de maintenance
• PROJECT_ID : ID du projet ou numéro du Google Cloud projet contenant l'instance
• REGION_ID : région où se trouve l'instance

Étape suivante

• Consultez les autorisations dont vous avez besoin pour gérer les intervalles de maintenance d'une instance Memorystore for Valkey.