Conectar-se ao AlloyDB do Cloud Shell usando o proxy de autenticação

Saiba como estabelecer uma conexão segura com sua instância do AlloyDB para PostgreSQL em um terminal do Cloud Shell usando o proxy de autenticação do AlloyDB. Este início rápido é adequado para novos usuários que querem um ambiente simples e pré-configurado para se conectar à instância e testar consultas SQL básicas.

Antes de começar

  1. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .

    Acessar o seletor de projetos

  2. Verifique se o faturamento foi ativado para o projeto Google Cloud . A verificação do faturamento ativa todos os serviços necessários.

  3. Verifique se você tem uma instância do AlloyDB configurada para IP público. O Cloud Shell não pode se conectar a um endereço IP particular.

Funções exigidas

Para usar o proxy de autenticação, sua conta de usuário precisa ter os seguintes papéis do Identity and Access Management (IAM):

Se você não tiver os papéis necessários, peça ao administrador para conceder os papéis ou siga estas etapas para conceder à sua conta de usuário.

  1. No console do Google Cloud , acesse a página IAM.

    Acessar IAM

  2. Encontre sua conta de usuário na lista de principais.

  3. Clique em Editar principal.

  4. Clique em Adicionar outro papel.

  5. Pesquise e selecione o papel Cliente do AlloyDB.

  6. Clique em Aplicar.

  7. Clique em Adicionar outro papel.

  8. Pesquise e selecione o papel Consumidor do Service Usage.

  9. Clique em Aplicar.

  10. Clique em Salvar.

Conectar-se à instância do AlloyDB

O ambiente do Cloud Shell inclui o proxy de autenticação (alloydb-auth-proxy) e o psql, o terminal interativo do PostgreSQL.

  1. Ative o Cloud Shell.

    Ativar o Cloud Shell

  2. Clique em Autorizar o Cloud Shell. Você só precisa fazer isso na primeira vez que usar o Cloud Shell.

  3. Confirme sua identidade de usuário no editor do Cloud Shell. Verifique se você fez login com a conta de usuário que tem os papéis do IAM necessários.

    gcloud config list

  4. Receba o URI de conexão da sua instância.

    1. No Google Cloud console, acesse a página Clusters.

      Acessar Clusters

    2. Selecione o cluster e encontre a instância principal.

    3. Clique em Visualizar configuração de conectividade.

    4. Copie o URI de conexão.

  5. Inicie o proxy de autenticação. No terminal do Cloud Shell, use o URI copiado e especifique a flag --public-ip.

    alloydb-auth-proxy CONNECTION_URI --public-ip

    Substitua:

    • CONNECTION_URI: o URI de conexão que você copiou do console Google Cloud .

    O proxy de autenticação é iniciado e mostra uma mensagem confirmando que ele está escutando em 127.0.0.1:5432.

  6. Abra uma nova guia do Cloud Shell e conecte-se ao banco de dados usando o psql.

    psql "host=localhost user=POSTGRES_USERNAME dbname=POSTGRES_DATABASE port=5432"

    Para abrir um novo painel de terminal na janela atual do Cloud Shell, pressione Control+b+" ou clique em Adicionar. Isso permite manter o proxy do Auth em execução em um painel enquanto você executa comandos de conexão no segundo painel.

    Para alternar entre painéis, pressione Control+b+keyboard_arrow_up ou Control+b+keyboard_arrow_down.

    Substitua:

    • POSTGRES_USERNAME: seu usuário do AlloyDB, normalmente postgres.
    • POSTGRES_DATABASE: o nome do banco de dados do AlloyDB, normalmente postgres.

  7. Quando solicitado, digite a senha do usuário do PostgreSQL.

  8. Verifique a conexão executando uma consulta SQL.

    SELECT now();

  9. Para interromper o psql, digite \q.

  10. Para interromper o Cloud Shell, digite exit.

  11. Para interromper o Auth Proxy, digite Control+c.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

  1. No console Google Cloud , acesse a página Clusters.

    Acessar Clusters

  2. Clique no cluster que você criou.

  3. Clique em Excluir cluster.

  4. Na caixa de diálogo de confirmação, insira o ID do cluster e clique em Excluir para excluir o cluster e as instâncias dele.

A seguir