Buscar y definir ventanas de mantenimiento

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

El servicio gestiona el mantenimiento por completo y está diseñado para que no afecte al tiempo de inactividad. Sin embargo, además de que Memorystore para Valkey realice tareas de mantenimiento en tus instancias, puedes personalizar las programaciones de mantenimiento para que se ajusten a las necesidades de tu aplicación y minimizar las interrupciones. Para personalizar tu programación de mantenimiento, puedes configurar ventanas de mantenimiento para tus instancias.

En esta página se proporcionan instrucciones sobre cómo completar las siguientes tareas para personalizar las ventanas de mantenimiento:

• Crear una instancia con ventanas de mantenimiento
• Definir una ventana de mantenimiento preferida
• Activar las notificaciones de mantenimiento
• Buscar mantenimiento programado
• Reprogramar el mantenimiento
• Quitar una política de mantenimiento de una instancia

Para obtener información general sobre las actualizaciones de mantenimiento y las ventanas de mantenimiento, consulta el artículo Acerca del mantenimiento.

Crear una instancia con ventanas de mantenimiento

Puedes crear una instancia de Memorystore for Valkey con ventanas de mantenimiento mediante la CLI de gcloud.

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

gcloud

Para crear una instancia con ventanas 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

Haz las siguientes sustituciones:

• INSTANCE_ID: el ID de la instancia de Memorystore para Valkey que vas a crear. El ID de instancia debe tener entre 1 y 63 caracteres y solo puede incluir letras minúsculas, números o guiones. Debe empezar por una letra minúscula y terminar por una letra minúscula o un número.

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

• REGION_ID: la región en la que quieres que se encuentre la instancia.

  Nota: Solo puedes crear instancias en las regiones admitidas de Memorystore para Valkey.

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

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

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

• HOUR: la hora del día (en horario UTC) en la que empieza la ventana de mantenimiento. Los valores aceptables son 0-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 ventanas de mantenimiento, el cifrado en tránsito se desactiva y la red autorizada es default.

Definir una ventana preferida para el mantenimiento

Puedes definir una ventana de mantenimiento para una instancia de Memorystore for Valkey mediante la CLI de gcloud.

gcloud

Para definir una ventana 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

Haz las siguientes sustituciones:

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

Activar las notificaciones de mantenimiento

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

Nota: Aunque actives las notificaciones de mantenimiento, no recibirás ninguna a menos que configures una ventana de mantenimiento para la instancia.

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

   Comunicación

2. Haz clic en Notificaciones de productos.

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

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

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

Las notificaciones de mantenimiento se definen a nivel de proyecto, no en las instancias. Memorystore para Valkey envía notificaciones a la dirección de correo asociada a tu cuenta de Google. No puedes configurar un alias de correo personalizado (por ejemplo, un alias de correo de equipo).

Buscar mantenimiento programado

Si se ha programado un mantenimiento para una instancia de Memorystore for Valkey, puedes verlo con la CLI de gcloud.

gcloud

Para buscar el mantenimiento programado de una instancia, usa el comando gcloud memorystore instances describe.

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

Haz las siguientes sustituciones:

• INSTANCE_ID: el ID de la instancia
• PROJECT_ID: el ID o el número del Google Cloud proyecto que contiene la instancia
• REGION_ID: 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'

Donde:

• maintenancePolicy muestra información sobre la 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 horario 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 de la instancia.
  • SCHEDULED_DATE_AND_TIME_STAMP indica cuándo se ha programado que se complete una actualización de mantenimiento de la instancia.
  • START_DATE_AND_TIME_STAMP indica cuándo comienza una actualización de mantenimiento programada para la instancia.

Reprogramar el mantenimiento

Puedes usar la CLI de gcloud para reprogramar el mantenimiento de una instancia de Memorystore for Valkey. Por lo tanto, puedes aplazar una actualización de mantenimiento hasta dos semanas después de la fecha programada originalmente para la instancia.

Precaución: Aunque Memorystore para Valkey no te ofrece 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 en bloque, agrupa tus operaciones en solicitudes del tamaño adecuado. Te recomendamos que limites el tamaño del lote a 100 instancias y que esperes un tiempo suficiente entre solicitudes. De lo contrario, es posible que no hayas podido reprogramar 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]

Haz las siguientes sustituciones:

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

• RESCHEDULE_TYPE: el tipo de actualización reprogramada. Valores disponibles:

  • IMMEDIATE: inicia la actualización de mantenimiento inmediatamente.
  • SPECIFIC_TIME: designar una hora específica para la actualización. Este periodo no debe superar los 14 días desde el momento de la ventana de mantenimiento original.

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

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

Quitar 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 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

Haz las siguientes sustituciones:

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

Siguientes pasos

• Consulta los permisos necesarios para gestionar las ventanas de mantenimiento de una instancia de Memorystore for Valkey.