Reiniciar uma instância ou nós de pool de leitura

Esta página descreve como reiniciar a instância principal, uma instância de pool de leitura ou um nó em um pool de leitura de um cluster do AlloyDB.

Quando você inicia uma reinicialização de uma instância, ela interrompe todas as conexões disponíveis, é reiniciada e fica pronta para aceitar novas conexões.

A reinicialização de uma instância não muda o endereço IP particular dela.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • É necessário ter uma destas funções do IAM no projeto do Google Cloud que você está usando:
    • roles/alloydb.admin (papel predefinido do IAM de administrador do AlloyDB)
    • roles/owner (o papel básico do IAM "Proprietário")
    • roles/editor (papel básico do IAM de editor)

    Se você não tiver nenhuma dessas funções, entre em contato com o administrador da organização para solicitar acesso.

Reiniciar uma instância

Console

  1. No console do Google Cloud, acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.
  3. Na página Visão geral, acesse a seção Instâncias no cluster, escolha a instância principal ou de pool de leitura e clique em Reiniciar.

gcloud

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

Reinicie a instância:

gcloud alloydb instances restart INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID \
    [--async]
  • INSTANCE_ID: o ID da instância.
  • CLUSTER_ID: o ID do cluster em que a instância está disponível.
  • REGION_ID: a região em que a instância é colocada.
  • PROJECT_ID: o ID do projeto em que o cluster está colocado.
  • async: uma flag opcional para retornar imediatamente, sem aguardar a conclusão da operação em andamento.

Reiniciar nós específicos de um pool de leitura

É possível usar a CLI gcloud para reiniciar um ou mais nós de um pool de leitura.

O comando a seguir mostra como reiniciar um nó de um pool de leitura:

gcloud alloydb instances restart INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --node-ids=NODE_ID \
  • INSTANCE_ID: o ID da instância do readpool.
  • CLUSTER_ID: o ID do cluster em que a instância está disponível.
  • NODE_ID: o ID que precisa ser reinicializado.
  • PROJECT_ID: o ID do projeto em que o cluster está colocado.
  • --async: uma flag opcional para retornar imediatamente, sem aguardar a conclusão da operação em andamento.

O exemplo a seguir mostra como reiniciar vários nós:

gcloud alloydb instances restart INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --node-ids=NODE_ID1,NODE_ID2 \
  • INSTANCE_ID: o ID da instância do readpool.
  • CLUSTER_ID: o ID do cluster em que a instância está disponível.
  • NODE_ID1,NODE_ID2: a lista de nós que precisam ser reiniciados.
  • PROJECT_ID: o ID do projeto em que o cluster está colocado.
  • --async: uma flag opcional para retornar imediatamente, sem aguardar a conclusão da operação em andamento.