Realizar manutenção de autoatendimento

Você pode fazer a manutenção de autoatendimento se precisar aplicar as atualizações mais recentes do AlloyDB para PostgreSQL aos seus clusters o mais rápido possível. A atualização para a versão mais recente pode desbloquear recursos do AlloyDB, aplicar patches e permitir que você defina um período de negação para evitar interrupções durante períodos sensíveis.

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

Casos de uso de auto manutenção

O AlloyDB geralmente aplica manutenção aos seus clusters, realizando operações para fazer upgrade do software de banco de dados nos clusters. Por padrão, o AlloyDB realiza a manutenção fora do horário comercial regional. Você também pode definir uma janela de manutenção para definir um horário preferencial de manutenção programada e receber notificações sobre as próximas manutenções programadas. Para uma determinada versão e versão do PostgreSQL, a manutenção é concluída primeiro para clusters sem janelas de manutenção e depois programada para clusters com janelas de manutenção.

Você pode decidir fazer a manutenção por autoatendimento pelos seguintes motivos:

  • A manutenção do cluster foi ignorada. Isso ocorre se você configurar um período de restrição ou se o cluster estiver em estado de inicialização durante a migração.
  • Seu cluster precisa de uma atualização antes da manutenção programada.
  • Você precisa definir um período de negação em um cluster que não está atualizado. Clusters com instâncias em versões anteriores nem sempre oferecem suporte à definição de períodos de bloqueio.
  • Você quer executar a manutenção em uma cadência personalizada ou irregular. Nesse caso, você pode definir um período de negação e realizar a manutenção de autoatendimento quando precisar. Os períodos de bloqueio não impedem a manutenção de autoatendimento.

Granularidade de recursos durante as atualizações

O AlloyDB só aceita manutenção no nível do cluster. No cluster, o AlloyDB determina a ordem das atualizações de 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 pular a manutenção em instâncias atuais devido a um período de negação e, em seguida, criar uma instância na versão mais recente.

Conferir a versão mais recente disponível

Consulte os registros de alterações de manutenção do AlloyDB para conferir a versão mais recente. O changelog é atualizado depois que a manutenção é 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 Versão mais recente.

Conferir a versão atual de uma instância

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

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

  1. Para conferir 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:

    • INSTANCE_ID: o ID da instância que você está visualizando a versão.
    • CLUSTER_ID: o ID do cluster em que a instância está localizada.
    • LOCATION_ID: a região Google Cloud em que o cluster está localizado, por exemplo, us-central1.

  2. Na resposta, encontre o campo maintenanceVersionName para ver a versão em que a instância está sendo executada. Exemplo:

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

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

gcloud

Para usar a gcloud CLI, você pode instalar e inicializar a CLI do Google Cloud ou usar o 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:

  • CLUSTER_ID: o ID do cluster a ser atualizado para a versão mais recente.
  • LOCATION_ID: a região Google Cloud em que o 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 o cluster para a versão mais recente. Para uma lista completa de parâmetros dessa chamada, consulte Método: projects.locations.clusters.patch.

Antes de usar os dados da solicitação, faça as seguintes substituições:

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

Para atualizar o cluster para a versão mais recente, use a seguinte solicitação 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 as instâncias do cluster serão atualizadas.

O corpo JSON da solicitação é parecido com este:

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

A seguir