Encontre e defina períodos de manutenção

O Memorystore for Valkey atualiza as instâncias de forma rotineira para garantir que o serviço é fiável, tem um bom desempenho, é seguro e está atualizado. Estas atualizações são denominadas manutenção.

A manutenção é totalmente gerida pelo serviço e foi concebida para não ter impacto no tempo de inatividade. No entanto, além de o Memorystore for Valkey realizar a manutenção nas suas instâncias, pode personalizar os agendamentos de manutenção para se alinharem com as necessidades da sua aplicação e minimizar as interrupções. Para personalizar a sua programação de manutenção, pode configurar períodos de manutenção para as suas instâncias.

Esta página contém instruções sobre como concluir as seguintes tarefas para personalizar os períodos de manutenção:

• Crie uma instância com janelas de manutenção
• Defina um período preferencial para manutenção
• Ative as notificações de manutenção
• Encontre a manutenção agendada
• Reagende a manutenção
• Remova uma política de manutenção de uma instância

Para uma vista geral das atualizações de manutenção e dos períodos de manutenção, consulte o artigo Acerca da manutenção.

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

Pode criar uma instância do Memorystore for Valkey com períodos de manutenção através da CLI gcloud.

Importante: antes de seguir os passos nesta secção, conclua os passos nas secçõ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 está a criar. O ID da instância tem de ter entre 1 e 63 carateres e usar apenas letras minúsculas, números ou hífenes. Tem de começar com uma letra minúscula e terminar com uma letra minúscula ou um número.

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

• REGION_ID: a região onde quer que a instância esteja localizada.

  Nota: só pode criar instâncias nas regiões suportadas para o Memorystore for Valkey.

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

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

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

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

Por 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 predefinição, quando cria uma instância com períodos de manutenção, a encriptação em trânsito é desativada e a rede autorizada é default.

Defina um período preferencial para manutenção

Pode definir um período de manutenção para uma instância do Memorystore for Valkey através da CLI gcloud.

gcloud

Para definir um período 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 ou o número do Google Cloud projeto que contém a instância.
• REGION_ID: a região onde a instância está localizada.
• DAY: o dia em que quer que a manutenção ocorra. Os valores aceitáveis são
  MONDAY a SUNDAY.
• HOUR: a hora do dia (em UTC) em que a janela de manutenção começa. Os valores aceitáveis são 0 a 23.

Ative as notificações de manutenção

Pode ativar as notificações de manutenção para uma instância do Memorystore for Valkey através da Google Cloud consola.

Nota: mesmo que ative as notificações de manutenção, não recebe notificações, a menos que defina um período de manutenção para a instância.

1. Na Google Cloud consola, aceda à página Comunicação.

   Comunicação

2. Clique em Notificações de produtos.

3. No menu, selecione o seu Google Cloud projeto.

4. Na linha do Memorystore, ative o botão de email ON.

Um email de notificação de manutenção usa este título: "Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]". Cada endereço de email que precisa de receber notificações tem de ativar esta opção separadamente.

As notificações de manutenção são definidas ao nível do projeto e não nas instâncias. O Memorystore for Valkey envia notificações para o endereço de email associado à sua Conta Google. Não pode configurar um alias do email personalizado (por exemplo, um alias do email de uma equipa).

Encontre manutenção agendada

Se a manutenção estiver agendada para uma instância do Memorystore for Valkey, pode ver a manutenção agendada através da CLI gcloud.

gcloud

Para encontrar a manutenção agendada 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 o número do projeto do Google Cloud projeto que contém a instância
• REGION_ID: a região onde a instância está localizada

A saída para a manutenção agendada é 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'

Onde:

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

Reagendar manutenção

Pode usar a CLI gcloud para reagendar a manutenção de uma instância do Memorystore for Valkey. Como resultado, pode adiar uma atualização de manutenção até duas semanas a partir da data original agendada para a instância.

Atenção: embora o Memorystore for Valkey não lhe ofereça a opção de reagendar a manutenção para várias instâncias em simultâneo, pode reagendar a manutenção em massa através de programação. Se reagendar em massa, agrupe as operações em pedidos de tamanho adequado. Recomendamos que limite o tamanho do lote a 100 instâncias e aguarde um período de tempo suficiente entre os pedidos. Caso contrário, pode ter falhado o reagendamento de eventos. Para mais informações, consulte o artigo 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 o número do projeto do Google Cloud projeto que contém a instância.
• REGION_ID: a região onde a instância está localizada.

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

  • IMMEDIATE: iniciar a atualização de manutenção imediatamente.
  • SPECIFIC_TIME: designar uma hora específica para a atualização. Este período não pode ser superior a 14 dias a partir do período de manutenção original.

• RESCHEDULE_TIME: a data e a hora em que o Memorystore for Valkey agenda novamente a atualização de manutenção.

  Nota: para especificar um valor para o parâmetro RESCHEDULE_TIME, tem de definir o parâmetro RESCHEDULE_TYPE como SPECIFIC_TIME. Este valor usa a norma ISO 8601 (por exemplo, 2025-02-16T16:56:00.000Z). A hora é definida na hora UTC.

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

Se já não precisar de uma política de manutenção para uma instância do Memorystore for Valkey e quiser usar a predefinição do serviço para manutenção, pode usar 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 da qual quer remover a política de manutenção
• PROJECT_ID: o ID ou o número do projeto Google Cloud que contém a instância
• REGION_ID: a região onde a instância está localizada

O que se segue?

• Veja as autorizações necessárias para gerir janelas de manutenção para uma instância do Memorystore for Valkey.