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 do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
- Você precisa ter um destes papéis do IAM no Google Cloud projeto 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.
Criar uma instância do pool de leitura
Console
No Google Cloud console, 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)
- 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 configuração adicional 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 gerenciadas.
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 gcloud CLI, 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 \
--read-pool-node-count=NODE_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--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.NODE_COUNT
: o número de nós na instância. Especifique um número de1
a20
, 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.CPU_COUNT
: o número de vCPUs que você quer para a instância.- É preciso especificar
cpu_count
oumachine_type
. - Se apenas
cpu_count
for fornecido, uma instância N2 será criada com as seguintes especificações:- 2: 2 vCPUs, 16 GB de RAM
- 4: 4 vCPUs, 32 GB de RAM
- 8: 8 vCPUs, 64 GB de RAM
- 16: 16 vCPUs, 128 GB de RAM
- 32: 32 vCPUs, 256 GB de RAM
- 64: 64 vCPUs, 512 GB de RAM
- 96: 96 vCPUs, 768 GB de RAM
- 128: 128 vCPUs, 864 GB de RAM
- Se
machine_type
ecpu_count
forem fornecidos, o valor decpu_count
precisará estar alinhado com o número de vCPUs especificado emmachine_type
. Por exemplo, semachine_type
forn2-highmem-4
, definacpu_count
como4
.
- É preciso especificar
MACHINE_TYPE
: o tipo de máquina da instância.Para a série de máquinas C4A baseadas no Axion, os seguintes valores são válidos:
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 a série de máquinas N2, os seguintes valores são válidos:
n2-highmem-2
n2-highmem-4
n2-highmem-8
n2-highmem-16
n2-highmem-32
n2-highmem-64
n2-highmem-96
n2-highmem-128
Quando você usa
machine_type
ecpu_count
juntos, os valores emcpu_count
emachine_type
precisam corresponder. Por exemplo, semachine_type
forn2-highmem-4
, definacpu_count
como4
.
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 \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--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 alloydb instances create
:
gcloud alloydb instances create INSTANCE_ID \
--instance-type=READ_POOL \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--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 \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--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
ao parâmetro --authorized-external-networks
para definir
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 nós do pool de leitura.
- Resolva problemas de consultas em pools de leitura.
- Saiba mais sobre as recomendações de dimensionamento.