Faça a gestão das janelas de manutenção do cluster do AlloyDB para PostgreSQL

Esta página mostra-lhe como realizar as seguintes ações relacionadas com a manutenção do cluster do AlloyDB for PostgreSQL:

  • Defina, veja e limpe um período de manutenção.
  • Ver eventos de manutenção futuros agendados.
  • Configure e remova um período de manutenção de recusa.

Todas as ações indicadas aplicam-se aos clusters principais e secundários.

Para uma vista geral de como funciona a manutenção com clusters do AlloyDB, consulte a Vista geral da manutenção.

Defina um período de manutenção num cluster

Consola

  1. Aceda à página Clusters.

    Aceda a Clusters

  2. Clique num cluster na coluna Nome do recurso.

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

  4. Em Período de manutenção, selecione o dia da semana para este período de manutenção.

    A opção predefinida é Qualquer janela. Quando cria um cluster, é atribuído a este o período de manutenção predefinido.

  5. Selecione a hora do dia para este período de manutenção.

  6. Clique em Atualizar para guardar as alterações.

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

Para definir um período de manutenção num cluster, execute o comando gcloud alloydb clusters update

comando com os sinalizadores --maintenance-window-day e --maintenance-window-hour:

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

Substitua o seguinte:

  • CLUSTER_ID: o cluster no qual definir o período de manutenção.

  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.

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

    O valor predefinido é Qualquer janela. Quando cria um cluster, é atribuído a este o período de manutenção predefinido.

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

Se fizer alterações à definição do período de manutenção enquanto o cluster já estiver em manutenção ou estiver agendado para manutenção, as alterações não entram em vigor até que a manutenção atual ou agendada esteja concluída.

Limpe um período de manutenção

Consola

  1. Aceda à página Clusters.

    Aceda a Clusters

  2. Clique num cluster na coluna Nome do recurso.

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

  4. Em Período de manutenção, selecione Qualquer período.

  5. Clique em Atualizar para guardar as alterações.

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

Para limpar o período 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 LOCATION_ID \
  --maintenance-window-any

Substitua o seguinte:

  • CLUSTER_ID: o cluster no qual definir o período de manutenção.

  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.

Veja o período de manutenção de um cluster

Consola

  1. Aceda à página Clusters.

    Aceda a Clusters

  2. Clique num cluster na coluna Nome do recurso.

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

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

Para rever a janela de manutenção atual num cluster, execute o comando gcloud alloydb clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Substitua o seguinte:

  • CLUSTER_ID: o cluster no qual definir o período de manutenção.

  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.

Se o cluster tiver uma janela de manutenção definida, o resultado do comando inclui linhas semelhantes às seguintes:

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

Se a saída não incluir uma secção maintenanceUpdatePolicy, significa que o cluster não tem nenhum período de manutenção definido.

Veja a manutenção futura num cluster

Consola

  1. Aceda à página Clusters.

    Aceda a Clusters

  2. Localize o cluster e veja a coluna Manutenção para obter informações acerca do período de manutenção futuro.

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

Para ver a manutenção futura planeada para um cluster que tenha uma janela de manutenção definida, execute o comando gcloud clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Substitua o seguinte:

  • CLUSTER_ID: o cluster no qual definir o período de manutenção.

  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.

Se o cluster tiver um evento de manutenção planeado no futuro, o resultado do comando inclui linhas semelhantes às seguintes:

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

A data/hora formatada em UTC especifica o momento em que o AlloyDB planeia começar a atualizar o software do sistema de todos os nós neste cluster.

Aceite as notificações de manutenção

As notificações de manutenção estão desativadas por predefinição. Quando optar por receber notificações por email sobre os próximos eventos de manutenção do AlloyDB, tenha em atenção o seguinte:

  • Recebe uma notificação automática sobre o evento assim que este for agendado. Os eventos de manutenção são agendados com, pelo menos, uma semana de antecedência.
  • As notificações de manutenção estão ativadas ao Google Cloud nível do projeto. Não pode optar por receber notificações sobre um subconjunto de clusters num projeto.
  • Apenas pode ativar notificações para si. Cada utilizador tem de aceitar separadamente receber notificações de manutenção.

Para mais informações, consulte o artigo Vista geral da manutenção.

Para receber uma notificação por email automática sempre que um evento de manutenção for agendado ou cancelado para um cluster com um período de manutenção definido, siga estes passos através da consola: Google Cloud

  1. Aceda à página Clusters.

    Aceda a Clusters

  2. Clique num cluster na coluna Nome do recurso.

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

  4. Clique em Comunicação.

  5. Na linha de AlloyDB, Janela de manutenção, selecione o botão na coluna Email.

Configure um período de manutenção de recusa

Para impedir operações de manutenção durante um período específico, pode configurar um período de manutenção recusado. Pode definir a manutenção de recusa num cluster que execute a versão mais recente do AlloyDB. Um período de manutenção de recusa pode durar entre 1 e 30 dias.

Defina períodos de negação de manutenção

Para configurar um período de manutenção de recusa, define a respetiva data de início, data de fim e a hora do dia em que o intervalo começa e termina.

As datas de início e de conclusão têm de estar no seguinte formato:

  • YYYY-MM-DD: indica uma data específica

A data de início, a data de fim e a hora estão no fuso horário UTC.

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

