Guia de início rápido do uso do proxy em testes locais

MySQL   |  PostgreSQL

Nesta página, ensinamos como se conectar ao Cloud SQL a partir de um ambiente de teste local usando o Cloud SQL Proxy. Com uma conexão por meio do proxy, é possível testar um aplicativo do App Engine no ambiente local ou, ainda, estabelecer uma conexão segura para a administração do banco de dados.

Não use estas instruções para configurar o proxy para um ambiente de produção. Para mais opções de conexão, consulte Opções de conexão para aplicativos externos.

Antes de começar

Antes de executar as etapas neste guia de início rápido, conclua as tarefas a seguir:

• Crie um projeto do GCP e uma instância de segunda geração.
• Se você estiver usando um projeto atual, verifique se o usuário do GCP é proprietário do projeto ou tem um papel do Cloud SQL que não seja Cloud SQL Viewer. Caso contrário, configure o proxy usando as instruções descritas em Conectar-se pelo Cloud SQL Proxy.

• Se quiser, instale o cliente mysql.

  O cliente permite testar a conexão com a instância. O cliente mysql é instalado com o pacote do servidor. Alguns sistemas operacionais aceitam pacotes apenas de cliente. Veja as instruções de instalação do MySQL.

Ativar a API Cloud SQL

Ative a(s) Administrador do Cloud SQL API necessária(s).

Ativar a(s) API

Instalar e autenticar a ferramenta de linha de comando gcloud

1. Se ainda não o fez, instale a ferramenta de linha de comando gcloud.

   Ver as instruções de instalação do gcloud.

2. Inicialize a ferramenta gcloud:

   gcloud init
   

3. Autentique a ferramenta gcloud:

   gcloud auth login
   

Instalar o cliente do Cloud SQL Proxy na máquina local

É necessário fazer o download do binário de proxy equivalente a seu sistema operacional, dependendo se ele usa um kernel de 32 ou 64 bits. Os modelos de hardware mais recentes usam kernel de 64 bits. Se você não souber se a máquina executa um kernel de 64 bits, use o comando uname -a no Linux ou macOS ou clique em Computador > Propriedades no menu "Iniciar" do Windows.

Linux de 64 bits

1. Faça o download do proxy:

   wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
   

2. Torne o proxy executável:

   chmod +x cloud_sql_proxy
   

Linux de 32 bits

1. Faça o download do proxy:

   wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
   

2. Torne o proxy executável:

   chmod +x cloud_sql_proxy
   

macOS de 64 bits

1. Faça o download do proxy:

   curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
   

2. Torne o proxy executável:

   chmod +x cloud_sql_proxy
   

macOS de 32 bits

1. Faça o download do proxy:

   curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
   

2. Torne o proxy executável:

   chmod +x cloud_sql_proxy
   

Windows de 64 bits

Clique com o botão direito do mouse em https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe e selecione Salvar link como para fazer o download do proxy. Renomeie o arquivo como cloud_sql_proxy.exe.

Windows de 32 bits

Clique com o botão direito do mouse em https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe e selecione Salvar link como para fazer o download do proxy. Renomeie o arquivo como cloud_sql_proxy.exe.

Se o seu sistema operacional não estiver incluído aqui, compile o proxy a partir da fonte (em inglês).

Conseguir o nome da conexão da instância

1. Acesse a página "Instâncias do Cloud SQL" no Console do Google Cloud Platform.

   Acessar a página "Instâncias do Cloud SQL"

2. Clique no nome da instância para abrir a página Detalhes da instância.

3. Em Conectar-se a esta instância, anote o Nome da conexão da instância.

   Você usará esse valor na próxima etapa.

Iniciar o proxy

Inicie o proxy no próprio terminal para que você possa monitorar a saída. Substitua <INSTANCE_CONNECTION_NAME> pelo nome da conexão da instância copiada na etapa anterior.

./cloud_sql_proxy -instances=<INSTANCE_CONNECTION_NAME>=tcp:3306

Você verá uma mensagem semelhante a:

Listening on 127.0.0.1:3306 for myproject:us-central1:myinstance".
Ready for new connections

Conectar-se ao banco de dados usando o cliente mysql

Esta etapa é opcional, mas recomendamos que você a realize para testar a conexão. Veja as instruções de instalação do MySQL.

Em uma janela de terminal diferente daquela em que você iniciou o proxy, execute o seguinte comando substituindo <USERNAME> pelo seu nome de usuário do MySQL.

mysql -u <USERNAME> -p --host 127.0.0.1 --port 3306

Você verá o prompt do mysql, e uma mensagem semelhante ao exemplo abaixo aparecerá no terminal do proxy:

New connection for "myproject:us-central1:myinstance"

Próximas etapas

• Veja informações sobre solução de problemas do proxy.
• Saiba mais sobre o proxy.
• Saiba mais sobre outras opções de conexão.