Faça a manutenção self-service

Pode realizar a manutenção self-service se precisar de aplicar as atualizações mais recentes do AlloyDB for PostgreSQL aos seus clusters o mais rapidamente possível. A atualização para a versão mais recente pode desbloquear funcionalidades do AlloyDB, aplicar patches e permitir-lhe definir um período de recusa para evitar interrupções durante períodos sensíveis.

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

Exemplos de utilização de manutenção autónoma

Normalmente, o AlloyDB aplica a manutenção aos seus clusters por si, executando operações de manutenção para atualizar o software da base de dados nos clusters. Por predefinição, o AlloyDB realiza a manutenção fora do horário de funcionamento regional. Opcionalmente, pode definir um período de manutenção para definir uma hora de manutenção agendada preferencial e receber notificações de manutenção agendada futura. Para uma determinada versão do PostgreSQL, a manutenção é concluída primeiro para clusters sem janelas de manutenção e, em seguida, agendada para clusters com janelas de manutenção.

Pode decidir realizar a manutenção autónoma pelos seguintes motivos:

  • O seu cluster ignorou a manutenção. Isto ocorre se configurar um período de recusa ou se o cluster estiver num estado de arranque durante a migração.
  • O seu cluster requer uma atualização antes da manutenção agendada.
  • Tem de definir um período de recusa num cluster que não esteja atualizado. Os clusters com instâncias em versões anteriores nem sempre suportam a definição de períodos de recusa.
  • Quer executar a manutenção numa cadência personalizada ou irregular. Neste caso, pode definir um período de negação e, em seguida, realizar a manutenção de autosserviço quando precisar. Os períodos de recusa não bloqueiam a manutenção autónoma.

Nível de detalhe dos recursos durante as atualizações

O AlloyDB só suporta manutenção ao nível do cluster. No cluster, o AlloyDB determina a ordem das atualizações das instâncias. O AlloyDB tenta e conclui a manutenção de cada instância de forma independente. Por isso, é possível que as instâncias estejam em versões diferentes. Por exemplo, um cluster pode ignorar a manutenção em instâncias existentes devido a um período de recusa e, em seguida, criar uma instância na versão mais recente.

Veja a versão mais recente disponível

Consulte os registos de alterações de manutenção do AlloyDB para ver a versão mais recente. O registo de alterações é atualizado depois de a manutenção ser aplicada aos clusters em todas as regiões. Para mais informações sobre como as versões mais recentes são aplicadas às regiões, consulte o artigo Versão mais recente.

Veja a versão atual de uma instância

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

A visualização da versão só é suportada ao nível da instância.

  1. Para ver a versão de manutenção atual da instância, execute o comando gcloud alloydb instances describe:

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    Substitua o seguinte:

    • INSTANCE_ID: o ID da instância para a qual está a ver a versão.
    • CLUSTER_ID: o ID do cluster onde a instância está colocada.
    • LOCATION_ID: a Google Cloud região em que este cluster está localizado, por exemplo, us-central1.

  2. Na resposta, encontre o campo maintenanceVersionName para ver a versão que a instância está a executar. Por exemplo:

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

Atualize o cluster para a versão mais recente disponível

gcloud

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

Para atualizar o cluster para a versão mais recente, execute o comando gcloud alloydb clusters update com a flag maintenance-version:

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

Substitua o seguinte:

  • CLUSTER_ID: o ID do cluster a atualizar para a versão mais recente.
  • LOCATION_ID: a Google Cloud região em que este cluster está localizado, por exemplo, us-central1.

Exemplo de resposta:

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST v1

Este exemplo atualiza este cluster para a versão mais recente. Para ver uma lista completa de parâmetros para esta chamada, consulte Método: projects.locations.clusters.patch.

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

  • CLUSTER_ID: o cluster a atualizar para a versão mais recente.
  • PROJECT_ID: o ID do projeto onde o cluster está localizado.
  • LOCATION_ID: a Google Cloud região em que este cluster está localizado, por exemplo, us-central1.

Para atualizar o cluster para a versão mais recente, 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_version_selection_policy}

O parâmetro de consulta maintenance_version_selection_policy especifica a versão para a qual atualizar as instâncias do cluster.

O corpo JSON do pedido tem o seguinte aspeto:

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

O que se segue?