Associe um cliente psql a uma instância

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

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

  1. Crie uma VM do Compute Engine que possa estabelecer ligação a instâncias do AlloyDB através do acesso a serviços privados.
  2. Instale o cliente psql na VM do Compute Engine.
  3. Obtenha o endereço IP da instância do AlloyDB à qual quer estabelecer ligação.
  4. Execute o cliente psql.

As duas primeiras destas tarefas são operações únicas. Depois de criar uma VM do Compute Engine e instalar o cliente psql na mesma, pode continuar a usar a VM para se ligar a instâncias do AlloyDB executando as tarefas restantes.psql

Antes de começar

  • O Google Cloud projeto que está a usar tem de ter sido ativado para aceder ao AlloyDB.
  • Uma rede VPC no Google Cloud projeto que está a usar já tem de estar configurada para acesso privado aos serviços do AlloyDB.
  • Tem de ter uma destas funções de IAM no Google Cloud projeto que está a usar:
    • roles/alloydb.admin (a função IAM predefinida de administrador do AlloyDB)
    • roles/owner (a função de IAM básica de proprietário)
    • roles/editor (a função de IAM básica de editor)

    Se não tiver nenhuma destas funções, contacte o administrador organizacional para pedir acesso.

  • Se o anfitrião do cliente tiver uma firewall, tem de permitir ligações de saída à porta 5432 nos endereços IP das suas instâncias do AlloyDB.

Crie uma VM do Compute Engine

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceder às instâncias de VM

  2. Selecione o projeto que contém a instância do AlloyDB à qual quer estabelecer ligação.
  3. Clique em Criar instância.
  4. Clique na secção Configuração da máquina.
  5. Introduza um nome para a instância.
  6. Configure a região e a zona onde quer criar a instância.
  7. Selecione uma série de máquinas e o tipo de máquina correspondente.
  8. Mantenha os valores predefinidos na secção SO e armazenamento.
  9. Clique na secção Redes e defina Interfaces de rede para a rede VPC configurada para o acesso a serviços privados do AlloyDB.
    Se Interfaces de rede não estiver definido para a rede VPC configurada para o acesso a serviços privados, expanda-o e, em seguida, defina Rede para a rede VPC.
  10. Mantenha os valores predefinidos na secção Observability.
  11. Clique na secção Segurança.
  12. Em Identidade e acesso à API, defina os Âmbitos de acesso como Permitir acesso total a todas as APIs Google Cloud.
  13. Mantenha os valores predefinidos na secção Avançadas.
  14. Clique em Criar.

Depois de criar a VM, estabeleça ligação à VM do Compute Engine que criou através do SSH.

Instale a ferramenta de cliente psql

  1. Estabeleça ligação à VM do Compute Engine que criou através de SSH.

    Consola

    1. Na Google Cloud consola, aceda à página Instâncias de VM.

      Aceder às instâncias de VM

    2. Na lista de instâncias de máquinas virtuais, clique em SSH na linha da instância que criou.

    gcloud

    Use o comando gcloud compute ssh para se ligar à instância que criou.

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

    Substitua o seguinte:

    • 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 a partir do gestor de pacotes: 
    sudo apt-get update
sudo apt-get install postgresql-client

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

Para obter o endereço IP da instância do AlloyDB à qual quer estabelecer ligação, veja as definições dessa instância.

Execute o cliente psql

  1. Estabeleça ligação à VM que criou através do SSH.

    Consola

    1. Na Google Cloud consola, aceda à página Instâncias de VM.

      Aceder às instâncias de VM

    2. Na lista de instâncias de máquinas virtuais, clique em SSH na linha da instância que criou.

    gcloud

    Use o comando gcloud compute ssh para se ligar à instância que criou.

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

    Substitua o seguinte:

    • 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 cliente psql: 
    psql -h IP_ADDRESS -U USERNAME -d postgres

    É-lhe pedido que introduza a palavra-passe do utilizador USERNAME.

    Se estiver a estabelecer a ligação pela primeira vez, especifique postgres para o USERNAME e a base de dados. O comando tem o seguinte aspeto:

    psql -h IP_ADDRESS -U postgres -d postgres

    Use a palavra-passe que definiu quando criou o cluster.