Esta página descreve como criar uma instância de pool de leitura em um cluster do AlloyDB para PostgreSQL.
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.
Criar uma instância do pool de leitura
Console
No console do Google Cloud, acesse a página Clusters.
Clique em um cluster na coluna Nome do recurso.
Acesse a seção Instâncias no cluster e clique em Adicionar pool de leitura.
Configure a instância do pool de leitura:
No campo ID da instância do pool de leitura, insira um ID para a instância do pool de leitura.
No campo Contagem de nós, insira uma contagem de nós.
O número de nós em uma instância de pool de leitura determina a capacidade de computação geral da instância.
Selecione uma das seguintes séries de máquinas:
- C4A (série de máquinas baseadas no Google Axion) (pré-lançamento)
- N2 (série de máquinas baseadas em x86). Esta é a série de máquinas padrão.
Selecione um tipo de máquina.
- A C4A oferece suporte a 1, 4, 8, 16, 32, 48, 64 e 72 tipos ou formatos de máquina.
- O N2 oferece suporte a 2, 4, 8, 16, 32, 64, 96 e 128 tipos ou formatos de máquina.
Para mais informações sobre o uso da série de máquinas C4A Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A Axion.
- Opcional: para conectar seus aplicativos e clientes pela Internet pública, clique em Ativar IP público em Conectividade de IP público. A ativação do IP público pode exigir mais configurações para garantir uma conexão segura. Para mais informações, consulte Conectar usando IP público.
Por padrão, o IP particular está sempre ativado. Para mais informações, consulte Ativar o acesso a serviços privados.
Opcional: para ativar e usar o pool de conexões gerenciadas, marque a caixa Ativar o pool de conexões gerenciadas em Pool de conexões gerenciadas. Para mais informações, consulte Configurar o pool de conexões gerenciadas.
Escolha as configurações de segurança de rede. Para manter seus dados em segurança, recomendamos que você use criptografia mTLS com conectores AlloyDB ou criptografia SSL.
Quando você muda as configurações de segurança, a instância fica disponível para uso, mas as conexões que não estão em conformidade são descartadas.
Opcional: defina flags personalizadas na sua instância. Para cada flag, siga estas etapas:
- Clique em Opções de configuração avançadas.
- Clique em Adicionar um flag de banco de dados.
- Selecione uma flag na lista Nova flag de banco de dados.
- Informe um valor para a flag.
- Clique em Concluído.
Clique em Adicionar pool de leitura.
gcloud
Para usar a CLI gcloud, você pode instalar e inicializar a CLI do Google Cloud ou usar o Cloud Shell.
Use o comando gcloud alloydb instances create
para criar uma instância de pool de leitura.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--read-pool-node-count=NODE_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID
Substitua:
INSTANCE_ID
: o ID da instância que você está criando. Ele precisa começar com uma letra minúscula e pode conter letras minúsculas, números e hifens.CPU_COUNT
: o número de vCPUs N2 que você quer para a instância. N2 é o padrão. Os valores válidos incluem:2
: 2 vCPUs, 16 GB de RAM4
: 4 vCPUs, 32 GB de RAM8
: 8 vCPUs, 64 GB de RAM16
: 16 vCPUs, 128 GB de RAM32
: 32 vCPUs, 256 GB de RAM64
: 64 vCPUs, 512 GB de RAM96
: 96 vCPUs, 768 GB de RAM128
: 128 vCPUs, 864 GB de RAM
MACHINE_TYPE
: esse parâmetro é opcional ao implantar máquinas N2. Para implantar a série de máquinas C4A baseada em Axion (pré-lançamento) ou migrar entre máquinas C4A e N2, escolha esse parâmetro com os seguintes valores.Quando você usa
MACHINE_TYPE
eCPU_COUNT
juntos, os valores emCPU_COUNT
eMACHINE_TYPE
precisam ser iguais. Caso contrário, um erro será gerado.Para a série de máquinas C4A baseada em Axion, escolha o tipo de máquina com os seguintes valores:
c4a-highmem-1
c4a-highmem-4-lssd
c4a-highmem-8-lssd
c4a-highmem-16-lssd
c4a-highmem-32-lssd
c4a-highmem-48-lssd
c4a-highmem-64-lssd
c4a-highmem-72-lssd
Para implantar a C4A com 4 vCPUs ou mais, use o sufixo
lssd
para ativar o cache ultrarrápido.Para mais informações sobre o uso da série de máquinas C4A Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A Axion.
Para a série de máquinas N2 x86, use os seguintes valores:
N2-highmem-2
N2-highmem-4
N2-highmem-8
N2-highmem-16
N2-highmem-32
N2-highmem-64
N2-highmem-96
N2-highmem-128
NODE_COUNT
: o número de nós na instância. Especifique um número entre1
e20
. Não é possível ter mais de 20 nós em todas as instâncias do pool de leitura em um cluster.REGION_ID
: a região em que você quer que a instância esteja localizada.CLUSTER_ID
: o ID do cluster em que você quer colocar a instância.PROJECT_ID
: o ID do projeto em que o cluster é colocado.
Para criar uma instância de pool de leitura para um cluster com o recurso Private Service Connect ativado, adicione a flag --allowed-psc-projects
para definir uma lista separada por vírgulas de IDs ou [números de projeto](/resource-manager/docs/creating-managing-projects#identifying_projects) que você quer permitir o acesso à instância. Por exemplo, my-project-1
, 12345
,my-project-n
.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECT_LIST
Substitua:
ALLOWED_PROJECT
(opcional): a lista separada por vírgulas de IDs ou números de projetos aos quais você quer permitir o acesso à instância,por exemplo,my-project-1
,12345
,my-project-n
. É necessário definir uma lista de projetos ou números permitidos se o cluster estiver usando o Private Service Connect como o método de conexão à instância.
Para ativar o pool de conexões gerenciado na instância do pool de leitura, adicione a
flag --enable-connection-pooling
ao comando
gcloud alpha alloydb instances create
:
gcloud alpha alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--enable-connection-pooling
Para criar uma instância de pool de leitura para um cluster com IP público ativado, adicione o parâmetro --assign-inbound-public-ip=ASSIGN_IPV4
.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--assign-inbound-public-ip=ASSIGN_IPV4
Se preferir, transmita a lista separada por vírgulas de blocos CIDR, como
64.233.160.0/16
, para o parâmetro --authorized-external-networks
para definir
redes externas autorizadas na sua instância.
A seguir
- Saiba as opções para conectar a instância do pool de leitura.
- Acessar os detalhes da instância.
- Dimensionar uma instância.
- Reinicie uma instância ou os nós do pool de leitura.
- Resolver problemas de consultas em pools de leitura.
- Saiba mais sobre as recomendações de dimensionamento