Para adicionar um período de manutenção recusado a um cluster do AlloyDB, execute o comando gcloud alloydb clusters update com as flags deny-maintenance-period-start-date, deny-maintenance-period-end-date e deny-maintenance-period-time:

gcloud alloydb clusters update CLUSTER_ID \
   --region LOCATION_ID \
   --deny-maintenance-period-start-date START_DATE \
   --deny-maintenance-period-end-date END_DATE \
   --deny-maintenance-period-time TIME

Substitua o seguinte:

  • CLUSTER_ID: o cluster a configurar para o período sem manutenção.
  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.
  • START_DATE: a data de início do período sem manutenção no formato YYYY-MM-DD UTC.
  • END_DATE: o fim do período sem manutenção no formato YYYY-MM-DD UTC.
  • TIME: a hora do período sem manutenção no formato HH:MM UTC. As horas são representadas no formato de 24 horas, em que os valores variam entre 00:00 e 23:59. Por exemplo, 16:45.

REST v1

Este exemplo adiciona um período de manutenção de recusa a um cluster existente. Para ver uma lista completa dos parâmetros desta chamada, consulte o Método: projects.locations.clusters.instances.patch.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • CLUSTER_ID: o cluster a configurar para o período sem manutenção.
  • PROJECT_ID: o ID do projeto onde o cluster está localizado.
  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.
  • START_YEAR: o ano em que o período sem manutenção começa no formato YYYY.
  • START_MONTH: o mês em que o período sem manutenção começa no formato MM. Um zero à esquerda para meses com um único dígito é opcional. Por exemplo, 2 e 02 são válidos para fevereiro.
  • START_DAY: o dia em que o período sem manutenção começa no formato DD. O zero inicial para dias com um único dígito é opcional. Por exemplo, 1 e 01 são válidos para o primeiro dia do mês.
  • END_YEAR: o ano em que o período sem manutenção termina no formato YYYY.
  • END_MONTH: o mês em que o período sem manutenção termina no formato MM.
  • END_DAY: o dia em que o período sem manutenção termina no formato DD.
  • HOUR(S): a hora do período sem manutenção no formato de 24 horas, por exemplo, 16. Um zero à esquerda para horas de um só dígito é opcional. Por exemplo, 2 e 02 são válidos.
  • MINUTE(S): o minuto do período sem manutenção que aceita valores de 0 a 59, por exemplo, 45. O zero inicial para minutos de um único dígito é opcional. 7 e 07 são válidos.

Para adicionar um período de manutenção recusado, use o seguinte pedido: PATCH 

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods}

O parâmetro de consulta maintenance_update_policy.deny_maintenance_periods indica à API que deve atualizar o campo denyMaintenancePeriods no bloco maintenanceUpdatePolicy.

O corpo JSON do pedido tem o seguinte aspeto:

"maintenanceUpdatePolicy": {
 "denyMaintenancePeriods": [
   {
     "startDate": {
       "year": START_YEAR,
       "month": START_MONTH,
       "day": START_DAY
     },
     "endDate": {
       "year": END_YEAR,
       "month": END_MONTH,
       "day": END_DAY
     },
     "time": {
       "hours": TIME
       "minutes": TIME
     }
   }
 ]
},

Recuse a manutenção futura

Os períodos de recusa de manutenção têm precedência sobre a manutenção agendada. Se ocorrer um conflito de tempo, o período de negação de manutenção substitui o período de manutenção agendado.

A definição de um período de negação que entre em conflito com um evento de manutenção agendado não cancela imediatamente a manutenção nem limpa a agenda. O AlloyDB mostra a manutenção agendada existente como próxima, mas cancela a janela de manutenção agendada quando a hora agendada começa.

Para ajudar a aplicar atualizações críticas, normalmente, o sistema não permite definir um período de recusa para ignorar mais do que um evento de manutenção e, em casos raros, pode aplicar a manutenção de emergência fora das preferências de manutenção configuradas.

Remova um período de manutenção recusado de um cluster

Pode remover um período de manutenção recusado em qualquer altura.

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

Para remover um período de manutenção recusado de um cluster do AlloyDB, execute o comando gcloud alloydb clusters update com a flag remove-deny-maintenance-period:

gcloud alloydb clusters update CLUSTER_ID --region LOCATION_ID  --remove-deny-maintenance-period

Substitua o seguinte:

  • CLUSTER_ID: o cluster do qual remover o período de manutenção recusado.
  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.

REST v1

Este exemplo remove um período de manutenção recusado de um cluster do AlloyDB. Para ver uma lista completa de parâmetros para esta chamada, consulte Method: projects.locations.clusters.patch.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • CLUSTER_ID: o ID do cluster ao qual adiciona um período de manutenção recusado.
  • PROJECT_ID: o ID do projeto onde o cluster está localizado.
  • LOCATION_ID: a Google Cloud região em que este cluster se encontra, por exemplo, us-central1.

Para remover um período de manutenção de recusa, use o seguinte pedido: PATCH 

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods}

O parâmetro de consulta maintenance_update_policy.deny_maintenance_periods indica à API que deve atualizar o campo denyMaintenancePeriods no bloco maintenanceUpdatePolicy.

O corpo JSON do pedido tem o seguinte aspeto:

{}

O que se segue?