Conectar-se a uma instância do Cloud SQL para PostgreSQL com IP particular

Conectar-se a uma instância do Cloud SQL para PostgreSQL com IP particular

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, mostramos como criar e se conectar a uma instância do PostgreSQL usando um IP particular. Os recursos criados neste guia de início rápido normalmente custam menos do que um dólar, supondo que você conclua as etapas, incluindo a limpeza, em tempo hábil.

---

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientação:

Orientações

---

Antes de começar

Observação: o nome usado para seu projeto precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que pode ser editado. O ID do projeto precisa ter entre 6 e 30 caracteres, com uma letra minúscula como primeiro caractere. É possível usar um traço, uma letra minúscula ou um dígito para os caracteres restantes, mas o último caractere não pode ser um traço.

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Verifique se você tem as permissões necessárias para concluir este guia de início rápido.
2. Ative as APIs Google Cloud necessárias.

   Console

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

   Acesse APIs

   Ative a API Cloud SQL Admin. Ao ativar essa API, é possível executar o proxy do Cloud SQL Auth.

   gcloud

   Clique no botão a seguir para abrir o Cloud Shell, que fornece acesso de linha de comando aos seus recursos do Google Cloud diretamente no navegador. O Cloud Shell pode ser usado para executar os comandos gcloud apresentados neste guia de início rápido.

   Abra o Cloud Shell

   Execute o comando gcloud services enable da seguinte maneira usando o Cloud Shell para ativar as APIs necessárias para este guia de início rápido:

   gcloud services enable sqladmin.googleapis.com

   Esse comando ativa as seguintes APIs:

   • API Cloud SQL Admin. Ao ativar essa API, é possível executar o proxy do Cloud SQL Auth.

Funções exigidas

Para receber as permissões necessárias para configurar o Cloud SQL com um endereço IP particular, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto que você quer configurar e conectar:

• Criar ou excluir uma instância, um banco de dados e um usuário: Função de administrador do Cloud SQL (roles/cloudsql.admin).
• Criar ou excluir uma conta de serviço do IAM: Papel de administrador da conta de serviço do IAM (roles/iam.serviceAccountAdmin).
• Criar ou excluir uma instância de computação:
  • Função de administrador do Compute (roles/compute.admin)
  • Função de administrador de instâncias de computação (roles/compute.instanceAdmin.v1).
• Crie uma conexão:
  • Administrador da Rede de Serviço (roles/servicenetworking.networksAdmin))
  • Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin).

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Visão geral

Há muitas maneiras de se conectar a uma instância do Cloud SQL com um endereço IP particular, dependendo de onde a origem está localizada. O principal fator é que a máquina de origem precisa estar na mesma rede VPC que a instância do Cloud SQL. Se a origem não estiver em Google Cloud ou no mesmo projeto Google Cloud , será necessário configurar a conectividade de maneira diferente da mostrada aqui.

Neste guia de início rápido, configuramos a conectividade pelo caminho mais direto. A origem e o destino estão no mesmo projeto Google Cloud e na mesma rede VPC. Criamos uma instância do Cloud SQL com um endereço IP particular (o destino) e uma VM do Compute Engine (a origem). Usamos a VM para instalar e usar as ferramentas necessárias para se conectar da VM à instância do Cloud SQL.

Execute estas ações:

1. Crie um banco de dados do Cloud SQL com um endereço IP particular.

   Encontre e salve o connection name da instância para uso posterior.

2. Crie uma VM do Compute Engine.
3. Abra duas conexões SSH com a VM do Compute Engine.

   Você usará a primeira janela para instalar o psql e instalar e iniciar o proxy do Cloud SQL Auth. Depois, use a segunda janela para se conectar à instância do Cloud SQL conectando-se ao proxy do Cloud SQL Auth.

4. Na janela SSH 1, faça o seguinte:
   1. Instale o cliente psql.
   2. Instalar o proxy do Cloud SQL Auth.

      O proxy do Cloud SQL Auth atua como um conector entre o cliente psql e a instância do Cloud SQL.

   3. Inicie o proxy do Cloud SQL Auth.

      Se tudo der certo, o proxy do Cloud SQL Auth detectará solicitações de conexão.

5. Na janela SSH 2, conecte-se à instância do Cloud SQL fazendo com que o cliente psql se conecte ao proxy do Cloud SQL Auth.

   Se tudo der certo, você verá o prompt psql nessa janela e uma mensagem de conexão na janela SSH 1, em que o proxy do Cloud SQL Auth estará em execução.

