Conectar pelo laptop

Para conhecer o AlloyDB para PostgreSQL ou trabalhar em um ambiente de desenvolvimento local, estabeleça uma conexão segura do seu laptop ou estação de trabalho local com uma instância do AlloyDB usando o proxy de autenticação do AlloyDB em um endereço IP público.

Antes de começar

Antes de se conectar pelo laptop, conclua os seguintes pré-requisitos:

Funções exigidas

Para se conectar pelo laptop, conceda ao principal do Identity and Access Management (IAM) (conta de usuário ou de conta de serviço) os seguintes papéis predefinidos:

  • Cliente do AlloyDB (roles/alloydb.client)
  • Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer)

Ativar o IP público na instância do AlloyDB

A maneira mais simples de se conectar pelo laptop é ativar o IP público na instância do AlloyDB. É possível ativar o IP público ao criar uma instância ou atualizar uma instância atual para ativá-lo.

Console

  1. Acesse a página Clusters no console do Google Cloud .

    Acessar Clusters

  2. Para ver os detalhes do cluster, clique em um cluster em Nome do recurso.

  3. Em Instâncias no cluster, localize a instância a que você quer se conectar.

  4. Clique em Ações da instância e em Editar.

  5. Em Conectividade, selecione Ativar IP público.

  6. Para salvar as alterações, clique em Atualizar instância.

gcloud

Use o comando gcloud alloydb instances update para ativar o IP público na instância:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

Substitua:

  • INSTANCE_ID: o ID da instância do AlloyDB.
  • CLUSTER_ID: o ID do cluster.
  • REGION_ID: a região em que o cluster está localizado.

Recuperar o URI de conexão da instância

Ao iniciar o cliente do proxy de autenticação, é preciso identificar a instância usando o URI de conexão exclusivo dela. Recupere o URI de conexão usando o comando da CLI gcloud alloydb instances describe no terminal do seu laptop.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

O comando retorna o URI de conexão, que é formatado de maneira semelhante ao seguinte:

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

Iniciar o proxy de autenticação do AlloyDB com IP público

Agora que você tem o URI de conexão da instância, inicie o cliente do proxy de autenticação usando o terminal do seu laptop. Use a flag --public-ip para instruir o proxy de autenticação do AlloyDB a se conectar pelo caminho de rede de IP público.

./alloydb-auth-proxy CONNECTION_URI --public-ip

Substitua CONNECTION_URI pelo URI de conexão da instância que você recebeu em Recuperar o URI de conexão da instância.

Quando o proxy de autenticação do AlloyDB é iniciado, o terminal mostra que ele está detectando conexões TCP locais na porta 5432:

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

Conecte-se ao banco de dados usando psql

Enquanto o proxy de autenticação do AlloyDB estiver em execução, abra uma janela de terminal separada no laptop para se conectar ao banco de dados.

Execute a ferramenta cliente psql, segmentando o endereço do listener local 127.0.0.1 e a porta 5432:

psql -h 127.0.0.1 -U postgres -d postgres

Quando solicitado, digite a senha do usuário do banco de dados postgres.

O comando psql se conecta ao cliente do proxy de autenticação, que encaminha sua conexão por um túnel seguro para a instância do AlloyDB. O comando psql mostra um prompt, confirmando que seu laptop está conectado com segurança à instância do AlloyDB:

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

A seguir