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

Para se conectar à instância do AlloyDB para PostgreSQL e executar consultas SQL em um terminal de navegador pré-configurado sem instalar ferramentas de cliente locais, use o Cloud Shell e o proxy de autenticação do AlloyDB.

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 . Verificar o 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 concedê-los à 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 shell do Cloud Shell inclui o Auth Proxy (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. Isso só é necessário na primeira vez que você usa 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. Consiga o URI de conexão da instância:

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

      Acessar Clusters

    2. Selecione o cluster e encontre a instância primária.

    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 do Google Cloud .

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

  6. Abra uma nova guia do Cloud Shell e conecte-se ao banco de dados usando 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 Adicionar. Isso permite que você mantenha o proxy de autenticação em execução em um painel enquanto executa comandos de conexão no segundo painel.

    Para alternar entre os 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 psql, digite \q.

  10. Para interromper o Cloud Shell, digite exit.

  11. Para interromper o proxy de autenticação, pressione 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 do 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