Nesta página, descrevemos como criar uma instância de pool de leitura em um cluster do AlloyDB para PostgreSQL.
Antes de começar
- O projeto Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
- Você precisa ter um destes 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 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 acesso.
Criar uma instância do pool de leitura
Console
No console 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 um número.
O número de nós em uma instância de pool de leitura determina a capacidade geral de computação da instância.
Selecione uma das seguintes séries de máquinas:
- C4A (série de máquinas baseadas no Google Axion) (prévia)
- N2 (série de máquinas baseadas em x86). Essa é a série de máquinas padrão.
Selecione um tipo de máquina.
- O C4A é compatível com 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 baseada em Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A baseada em 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 outras 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 agrupamento de conexões gerenciado, marque a caixa Ativar pool de conexões gerenciado em Pool de conexões gerenciado. Para mais informações, consulte Configurar o pool de conexões gerenciado.
Escolha as configurações de segurança de rede. Para manter seus dados em segurança, recomendamos o uso de criptografia mTLS com conectores AlloyDB ou criptografia SSL.
Ao mudar as configurações de segurança, a instância fica disponível para uso, mas as conexões atuais que não estão em conformidade são removidas.
Opcional: defina flags personalizadas para 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, instale e inicialize a Google Cloud CLI ou use 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 corresponder. 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 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 baseada em Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A baseada em Axion.
Para a série de máquinas N2 baseadas em 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
, inclusive. 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 está localizado.
Para criar uma instância de pool de leitura para um cluster ativado para o Private Service Connect, adicione a flag --allowed-psc-projects
para definir uma lista separada por vírgulas de IDs de projetos ou números de projetos](/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 que 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 usar o Private Service Connect como método de conexão com a instância.
Para ativar o pool de conexões gerenciadas 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 quiser, transmita a lista separada por vírgulas de blocos CIDR, como
64.233.160.0/16
para o parâmetro --authorized-external-networks
e defina
redes externas autorizadas na sua instância.
A seguir
- Saiba mais sobre as opções de conexão da instância do pool de leitura.
- Ver detalhes da instância.
- Dimensionar uma instância.
- Reinicie uma instância ou leia nós do pool.
- Resolver problemas de consultas em pools de leitura.
- Saiba mais sobre as recomendações de dimensionamento