Conferir e definir os horários de manutenção

Nesta página, mostramos como realizar as seguintes ações relacionadas à manutenção de clusters do AlloyDB para PostgreSQL:

  • Defina, visualize e limpe uma janela de manutenção para o cluster principal e secundário.
  • Confira os próximos eventos de manutenção programados para o cluster principal e secundário.

Para saber como a manutenção funciona com clusters do AlloyDB, consulte Sobre a manutenção.

Definir uma janela de manutenção em um cluster

Console

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.

  3. Na página Visão geral, em Manutenção, clique em Editar.

  4. Em Janela de manutenção, selecione o dia da semana para essa janela.

    A opção padrão é Qualquer janela. Quando você cria um cluster, ele recebe essa janela de manutenção padrão.

  5. Selecione o horário da janela de manutenção.

  6. Clique em Atualizar para salvar as mudanças.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a CLI do Google Cloud ou usar o Cloud Shell.

Para definir uma janela de manutenção em um cluster, execute o comando gcloud clusters update com as flags --maintenance-window-day e --maintenance-window-hour:

gcloud alloydb clusters update CLUSTER_ID \
  --region REGION \
  --maintenance-window-day DAY_OF_WEEK \
  --maintenance-window-hour HOUR_OF_DAY

Substitua:

  • CLUSTER_ID: o cluster em que a janela de manutenção será definida.

  • REGION: a Google Cloud região em que o cluster está localizado, por exemplo, us-central1.

  • DAY_OF_WEEK: o dia da semana, no fuso horário UTC, para esta janela de manutenção. Os valores válidos são MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY e SUNDAY.

    O valor padrão é Qualquer janela. Quando você cria um cluster, ele recebe essa janela de manutenção padrão.

  • HOUR_OF_DAY: um número inteiro entre 0 e 23 que representa a hora do dia, no fuso horário UTC, para essa janela de manutenção.

Se você fizer alterações na configuração da janela de manutenção enquanto o cluster já estiver em manutenção ou programado para manutenção, as mudanças só vão entrar em vigor após a conclusão da manutenção atual ou programada.

Limpar uma janela de manutenção

Console

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.

  3. Na página Visão geral, em Manutenção, clique em Editar.

  4. Em Janela de manutenção, selecione Qualquer janela.

  5. Clique em Atualizar para salvar as mudanças.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a CLI do Google Cloud ou usar o Cloud Shell.

Para limpar a janela de manutenção de um cluster, execute o comando gcloud clusters update com a flag --maintenance-window-any:

gcloud alloydb clusters update CLUSTER_ID \
  --region REGION \
  --maintenance-window-any

Substitua:

  • CLUSTER_ID: o cluster em que a janela de manutenção será definida.

  • REGION: a Google Cloud região em que o cluster está localizado, por exemplo, us-central1.

Conferir a janela de manutenção de um cluster

Console

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.

  3. Na página Visão geral, em Manutenção, confira os detalhes da janela de manutenção do cluster.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a CLI do Google Cloud ou usar o Cloud Shell.

Para revisar a janela de manutenção atual em um cluster, execute o comando gcloud alloydb clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region REGION

Substitua:

  • CLUSTER_ID: o cluster em que a janela de manutenção será definida.

  • REGION: a Google Cloud região em que o cluster está localizado, por exemplo, us-central1.

Se o cluster tiver uma janela de manutenção definida, a saída do comando vai incluir linhas semelhantes a esta:

maintenanceUpdatePolicy:
  maintenanceWindows:
  - day: TUESDAY
    startTime:
      hours: 23

Se a saída não incluir uma seção maintenanceUpdatePolicy, o cluster não terá uma janela de manutenção definida.

Conferir a manutenção futura em um cluster

Console

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Localize seu cluster e confira a coluna Maintenance para saber mais sobre a próxima janela de manutenção.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a CLI do Google Cloud ou usar o Cloud Shell.

Para conferir a próxima manutenção programada para um cluster com uma janela de manutenção definida, execute o comando gcloud clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region REGION

Substitua:

  • CLUSTER_ID: o cluster em que a janela de manutenção será definida.

  • REGION: a Google Cloud região em que o cluster está localizado, por exemplo, us-central1.

Se o cluster tiver um evento de manutenção planejado no futuro, a saída do comando vai incluir linhas semelhantes a esta:

maintenanceSchedule:
  startTime: 2024-07-03T09:46:40Z

O carimbo de data/hora no formato UTC especifica o momento em que o AlloyDB planeja começar a atualizar o software do sistema de todos os nós nesse cluster.

Ativar as notificações de manutenção

Para receber uma notificação por e-mail automatizada sempre que um evento de manutenção for agendado ou cancelado em um cluster com uma janela de manutenção definida, use o console do Google Cloud para ativar o recebimento dessas mensagens:

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.

  3. Na página Visão geral, em Manutenção, clique em Editar na linha Notifications:.

  4. Clique em Comunicação.

  5. Na linha do AlloyDB, em Janela de manutenção, selecione o botão de alternância na coluna E-mail.

Cada usuário que precisa receber notificações precisa aceitar separadamente.