6. Limpeza.

Criar uma instância do Cloud SQL com um endereço IP particular.

Para criar uma instância que usa conexões de IP particular, faça o seguinte:

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

   Acesse "Instâncias do Cloud SQL"

2. Selecione a guia "PostgreSQL" e clique em Criar instância do Sandbox na caixa Sandbox. Como alternativa, clique em Criar instância e faça o seguinte:
1. Clique em Escolher PostgreSQL.
2. Selecione a edição Enterprise.
3. Escolha a predefinição Sandbox.
3. Se você receber uma solicitação para ativar a API Compute, clique no botão Ativar API.
4. Na seção Informações da instância, insira um nome para o ID da instância.
5. Insira uma senha para o usuário postgres. Anote a senha criada porque você precisará dela mais tarde.
6. Na seção Escolher região e disponibilidade por zona, selecione a opção Zona única.
7. Expanda Mostrar opções de configuração.
8. Expanda Conexões.
9. Desmarque IP público.
10. Selecione IP privado.
11. Selecione Acesso a serviços particulares (PSA).
12. No menu suspenso Rede VPC, selecione padrão.
13. Se você estiver usando um novo projeto, a mensagem A conexão de rede não está configurada vai aparecer, e uma caixa intitulada Confirmação de configuração de rede necessária vai direcionar você para Documentação da VPC para configurar o PSA.
1. No console do Google Cloud , acesse a página Redes VPC:

   Acessar redes VPC

2. Selecione a rede VPC padrão.
3. Defina uma regra de firewall que permita o acesso à porta TCP 22:
1. Selecione a guia Firewall.
2. Em Regras de firewall da VPC, selecione Criar regra de firewall da VPC.
3. Dê um nome à regra de firewall.
4. Em Destinos, selecione Todas as instâncias na rede.
5. Em Intervalos IPv4 de origem, insira 0.0.0.0/0.
6. Em Protocolos e portas, marque TCP e, na caixa Portas logo abaixo, insira 22.
7. Selecione Criar.
4. Alocar um intervalo de endereços IP:
1. Selecione a guia Acesso a serviços particulares.
2. Na guia Acesso a serviços particulares, selecione a guia Intervalos de IP alocados para serviços.
3. Clique em Alocar intervalo de IP.
4. Insira um Nome e, opcionalmente, uma Descrição para o intervalo alocado.
5. Para permitir que o Google selecione um intervalo disponível, selecione Automático.
6. Insira um comprimento de prefixo entre 16 e 124. O número de endereços alocados é igual a 2 elevado a (32 - comprimento do prefixo).
7. Clique em Alocar para criar o intervalo alocado.
5. Criar uma conexão particular:
1. Na guia Acesso a serviços particulares, mude para a guia Conexões particulares com serviços.
2. Clique no botão Criar conexão.
3. No menu suspenso Alocação atribuída da caixa Criar uma conexão particular, selecione o nome do intervalo de endereços IP que você acabou de criar.
4. Clique em Conectar.
6. Quando a conexão for criada, volte para onde você estava criando a instância do Cloud SQL e clique em Confirmar conexão.
14. Quando a conexão do PSA for criada, clique em Criar instância.

Você será levado para a página de visão geral da instância enquanto a nova instância é criada.

Depois que a criação da instância for concluída, role até a seção Conectar-se a esta instância e salve o Nome da conexão da instância. O connection name está no formato projectID:region:instanceID. Você vai usar esse connection name mais tarde ao iniciar o proxy de autenticação do Cloud SQL.

Criar um banco de dados

Para criar um banco de dados, selecione Bancos de dados no painel de navegação à esquerda e faça o seguinte:

1. Selecione Criar banco de dados.
2. Insira um DB_NAME no campo Nome do banco de dados.
3. Clique em Criar.

Você vai usar esse db_name mais tarde ao se conectar usando o proxy do Cloud SQL Auth.

Criar uma VM do Compute Engine

Siga estas etapas para criar uma VM:

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

   Acessar Instâncias de VM

2. Clique em Criar instância.
3. Digite um Nome para a instância.
4. Selecione Proteção de dados no painel de navegação e clique em Nenhum backup.
5. Selecione Segurança no painel de navegação e, em Escopos de acesso, selecione Permitir acesso total a todas as APIs do Cloud.
6. Clique em Criar e aguarde a conclusão da criação da VM.

Abra duas conexões SSH com a VM do Compute Engine

