Conectar um cliente psql a uma instância

Esta página descreve como conectar a ferramenta de cliente psql a uma instância do AlloyDB.

O procedimento para conectar psql a uma instância do AlloyDB envolve estas tarefas:

  1. Crie uma VM do Compute Engine que possa se conectar a instâncias do AlloyDB usando o acesso a serviços particulares.
  2. Instale o cliente psql na VM do Compute Engine.
  3. Conseguir o endereço IP da instância do AlloyDB à qual você quer se conectar.
  4. Execute o cliente psql.

As duas primeiras dessas tarefas são operações únicas. Depois de criar uma VM do Compute Engine e instalar o cliente psql nela, você pode continuar usando a VM para conectar psql às instâncias do AlloyDB executando as tarefas restantes.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • Uma rede VPC no projeto do Google Cloud que você está usando já precisa estar configurada para acesso a serviços particulares ao 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.

  • Se o host do cliente tiver um firewall, ele precisará permitir conexões de saída para a porta 5432 nos endereços IP das instâncias do AlloyDB.

Criar uma VM do Compute Engine

  1. No console do Google Cloud, acesse a página Instâncias de VMs.

    Acessar instâncias de VM

  2. Selecione o projeto que contém a instância do AlloyDB à qual você quer se conectar.
  3. Clique em Criar instância.
  4. Clique na seção Configuração da máquina.
  5. Digite um Nome para a instância.
  6. Configure a região e a zona em que você quer criar a instância.
  7. Selecione uma série de máquinas e o tipo de máquina correspondente.
  8. Mantenha os valores padrão na seção SO e armazenamento.
  9. Clique na seção Rede e defina Interfaces de rede como a rede VPC configurada para acesso a serviços particulares ao AlloyDB.
    Se a opção Network interfaces não estiver definida como a rede VPC configurada para o acesso a serviços particulares, abra-a e defina Network como a rede VPC.
  10. Mantenha os valores padrão na seção Observability.
  11. Clique na seção Segurança.
  12. Em Identidade e acesso à API, defina os Escopos de acesso como Permitir acesso total a todas as APIs do Cloud.
  13. Mantenha os valores padrão na seção Avançado.
  14. Clique em Criar.

Depois que a VM for criada, conecte-se a ela usando o SSH.

Instalar a ferramenta de cliente psql

  1. Conecte-se à VM do Compute Engine criada usando SSH.

    Console

    1. No console do Google Cloud, acesse a página Instâncias de VMs.

      Acessar instâncias de VM

    2. Na lista de instâncias de máquina virtual, clique em SSH na linha da instância que você criou.

    gcloud

    Use o comando gcloud compute ssh para se conectar à instância criada.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto que contém a instância.
    • ZONE: o nome da zona em que a instância está localizada.
    • VM_NAME: o nome da instância.
  2. Instale o cliente psql do gerenciador de pacotes: 
    sudo apt-get update
sudo apt-get install postgresql-client

Acessar o endereço IP da instância do AlloyDB

Para conferir o endereço IP da instância do AlloyDB à qual você quer se conectar, confira as configurações dela.

Executar o cliente psql

  1. Conecte-se à VM criada usando SSH.

    Console

    1. No console do Google Cloud, acesse a página Instâncias de VMs.

      Acessar instâncias de VM

    2. Na lista de instâncias de máquina virtual, clique em SSH na linha da instância que você criou.

    gcloud

    Use o comando gcloud compute ssh para se conectar à instância criada.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto que contém a instância.
    • ZONE: o nome da zona em que a instância está localizada.
    • VM_NAME: o nome da instância.
  2. Execute a ferramenta de cliente psql: 
    psql -h IP_ADDRESS -U USERNAME

    Será necessário inserir a senha do usuário USERNAME.

    Se você estiver se conectando pela primeira vez, use o valor padrão postgres para USERNAME e a senha que você usou ao criar o cluster para PASSWORD.