Localizar e definir janelas de manutenção

O Memorystore para Valkey atualiza as instâncias rotineiramente fazendo manutenção nelas para garantir que o serviço seja confiável, tenha alto desempenho, seja seguro, esteja atualizado e tenha um impacto de tempo de inatividade zero. 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 as interrupções. Para personalizar seus programas de manutenção, configure janelas de manutenção para suas instâncias.

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

Para uma visão geral das atualizações e 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 o console Google Cloud ou a CLI gcloud.

Console

Para criar uma instância com janelas de manutenção, consulte Criar instâncias.

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 Google Cloud projeto em que você quer criar a instância.

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

  • 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 o console do Google Cloud ou a CLI gcloud.

Console

  1. No console Google Cloud , acesse a página Memorystore para Valkey.

    Memorystore for Valkey

  2. Clique na instância em que você quer definir uma janela preferencial.

  3. Na página Resumo da instância, role a tela até que o card Manutenção apareça.

  4. Ao lado do campo Janela de manutenção, clique em Editar ().

    Se um dia e um horário aparecerem ao lado do campo, significa que você já definiu a janela de manutenção para a instância.

  5. Na caixa de diálogo Editar janela de manutenção, faça o seguinte:

    1. Selecione Personalizado.
    2. No menu Dia, selecione o dia em que você quer que a manutenção seja realizada.
    3. No menu Horário, selecione a hora em que você quer que a janela de manutenção comece.
    4. Clique em Atualizar instância.

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 Google Cloud projeto 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

Se você programar a manutenção de uma instância do Memorystore para Valkey, poderá usar o console Google Cloud para ativar as notificações de manutenção da instância.

  1. No console Google Cloud , acesse a página Memorystore para Valkey.

    Memorystore for Valkey

  2. Clique na instância para ativar as notificações de manutenção.

  3. Na página Resumo da instância, role a tela até que o card Manutenção apareça.

  4. Clique em Editar preferências de notificação.

    Se esse link estiver desativado, significa que você não agendou a manutenção da instância.

  5. Clique em Notificações de produtos.

  6. No menu, selecione seu projeto Google Cloud .

  7. 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 for 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 você programar uma manutenção para uma instância do Memorystore para Valkey, poderá conferir a manutenção usando o Google Cloud console ou a CLI gcloud.

Console

  1. No console Google Cloud , acesse a página Memorystore para Valkey.

    Memorystore for Valkey

  2. Clique na instância em que você quer encontrar a manutenção programada.

  3. Na página Resumo da instância, role a tela até que o card Manutenção apareça.

    Ao lado do campo Janela de manutenção, aparecem o dia e a hora da manutenção programada.

gcloud

Para encontrar a manutenção programada de 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 do projeto ou número 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.
  • weeklyMaintenanceWindow mostra informações sobre a janela de manutenção semanal da instância.
    • 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 o Google Cloud console ou a CLI gcloud 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.

Console

  1. No console Google Cloud , acesse a página Memorystore para Valkey.

    Memorystore for Valkey

  2. Clique na instância em que você quer reprogramar a manutenção.

  3. Na página Resumo da instância, role a tela até que o card Manutenção apareça.

  4. Ao lado do campo Próxima manutenção, clique em Editar ().

    Se o status Nenhuma manutenção programada agora aparecer ao lado desse campo, significa que não há manutenção programada para a instância.

  5. Na caixa de diálogo Reprogramar manutenção futura, faça o seguinte:

    1. No menu Escolher um novo horário, selecione Horário específico.
    2. No campo Data, clique em Calendário () e selecione a data em que você quer que a manutenção seja realizada.
    3. No menu Hora, defina um horário específico para a atualização. Esse período não pode ser superior a 14 dias a partir do momento da janela de manutenção original.
    4. Clique em Remarcar.

    Você também pode usar a caixa de diálogo Reprogramar a manutenção futura para que o Memorystore for Valkey faça a manutenção na instância imediatamente. Na caixa de diálogo, selecione Atualizar agora no menu Escolher um novo horário e clique em Atualizar agora.

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 do projeto ou número 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 horário da janela de manutenção original.

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

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, use o Google Cloud console ou a CLI gcloud para remover a política da instância.

Console

  1. No console Google Cloud , acesse a página Memorystore para Valkey.

    Memorystore for Valkey

  2. Clique na instância em que você quer remover uma política de manutenção.

  3. Na página Resumo da instância, role a tela até que o card Manutenção apareça.

  4. Ao lado do campo Janela de manutenção, clique em Editar ().

    Se um dia e horário não aparecerem ao lado do campo, isso significa que você já removeu a política de manutenção da instância.

  5. Na caixa de diálogo Editar janela de manutenção, faça o seguinte:

    1. Selecione Padrão.
    2. Clique em Atualizar 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 Google Cloud projeto 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 para Valkey.