Buscar y configurar períodos de mantenimiento

Memorystore for Valkey actualiza las instancias de forma rutinaria para garantizar que el servicio sea confiable, seguro, esté actualizado y tenga un buen rendimiento. Estas actualizaciones se denominan mantenimiento.

El servicio administra el mantenimiento por completo y está diseñado para no causar problemas de tiempo de inactividad. Sin embargo, además de que Memorystore para Valkey realiza el mantenimiento de tus instancias, puedes personalizar los programas de mantenimiento para que se alineen con las necesidades de tu aplicación y minimizar las interrupciones. Para personalizar tu programa de mantenimiento, puedes configurar períodos de mantenimiento para tus instancias.

En esta página, se proporcionan instrucciones para completar las siguientes tareas de personalización de períodos de mantenimiento:

• Crea una instancia con períodos de mantenimiento
• Cómo establecer un período de preferencia para el mantenimiento
• Activa las notificaciones de mantenimiento
• Cómo encontrar el mantenimiento programado
• Reprogramar el mantenimiento
• Quita una política de mantenimiento de una instancia

Para obtener una descripción general de las actualizaciones y los períodos de mantenimiento, consulta Acerca del mantenimiento.

Crea una instancia con períodos de mantenimiento

Puedes crear una instancia de Memorystore para Valkey con períodos de mantenimiento usando la CLI de gcloud.

Importante: Antes de seguir los pasos de esta sección, completa los pasos de las secciones Antes de comenzar y Configura la red.

gcloud

Para crear una instancia con períodos de mantenimiento, usa el 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

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia de Memorystore for Valkey que creas. El ID de instancia debe tener entre 1 y 63 caracteres, y solo debe usar letras minúsculas, números o guiones. Debe comenzar con una letra minúscula y terminar con una letra minúscula o un número.

• PROJECT_ID: Es el ID del proyecto o número del proyecto Google Cloud en el que deseas crear la instancia.

• REGION_ID: Es la región en la que deseas que se ubique la instancia.

  Nota: Solo puedes crear instancias en las regiones compatibles con Memorystore para Valkey.

• NETWORK_ID: Es el ID de la red que deseas usar para crear la instancia.

• SHARD_COUNT: Es la cantidad de fragmentos en la instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de instancias. Para obtener más información sobre las especificaciones de instancias, consulta Especificaciones de instancias y nodos.

• DAY: Es el día en el que deseas que se realice el mantenimiento. Los valores aceptables son
  MONDAY a SUNDAY.

• HOUR: Es la hora del día (en hora UTC) en que comienza el período de mantenimiento. Los valores aceptables son 0 a 23.

Por ejemplo:

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

De forma predeterminada, cuando creas una instancia con períodos de mantenimiento, se desactiva el cifrado en tránsito y la red autorizada es default.

Cómo establecer un período de mantenimiento preferido

Puedes configurar un período de mantenimiento para una instancia de Memorystore para Valkey con la CLI de gcloud.

gcloud

Para establecer un período de mantenimiento para una instancia, usa el 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

Realiza los siguientes reemplazos:

• INSTANCE_ID: el ID de la instancia
• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud proyecto que contiene la instancia.
• REGION_ID: Es la región en la que se encuentra la instancia.
• DAY: Es el día en el que deseas que se realice el mantenimiento. Los valores aceptables son
  MONDAY a SUNDAY.
• HOUR: Es la hora del día (en hora UTC) en que comienza el período de mantenimiento. Los valores aceptables son 0 a 23.

Activa las notificaciones de mantenimiento

Puedes activar las notificaciones de mantenimiento para una instancia de Memorystore para Valkey con la consola de Google Cloud .

Nota: Incluso si activas las notificaciones de mantenimiento, no las recibirás, a menos que establezcas un período de mantenimiento para la instancia.

1. En la consola de Google Cloud , ve a la página Comunicación.

   Comunicación

2. Haz clic en Notificaciones de productos.

3. En el menú, selecciona tu proyecto Google Cloud .

4. En la fila de Memorystore, activa el botón de correo electrónico en ACTIVADO.

Un correo electrónico de notificación de mantenimiento usa este título: "Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]". Cada dirección de correo electrónico que necesite recibir notificaciones debe habilitar la opción por separado.