Duas janelas são usadas na VM. A primeira janela é usada para instalar o cliente psql e o proxy do Cloud SQL Auth, conseguir o nome da conexão da instância e usar esse nome para iniciar o proxy. A segunda janela é usada para se conectar à instância do Cloud SQL pelo proxy.

1. Expanda o menu SSH na coluna Conectar da instância de VM do Compute Engine.
2. Selecione Abrir na janela do navegador para abrir a janela SSH 1.

   Pode levar alguns segundos para que o prompt na janela fique disponível para você.

3. Quando solicitado, insira pwd para verificar se você está no diretório /home/$USER.

   Além de instalar o cliente psql e o proxy do Cloud SQL Auth nesta janela, você iniciará o proxy do Cloud SQL Auth.

4. Selecione Abrir na janela do navegador novamente para abrir a janela SSH 2.

   Você usará essa janela para se conectar à sua instância do Cloud SQL.

Instalar o cliente psql

Use a janela SSH 1 nesta etapa.

Instale o cliente psql do gerenciador de pacotes:

sudo apt-get update
sudo apt-get install postgresql-client
  

Instalar o proxy do Cloud SQL Auth

Use a janela SSH 1 nesta etapa.

1. Instale wget:

   sudo apt-get install wget
       

2. Faça o download do proxy do Cloud SQL Auth:

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Torne o proxy do Cloud SQL Auth executável:

   chmod +x cloud-sql-proxy
     

Inicie o proxy do Cloud SQL Auth.

Use a janela SSH 1 nesta etapa.

Inicie o proxy do Cloud SQL Auth para poder monitorar a saída. Substitua INSTANCE_CONNECTION_NAME pelo connection name copiado ao criar a instância do Cloud SQL.

./cloud-sql-proxy --private-ip INSTANCE_CONNECTION_NAME

Observação:por padrão, o proxy de autenticação do Cloud SQL tenta se conectar à instância do Cloud SQL usando um endereço IPv4 público. Se a instância tiver apenas um IP particular ou tiver tanto o IP público quanto o privado configurados e você quiser que o proxy de autenticação do Cloud SQL use o endereço IP particular, forneça a opção --private-ip ao iniciar o proxy de autenticação do Cloud SQL.

Se você receber um erro informando que o endereço já está em uso, isso significa que uma instância local do banco de dados está em execução e precisa ser interrompida. Encontre o SERVICE_NAME executando o comando ps -ef | grep psql e, em seguida, execute o comando:

sudo service SERVICE_NAME stop
   

Quando o proxy do Cloud SQL Auth for iniciado, uma mensagem semelhante à seguinte será exibida na janela SSH:

Listening on 127.0.0.1:5432 for myInstance
Ready for new connections

Conectar-se à sua instância do Cloud SQL

Use a janela SSH 2 nesta etapa.

Execute o seguinte comando depois de substituir DB_NAME pelo nome do banco de dados do Cloud SQL:

psql "host=127.0.0.1 port=5432 sslmode=disable dbname=DB_NAME user=postgres"

No prompt "Inserir senha", insira a senha da conta do PostgreSQL.

Verifique se o prompt do PostgreSQL é exibido. Você se conectou ao banco de dados usando o cliente psql.

Volte para a janela do terminal em que você iniciou o proxy do Cloud SQL Auth. Você verá uma mensagem semelhante a esta:

New connection for myInstance

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 Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Selecione a instância do myinstance para abrir a página Detalhes da instância.
3. Na barra de ícones na parte superior da página, clique em Excluir.
4. Na janela Excluir instância, digite o nome da instância e clique em Excluir.

Etapas de limpeza opcionais

Se você não estiver usando as APIs que foram ativadas como parte deste guia de início rápido, é possível desativá-las.

• APIs que foram ativadas neste guia de início rápido:
  • API Cloud SQL Admin

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

   Acesse APIs

2. Selecione a API Cloud SQL Admin e clique no botão Desativar API.

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

   Acessar instâncias de VM

4. Selecione o nome da instância.

5. Selecione Excluir no menu Mais ações.

A seguir

Com base nas suas necessidades, é possível saber mais sobre como criar instâncias do Cloud SQL.

Também é possível aprender a criar usuários do PostgreSQL e bancos de dados para sua instância do Cloud SQL.

Além disso, é possível aprender a se conectar a uma instância do Cloud SQL usando outros aplicativos Google Cloud :

• Um aplicativo em execução no ambiente padrão do App Engine
• A partir de um aplicativo em execução no GKE
• no Cloud Run