Guia de início rápido para usar o proxy do Cloud SQL Auth

Nesta página, você verá como se conectar ao Cloud SQL de um ambiente de teste local usando o proxy do Cloud SQL Auth. Com uma conexão do proxy do Cloud SQL Auth, é 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 do Cloud SQL Auth para um ambiente de produção. Para mais opções de conexão, consulte Como se conectar usando o proxy do Cloud SQL Auth.

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 IAM diferente de Cloud SQL Viewer. Caso contrário, configure o proxy do Cloud SQL Auth usando as instruções descritas em Como se conectar pelo proxy do Cloud SQL Auth.
  • Instalar um 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 Admin

  • 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 proxy do Cloud SQL Auth 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. Para fazer o download do proxy do Cloud SQL Auth:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. Para tornar o proxy do Cloud SQL Auth executável:
    chmod +x cloud_sql_proxy
    

Linux de 32 bits

  1. Para fazer o download do proxy do Cloud SQL Auth:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. Para tornar o proxy do Cloud SQL Auth executável:
    chmod +x cloud_sql_proxy
    

macOS de 64 bits

  1. Para fazer o download do proxy do Cloud SQL Auth:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
    
  2. Para tornar o proxy do Cloud SQL Auth executável:
    chmod +x cloud_sql_proxy
    

macOS de 32 bits

  1. Para fazer o download do proxy do Cloud SQL Auth:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. Para tornar o proxy do Cloud SQL Auth executável:
    chmod +x cloud_sql_proxy
    

Windows de 64 bits

Para fazer o download do proxy do Cloud SQL Auth, 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 do Cloud SQL Auth, 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.

Imagem do Docker do proxy do Cloud SQL Auth

Por conveniência, a equipe do Cloud SQL mantém várias imagens de contêiner que contêm o proxy do Cloud SQL Auth para uso pelos nossos clientes. Para mais informações sobre essas imagens, consulte o repositório do proxy do Cloud SQL Auth no GitHub. É possível extrair a imagem mais recente na sua máquina local usando o Docker com o seguinte comando:
docker pull gcr.io/cloudsql-docker/gce-proxy:1.19.1

Outros SOs

Para outros sistemas operacionais não incluídos aqui, compile o proxy do Cloud SQL Auth da origem.

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 do Cloud SQL Auth

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 do Cloud SQL Auth, 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 do mysql é exibido, e uma mensagem semelhante à seguinte está no terminal do proxy do Cloud SQL Auth:

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

Limpeza

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