Localizar e definir janelas de manutenção

O Memorystore for Valkey atualiza as instâncias rotineiramente para garantir que o serviço seja confiável, tenha alto desempenho, seja seguro e esteja atualizado. Essas atualizações são chamadas de manutenção.

A manutenção é totalmente gerenciada pelo serviço e foi projetada para não ter impacto de inatividade. No entanto, além da manutenção realizada pelo Memorystore para Valkey nas suas instâncias, é possível personalizar os programações de manutenção para se alinhar às necessidades do aplicativo e minimizar interrupções. Para personalizar sua programação de manutenção, configure janelas de manutenção para suas instâncias.

Nesta página, você encontra instruções sobre como concluir as seguintes tarefas para personalizar janelas de manutenção:

• Criar uma instância com janelas de manutenção
• Definir uma janela preferencial para manutenção
• Ativar as notificações de manutenção
• Encontrar a manutenção programada
• Remarcar manutenção
• Remover uma política de manutenção de uma instância

Para uma visão geral das janelas e das janelas de manutenção, consulte Sobre a manutenção.

Criar uma instância com janelas de manutenção

É possível criar uma instância do Memorystore para Valkey com janelas de manutenção usando a gcloud CLI.

Importante: antes de seguir as etapas desta seção, conclua as etapas nas seções Antes de começar e Configurar rede.

gcloud

Para criar uma instância com janelas de manutenção, use o 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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância do Memorystore for Valkey que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.

• PROJECT_ID: o ID do projeto ou número do projeto Google Cloud em que você quer criar a instância.

• REGION_ID: a região em que você quer que a instância esteja localizada.

  Observação: só é possível criar instâncias nas regiões compatíveis do Memorystore para Valkey.

• NETWORK_ID: o ID da rede que você quer usar para criar a instância.

• SHARD_COUNT: o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instâncias. Para mais informações sobre especificações de instância, consulte Especificação de instância e nó.

• DAY: o dia em que você quer que a manutenção ocorra. Os valores aceitáveis são
  MONDAY - SUNDAY.

• HOUR: a hora do dia (em UTC) em que a janela de manutenção começa. Os valores aceitáveis são 0 - 23.

Exemplo:

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

Por padrão, quando você cria uma instância com janelas de manutenção, a criptografia em trânsito é desativada e a rede autorizada é default.

Definir uma janela preferencial para manutenção

É possível definir uma janela de manutenção para uma instância do Memorystore para Valkey usando a gcloud CLI.

gcloud

Para definir uma janela de manutenção para uma instância, use o 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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância.
• PROJECT_ID: o ID do projeto ou número do projeto Google Cloud que contém a instância.
• REGION_ID: a região em que a instância está localizada.
• DAY: o dia em que você quer que a manutenção ocorra. Os valores aceitáveis são
  MONDAY - SUNDAY.
• HOUR: a hora do dia (em UTC) em que a janela de manutenção começa. Os valores aceitáveis são 0 - 23.

Ativar notificações de manutenção

É possível ativar as notificações de manutenção para uma instância do Memorystore para Valkey usando o console do Google Cloud .

Observação: mesmo que você ative as notificações de manutenção, não as receberá a menos que defina uma janela de manutenção para a instância.

1. No console do Google Cloud , acesse a página Comunicação.

   Comunicação

2. Clique em Notificações de produtos.

3. No menu, selecione seu projeto Google Cloud .

4. Na linha do Memorystore, alterne o botão de e-mail para ATIVADO.

Um e-mail de notificação de manutenção usa este título: "Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]". Cada endereço de e-mail que precisa receber notificações precisa ser ativado separadamente.

As notificações de manutenção são definidas no nível do projeto, e não nas instâncias. O Memorystore para Valkey envia notificações para o endereço de e-mail associado à sua Conta do Google. Não é possível configurar um alias de e-mail personalizado (por exemplo, um alias de e-mail de equipe).

Encontrar a manutenção programada

Se a manutenção estiver programada para uma instância do Memorystore para Valkey, será possível conferir a manutenção programada usando a CLI gcloud.

gcloud

Para encontrar a manutenção programada para uma instância, use o comando gcloud memorystore instances describe.

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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância
• PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância
• REGION_ID: a região em que a instância está localizada.

A saída para manutenção programada é a seguinte:

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'

Em que:

• maintenancePolicy mostra informações sobre o horário de criação da política de manutenção preferencial.
  • DAY é o dia da semana em que a manutenção ocorre.
  • HOUR é a hora (em UTC) em que a manutenção começa.
• maintenanceSchedule mostra informações sobre a manutenção programada para a instância.
  • END_DATE_AND_TIME_STAMP indica quando uma atualização de manutenção programada termina para a instância.
  • SCHEDULED_DATE_AND_TIME_STAMP indica quando uma atualização de manutenção está programada para ser concluída na instância.
  • START_DATE_AND_TIME_STAMP indica quando uma atualização de manutenção programada começa para a instância.

Reprogramar manutenção

É possível usar a gcloud CLI para reprogramar a manutenção de uma instância do Memorystore para Valkey. Como resultado, é possível adiar uma atualização de manutenção por até duas semanas a partir do momento em que ela é programada originalmente para a instância.

Atenção: embora o Memorystore para Valkey não ofereça a opção de reprogramar a manutenção de várias instâncias de uma só vez, é possível fazer isso em massa de forma programática. Se você reagendar em massa, agrupe as operações em solicitações de tamanho adequado. Recomendamos limitar o tamanho do lote a 100 instâncias e esperar um tempo razoável entre as solicitações. Caso contrário, talvez você não tenha conseguido reagendar eventos. Para mais informações, consulte Manutenção programada.

gcloud

Para reagendar a manutenção de uma instância, use o 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]

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância.
• PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância.
• REGION_ID: a região em que a instância está localizada.

• RESCHEDULE_TYPE: o tipo de atualização reagendada. Os valores disponíveis são:

  • IMMEDIATE: inicia a atualização de manutenção imediatamente.
  • SPECIFIC_TIME: designar um horário específico para a atualização. Esse tempo não pode ser superior a 14 dias a partir do momento da janela de manutenção original.

• RESCHEDULE_TIME: a data e a hora em que o Memorystore para Valkey reagenda a atualização de manutenção.

  Observação: para especificar um valor para o parâmetro RESCHEDULE_TIME, defina o parâmetro RESCHEDULE_TYPE como SPECIFIC_TIME. Esse valor usa o padrão ISO 8601 (por exemplo, 2025-02-16T16:56:00.000Z). O horário é definido em UTC.

Remover uma política de manutenção de uma instância

Se você não precisar mais de uma política de manutenção para uma instância do Memorystore para Valkey e quiser usar a configuração padrão do serviço para manutenção em vez disso, use a CLI gcloud para remover a política da instância.

gcloud

Para remover uma política de manutenção de uma instância, use o comando gcloud memorystore instances update.

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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância de que você quer remover a política de manutenção.
• PROJECT_ID: o ID do projeto ou número do projeto Google Cloud que contém a instância
• REGION_ID: a região em que a instância está localizada.

A seguir

• Confira as permissões necessárias para gerenciar janelas de manutenção de uma instância do Memorystore for Valkey.