Las notificaciones de mantenimiento se establecen a nivel de proyecto y no a nivel de instancia. Memorystore para Valkey envía notificaciones a la dirección de correo electrónico asociada con tu Cuenta de Google. No puedes configurar un alias de correo electrónico personalizado (por ejemplo, un alias de correo electrónico del equipo).

Cómo encontrar el mantenimiento programado

Si se programa mantenimiento para una instancia de Memorystore para Valkey, puedes ver el mantenimiento programado con la CLI de gcloud.

gcloud

Para encontrar el mantenimiento programado para una instancia, usa el comando gcloud memorystore instances describe.

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

Realiza los siguientes reemplazos:

• INSTANCE_ID: El ID de la instancia
• PROJECT_ID: Es el ID o número del proyecto de Google Cloud proyecto que contiene la instancia.
• REGION_ID: Es la región en la que se encuentra la instancia.

El resultado del mantenimiento programado es el siguiente:

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'

Aquí:

• maintenancePolicy muestra información sobre la fecha y hora de creación de la política de mantenimiento preferida.
  • DAY es el día de la semana en el que se realiza el mantenimiento.
  • HOUR es la hora (en hora UTC) en la que comienza el mantenimiento.
• maintenanceSchedule muestra información sobre el mantenimiento programado de la instancia.
  • END_DATE_AND_TIME_STAMP indica cuándo finaliza una actualización de mantenimiento programada para la instancia.
  • SCHEDULED_DATE_AND_TIME_STAMP indica cuándo se programó la finalización de una actualización de mantenimiento para la instancia.
  • START_DATE_AND_TIME_STAMP indica cuándo comienza una actualización de mantenimiento programada para la instancia.

Reprogramar mantenimiento

Puedes usar la CLI de gcloud para reprogramar el mantenimiento de una instancia de Memorystore para Valkey. Como resultado, puedes diferir una actualización de mantenimiento hasta dos semanas desde el momento en que se programó originalmente la actualización para la instancia.

Precaución: Si bien Memorystore para Valkey no te brinda la opción de reprogramar el mantenimiento de varias instancias a la vez, puedes reprogramar el mantenimiento de forma masiva mediante programación. Si reprogramas de forma masiva, agrupa tus operaciones en solicitudes del tamaño adecuado. Te recomendamos que limites el tamaño del lote a 100 instancias y esperes un tiempo suficiente entre las solicitudes. De lo contrario, es posible que no se reprogramen los eventos. Para obtener más información, consulta Mantenimiento programado.

gcloud

Para reprogramar el mantenimiento de una instancia, usa el 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]

Realiza los siguientes reemplazos:

• INSTANCE_ID: el ID de la instancia
• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud proyecto que contiene la instancia.
• REGION_ID: Es la región en la que se encuentra la instancia.

• RESCHEDULE_TYPE: Es el tipo de actualización reprogramada. Los valores disponibles son los siguientes:

  • IMMEDIATE: Inicia la actualización de mantenimiento de inmediato.
  • SPECIFIC_TIME: Designa una hora específica para la actualización. Este tiempo no debe superar los 14 días desde el momento del período de mantenimiento original.

• RESCHEDULE_TIME: Es la fecha y hora en que Memorystore for Valkey reprograma la actualización de mantenimiento.

  Nota: Para especificar un valor para el parámetro RESCHEDULE_TIME, debes establecer el parámetro RESCHEDULE_TYPE en SPECIFIC_TIME. Este valor usa el estándar ISO 8601 (por ejemplo, 2025-02-16T16:56:00.000Z). La hora se establece en hora UTC.

Quita una política de mantenimiento de una instancia

Si ya no necesitas una política de mantenimiento para una instancia de Memorystore para Valkey y, en cambio, quieres usar la configuración predeterminada del servicio para el mantenimiento, puedes usar la CLI de gcloud para quitar la política de la instancia.

gcloud

Para quitar una política de mantenimiento de una instancia, usa el comando gcloud memorystore instances update.

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

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia de la que deseas quitar la política de mantenimiento.
• PROJECT_ID: Es el ID del proyecto o número del Google Cloud proyecto que contiene la instancia.
• REGION_ID: Es la región en la que se encuentra la instancia.

¿Qué sigue?

• Consulta los permisos necesarios para administrar los períodos de mantenimiento de una instancia de Memorystore para Valkey.