Localizar e definir janelas de manutenção

O Memorystore for Redis Cluster atualiza os clusters rotineiramente para garantir que o serviço seja confiável, eficiente, seguro e 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 de o Memorystore para Redis Cluster realizar manutenção nos seus clusters, é possível personalizar os programações de manutenção para alinhar com as necessidades do seu aplicativo e minimizar interrupções. Para personalizar sua programação de manutenção, configure janelas de manutenção para seus clusters.

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

• Criar um cluster 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

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

Criar um cluster com janelas de manutenção

É possível criar um cluster no Memorystore para Redis Cluster 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 um cluster com janelas de manutenção, use o comando gcloud redis clusters create:

gcloud redis clusters create CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--network=NETWORK \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--maintenance-window-day=MAINTENANCE_WINDOW_DAY \
--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster que você está criando. O ID do cluster 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 o número do Google Cloud projeto em que você quer criar o cluster.

• REGION_ID: a região em que você quer que o cluster esteja localizado.

  Observação: só é possível criar clusters nas regiões compatíveis com o Memorystore para Redis Cluster.

• NETWORK: a rede que você quer usar para criar o cluster. Ele precisa usar este formato: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. O NETWORK_ID usado aqui precisa corresponder ao ID da rede que a política de conexão de serviço usa. Caso contrário, não será possível criar o cluster.

• REPLICA_COUNT: o número de réplicas (por fragmento). Os valores aceitos são 0-5.

• NODE_TYPE: o tipo de nó do cluster. Os valores aceitos são:

  • redis-shared-core-nano
  • redis-standard-small
  • redis-highmem-medium
  • redis-highmem-xlarge
  Atenção: recomendamos usar o tipo de nó redis-shared-core-nano apenas para fins de desenvolvimento ou teste, porque ele não tem um SLA. Se você executar o Memorystore para Redis Cluster em um ambiente de produção, recomendamos usar os tipos de nós redis-standard-small, redis-highmem-medium ou redis-highmem-xlarge. Para mais informações sobre esses tipos de nó, consulte Escolher um tipo de nó.

• SHARD_COUNT: o número de fragmentos no cluster. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster. Para mais informações sobre as especificações do cluster, consulte Especificação de cluster e nó.

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

• MAINTENANCE_WINDOW_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 redis clusters my-cluster \
--project=my-project \
--region=us-central1 \
--network=projects/my-network-project/global/networks/default \
--replica-count=2 \
--node-type=redis-highmem-medium \
--shard-count=8 \
--maintenance-window-day=MONDAY \
--maintenance-window-hour=9

Por padrão, quando você cria um cluster 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 um cluster no Memorystore para Redis Cluster usando a gcloud CLI.

gcloud

Para definir uma janela de manutenção para um cluster, use o comando gcloud redis clusters update:

gcloud redis clusters update CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--maintenance-window-day=DAY
--maintenance-window-hour=HOUR

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster.
• PROJECT_ID: o ID ou número do projeto Google Cloud que contém o cluster.
• REGION_ID: a região em que o cluster está localizado.
• 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 de um cluster no Memorystore para Redis Cluster usando o console 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 o cluster.

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 cluster [your-cluster-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 nos clusters. O Memorystore for Redis Cluster 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 você programar uma manutenção para um cluster no Memorystore para Redis Cluster, poderá conferir a manutenção usando a CLI gcloud.

gcloud

Para encontrar a manutenção programada de um cluster, use o comando gcloud redis clusters describe.

gcloud redis clusters describe CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster
• PROJECT_ID: o ID ou o número do projeto Google Cloud que contém o cluster
• REGION_ID: a região em que o cluster está localizado.

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

maintenancePolicy:
createTime: 'CREATE_DATE_AND_TIME_STAMP'
updateTime: 'UPDATE_DATE_AND_TIME_STAMP'
maintenanceWindow:
- day: DAY
  duration: 60 minutes
  hour: HOUR
maintenanceSchedule:
 endTime: 'END_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 e a última vez em que a política foi atualizada.
  • CREATE_DATE_AND_TIME_STAMP é quando a política de manutenção é criada pela primeira vez.
  • UPDATE_DATE_AND_TIME_STAMP é a data da última atualização da política de manutenção.
• maintenanceWindow mostra informações sobre a janela de manutenção do cluster.
  • 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 do cluster.
  • END_DATE_AND_TIME_STAMP indica quando uma atualização de manutenção programada termina para o cluster.
  • START_DATE_AND_TIME_STAMP indica quando uma atualização de manutenção programada começa para o cluster.

Reprogramar manutenção

Use a gcloud CLI para reagendar a manutenção de um cluster no Memorystore para Redis Cluster. Como resultado, é possível adiar uma atualização de manutenção por até duas semanas a partir do momento em que ela está programada originalmente para o cluster.

Atenção: o Memorystore para Redis Cluster não é compatível com o reagendamento programático de solicitações de manutenção em massa. Recomendamos limitar o tamanho do lote a 100 clusters e aguardar um tempo suficiente entre as solicitações. Caso contrário, talvez você tenha falhado ao reagendar eventos. Para mais informações, consulte Como reprogramar a manutenção.

gcloud

Para reagendar a manutenção de um cluster, use o comando gcloud redis clusters reschedule-maintenance.

gcloud redis clusters reschedule-maintenance CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESHEDULE_TIME]

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster.
• PROJECT_ID: o ID do projeto ou o número do projeto Google Cloud que contém o cluster.
• REGION_ID: a região em que o cluster está localizado.

• 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 for Redis Cluster 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.

A seguir

• Confira as permissões necessárias para gerenciar janelas de manutenção de um cluster no Memorystore para Redis Cluster.