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 transitórios. É possível iniciar, parar ou reiniciar uma instância principal ou 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 mudam 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 Google Cloud projeto que está sendo usado:
- (
roles/alloydb.admin) (o papel predefinido do IAM de administrador 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
Você pode interromper manualmente uma instância principal ou de pool de leitura quando necessário. Quando você interrompe uma instância, ela permanece parada e não responde a conexões de aplicativos até que seja iniciada novamente. Não é possível interromper uma instância secundária.
A interrupção de uma instância interrompe temporariamente 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:
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á parada.
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, 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 e estiver pronta para aceitar novas conexões. Reiniciar 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
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 um 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.
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 pool de leitura.
- 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.
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 pool de leitura.
- 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.
A seguir
- Saiba como criar uma instância principal.
- Atualizar as configurações de cluster e instância