Iniciar, interromper ou reiniciar instâncias

Nesta página, descrevemos como iniciar, interromper ou reiniciar a instância principal e uma instância de pool de leitura. Também é possível reiniciar uma instância secundária e um nó em um pool de leitura de um cluster do AlloyDB.

As operações de início, interrupção ou reinicialização não mudam o IP público de entrada nem o URI do Private Service Connect da instância.

Antes de começar

• O projeto Google Cloud que você está usando precisa estar ativado para acessar o AlloyDB.

• Você precisa ter um dos seguintes papéis do IAM no projeto Google Cloud que está usando:

  • (roles/alloydb.admin), o papel predefinido do IAM de administrador do AlloyDB.
  • (roles/owner) (o papel básico de proprietário do IAM)
  • (roles/editor), o papel básico de editor do IAM

  Se você não tiver nenhum desses papéis, entre em contato com o administrador da organização para solicitar o acesso.

• O cluster do AlloyDB está no estado READY.

Política de ativação

Ao iniciar ou interromper uma instância, a política de ativação precisa ser definida para indicar a operação que você está realizando. Essa política indica se a instância está ativada para aceitar solicitações de conexão.

As opções de política de ativação são:

• ALWAYS: a instância está sempre ativa e em execução.
• NEVER: a instância está inativa e não aceita conexões.

Para iniciar a instância, defina a política de ativação como ALWAYS. Para interromper a instância e evitar cobranças, defina a política de ativação como NEVER.

Interromper uma instância

Você pode interromper manualmente uma instância principal ou de pool de leitura quando necessário. Quando você interrompe uma instância, ela permanece assim e não responde às conexões do aplicativo até ser iniciada novamente. Não é possível interromper uma instância secundária.

A interrupção temporária de uma instância interrompe as atualizações automáticas. Os dados armazenados no cluster não são afetados, e qualquer configuração de backup para o cluster permanece ativa.

As instâncias interrompidas não geram cobranças de computação associadas a elas. Se o IP público estiver ativado na instância, você vai receber cobranças de IP externo estático ocioso.

Para interromper uma instância:

gcloud alloydb instances update INSTANCE_ID \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --activation-policy=NEVER
 ```
Replace the following:

Iniciar uma instância

Quando você inicia a instância, o AlloyDB aplica a versão secundária mais recente do banco de dados. Como iniciar uma instância não é uma atividade de manutenção, todos os períodos de bloqueio de manutenção configurados para a instância são ignorados.

Para iniciar uma instância interrompida:

gcloud alloydb instances update INSTANCE_ID \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --activation-policy=ALWAYS
 ```
Replace the following:

Reiniciar uma instância

Quando você inicia uma reinicialização de uma instância, todas as conexões disponíveis nela são interrompidas. Depois que a instância for reiniciada, ela estará pronta para aceitar novas conexões. A reinicialização de uma instância não muda o endereço IP particular dela.

Reiniciar uma instância primária, secundária ou de pool de leitura

gcloud alloydb instances restart INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID \
    [--async]
    

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 do nó que precisa ser reiniciado. Por exemplo, j71a-read-pool-054b8861-2ln8.
• PROJECT_ID: o ID do projeto em que o cluster está localizado.
• --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á localizado.
• --async: uma flag opcional para retornar imediatamente, sem aguardar a conclusão da operação em andamento.

A seguir

• Saiba como criar uma instância principal.
• Atualizar as configurações de cluster e instância