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

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 em 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 realizar as etapas neste guia de início rápido, conclua as tarefas a seguir:

  • Crie um projeto do Google Cloud e uma instância do Cloud SQL.
  • Se você estiver usando um projeto atual, verifique se o usuário do Google Cloud é 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 Como se conectar pelo Cloud SQL Proxy.
  • Outra opção é instalar o cliente mysql.

    O cliente permite testar a conexão com a instância. É possível instalar o cliente mysql 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 Admin

Ative a API

Instalar e autenticar a ferramenta de linha de comando gcloud

  1. Se ainda não tiver feito isso, instale a ferramenta de linha de comando gcloud.

    Veja as instruções de instalação da 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. Caso você não saiba se a máquina executa um kernel de 64 bits, use o comando uname -a para 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

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

Windows de 32 bits

Para fazer o download do proxy, clique com o botão direito em https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe e selecione Salvar link como. Renomeie o arquivo para cloud_sql_proxy.exe.
Caso seu sistema operacional não esteja incluído aqui, compile o proxy a partir da fonte.

Conseguir o nome da conexão da instância

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

    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.

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 copiado no passo anterior.

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

Você verá uma mensagem semelhante a esta:

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 seção é opcional, mas é recomendada para testar sua conexão. Veja as instruções de instalação do MySQL.

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

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

O prompt mysql é exibido, e uma mensagem semelhante à seguinte estará no terminal do proxy:

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

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.
    Acessar a página "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 myinstance e clique em Excluir para excluir a instância.

    Após a exclusão da instância, o respectivo nome não poderá ser usado por aproximadamente sete dias.

A seguir