Rechercher et définir des intervalles de maintenance

Memorystore for Valkey met régulièrement à jour les instances pour s'assurer que le service est fiable, performant, sécurisé et à jour. Ces mises à jour sont appelées maintenances.

La maintenance est entièrement gérée par le service et est conçue pour ne pas avoir d'impact sur le temps d'arrêt. Toutefois, en plus de la maintenance effectuée par Memorystore pour Valkey sur vos instances, vous pouvez personnaliser les plannings de maintenance pour les adapter aux besoins de votre application et minimiser les interruptions. Pour personnaliser votre calendrier 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 de maintenance souhaité
• Activer les notifications de maintenance
• Rechercher une maintenance planifiée
• Reprogrammer la maintenance
• Supprimer une règle de maintenance d'une instance

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

Créer une instance avec des intervalles de maintenance

Vous pouvez créer une instance Memorystore pour Valkey avec des intervalles de maintenance à l'aide de la 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.

gcloud

Pour créer une instance avec des périodes de maintenance, utilisez la commande 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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance Memorystore for Valkey que vous créez. L'ID d'instance doit comporter entre 1 et 63 caractères, et ne doit 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 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 pour Valkey.

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

• SHARD_COUNT : nombre de partitions dans l'instance. Le nombre de segments détermine la capacité de mémoire totale pour stocker les données d'instance. Pour en savoir plus sur les spécifications des instances, consultez 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 de la journée (au format UTC) à laquelle l'intervalle de maintenance commence. Les valeurs acceptées sont comprises entre 0 et 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 périodes de maintenance, le chiffrement en transit est désactivé et le réseau autorisé est default.

Définir un intervalle souhaité pour les opérations de maintenance

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

gcloud

Pour définir un intervalle de maintenance pour une instance, utilisez la commande 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

Effectuez les remplacements suivants :

• INSTANCE_ID : ID de l'instance
• PROJECT_ID : ID ou numéro du projet Google Cloud 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 de la journée (au format UTC) à laquelle l'intervalle de maintenance commence. Les valeurs acceptées sont comprises entre 0 et 23.

Activer les notifications de maintenance

Vous pouvez activer les notifications de maintenance pour une instance Memorystore pour Valkey à l'aide de la console Google Cloud .

Remarque : Même si vous activez les notifications de maintenance, vous ne recevez des notifications que si vous définissez un intervalle de maintenance pour l'instance.

1. Dans la console Google Cloud , accédez à la page Communication.

   Communication

2. Cliquez sur Notifications concernant les produits.

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

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

Un e-mail de notification de maintenance utilise l'intitulé "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.

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

Rechercher une maintenance planifiée

Si une maintenance est programmée pour une instance Memorystore pour Valkey, vous pouvez l'afficher à l'aide de la gcloud CLI.

gcloud

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

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 ou numéro du projet Google Cloud contenant l'instance
• 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 la date de création de la stratégie de maintenance à privilégier.
  • DAY est le jour de la semaine où la maintenance est effectuée.
  • HOUR est l'heure (au format UTC) à laquelle la maintenance commence.
• maintenanceSchedule affiche des informations sur la maintenance programmée de 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 de fin prévue d'une mise à jour de maintenance 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 CLI gcloud pour reprogrammer la maintenance d'une instance Memorystore pour Valkey. Par conséquent, vous pouvez reporter une mise à jour de maintenance pour un délai d'au plus deux semaines à compter de la programmation initiale de la mise à jour pour l'instance.

Attention : Bien que Memorystore pour 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 des événements de manière groupée, regroupez vos opérations dans des requêtes de taille appropriée. Nous vous recommandons de limiter la taille du lot à 100 instances et d'attendre suffisamment longtemps entre les requêtes. Sinon, il est possible que vous n'ayez pas réussi à reprogrammer des événements. Pour en savoir plus, consultez Maintenance programmée.

gcloud

Pour reprogrammer la maintenance d'une instance, utilisez la commande 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]

Effectuez les remplacements suivants :

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

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

  • IMMEDIATE : lancez immédiatement la mise à jour de 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 pour Valkey reprogramme la mise à jour de 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 en heure UTC.

Supprimer une règle de maintenance d'une instance

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

gcloud

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

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 règle de maintenance
• PROJECT_ID : ID ou numéro du Google Cloud projet contenant l'instance
• REGION_ID : région où se trouve l'instance

Étapes suivantes

• Consultez les autorisations requises pour gérer les intervalles de maintenance d'une instance Memorystore pour Valkey.