Localizar e definir janelas de manutenção

O Memorystore para Valkey atualiza as instâncias rotineiramente realizando manutenção nelas para garantir que o serviço seja confiável, eficiente, seguro, atualizado e tenha um impacto de tempo de inatividade zero. Além de o Memorystore para Valkey realizar manutenção nas suas instâncias, é possível personalizar os programações de manutenção para se alinhar às necessidades do seu aplicativo e minimizar as interrupções. Para personalizar as programações 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 para 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 gcloud CLI.

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

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 console do Google Cloud 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 Horário, designe um horário específico para a atualização. Esse horário não pode ser mais de 14 dias a partir do horário da janela de manutenção original.
    4. Clique em Remarcar.

    Você também pode usar a caixa de diálogo Reprogramar a próxima manutenção 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: designe um horário específico para a atualização. Esse horário 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 console do Google Cloud 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.