Gerenciar o estado da instância no AlloyDB para PostgreSQL permite reduzir os custos de computação durante períodos de inatividade, redefinir conexões de banco de dados ou se recuperar de problemas temporários. É possível iniciar, interromper ou reiniciar uma instância primária ou uma instância de pool de leitura, além de reiniciar uma instância secundária ou nós individuais em um pool de leitura.
Essas operações não alteram o endereço IP público de entrada nem o URI do Private Service Connect da instância.
Antes de começar
O projeto do 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 do Google Cloud que está sendo usado:
- (
roles/alloydb.admin) (o papel predefinido do IAM de Admin do AlloyDB) - (
roles/owner) (o papel básico do IAM de Proprietário) - (
roles/editor) (o papel básico do IAM de Editor)
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. A política de ativação 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
É possível interromper manualmente uma instância primária ou de pool de leitura quando necessário. Quando você interrompe uma instância, ela permanece interrompida e não responde às conexões do aplicativo até que seja iniciada novamente. Não é possível interromper uma instância secundária.
Interromper uma instância pausa temporariamente as atualizações automáticas. Os dados armazenados no cluster não são afetados, e qualquer configuração de backup do cluster permanece ativa.
As instâncias interrompidas não geram cobranças de computação associadas à instância. Se o IP público estiver ativado na instância, você vai receber cobranças de IP externo estático inativo.
Para interromper uma instância:
Console
No Google Cloud console, acesse a página Clusters.
Clique em um cluster na coluna Nome do Recurso.
Na página Visão geral que será aberta, acesse a seção Instâncias no cluster e confira os detalhes sobre a instância.
Em Interromper instância do banco de dados?, clique em Interromper.
A política de ativação da instância está definida como NEVER, e a instância está interrompida.
gcloud
Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.
Use o comando gcloud alloydb instances update para interromper uma instância.
gcloud alloydb instances update INSTANCE_ID \ --region=REGION_ID \ --cluster=CLUSTER_ID \ --activation-policy=NEVER ```Replace the following:
INSTANCE_ID: o ID da instância.REGION_ID: o ID da região da instância.CLUSTER_ID: o ID do cluster da instância.
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:
Console
No Google Cloud console, acesse a página Clusters.
Clique em um cluster na coluna Nome do Recurso.
Na página Visão geral que será aberta, acesse a seção Instâncias no cluster e confira os detalhes sobre a instância.
Em Iniciar instância do banco de dados?, clique em Iniciar.
A política de ativação da instância é definida como ALWAYS, e a instância é iniciada.
gcloud
Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.
Use o comando gcloud alloydb instances update para iniciar uma instância.
gcloud alloydb instances update INSTANCE_ID \ --region=REGION_ID \ --cluster=CLUSTER_ID \ --activation-policy=ALWAYS ```Replace the following:
INSTANCE_ID: o ID da instância.REGION_ID: o ID da região da instância.CLUSTER_ID: o ID do cluster da instância.
Reiniciar uma instância
Quando você inicia a 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. Reiniciar uma instância não muda o endereço IP privado dela.
Reiniciar uma instância primária, secundária ou de pool de leitura
Console
- No Google Cloud console, acesse a página Clusters.
- Clique em um cluster na coluna Nome do Recurso.
- Na página Visão geral, acesse a seção Instâncias no cluster, escolha a instância primária 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 está localizada.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.
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 \
--project=PROJECT_ID \
[--async]INSTANCE_ID: o ID da instância do pool de leitura.CLUSTER_ID: o ID do cluster em que a instância está disponível.REGION_ID: a região em que a instância está localizada.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 \
--project=PROJECT_ID \
[--async]INSTANCE_ID: o ID da instância do pool de leitura.CLUSTER_ID: o ID do cluster em que a instância está disponível.REGION_ID: a região em que a instância está localizada.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 do cluster e da instância