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. O proxy do Cloud SQL Auth fornece acesso seguro à instância do Cloud SQL sem a necessidade de redes autorizadas ou de configuração do SSL. Ao usar o proxy do Cloud SQL Auth, é possível se conectar à instância do Cloud SQL com segurança.

Não use estas instruções para configurar o proxy do Cloud SQL Auth para um ambiente de produção. Além disso, para mais opções de conexão com autenticação e uso do proxy, consulte Como se conectar usando o proxy do Cloud SQL Auth.

Crie o projeto

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

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, 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.
  2. 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

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. 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

  5. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  6. Verifique se você tem o papel "Cliente do Cloud SQL" na conta de usuário.

    Acessar a página IAM

  7. Ative a API Cloud SQL Admin.

    Ative a API

crie uma instância do Cloud SQL

Neste procedimento, você usa o Console do Google Cloud. Para usar a ferramenta de linha de comando gcloud, cURL ou PowerShell, consulte Como criar instâncias.

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

    Acesse "Instâncias do Cloud SQL"

  2. Clique em Criar instância.
  3. Clique em MySQL.
  4. Se você receber uma solicitação para ativar a API Compute, clique no botão Ativar API.
  5. Insira myinstance para o ID da instância.
  6. Digite a senha do usuário raiz.
  7. Use os valores padrão dos outros campos.
  8. Clique em Criar.

    Você retorna à lista de instâncias. É possível clicar na nova instância imediatamente para ver os detalhes, mas ela não estará disponível até que seja inicializada.

    Observação: nesse exemplo, a instância é criada usando configurações padrão, incluindo um endereço IP público.

Instalar um cliente MySQL.

  1. Faça o download do MySQL Community Server referente à sua plataforma da página de downloads do MySQL Community Server (em inglês).
    O Community Server inclui o cliente MySQL.
  2. Instale o Community Server, seguindo as instruções na página de downloads.

Para mais informações sobre a instalação do MySQL, consulte Como instalar e fazer upgrade do MySQL.

Instalar o cliente do proxy do Cloud SQL Auth

É 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 tiver certeza se a máquina está executando um kernel de 32 ou 64 bits, use o comando name -a para Linux ou macOS. Para o Windows, consulte a documentação do Windows.

Linux de 64 bits

  1. Faça o download do proxy do Cloud SQL Auth:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. Torne o proxy do Cloud SQL Auth executável:
    chmod +x cloud_sql_proxy
    

Linux de 32 bits

  1. Faça o download do proxy do Cloud SQL Auth:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. Se o comando wget não for encontrado, execute sudo apt-get install wget e repita o comando de download.
  3. Torne o proxy do Cloud SQL Auth executável:
    chmod +x cloud_sql_proxy
    

macOS de 64 bits

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

macOS de 32 bits

  1. Faça o download do proxy do Cloud SQL Auth:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. Torne o proxy do Cloud SQL Auth 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 do Cloud SQL Auth. Renomeie o arquivo para 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 do Cloud SQL Auth. Renomeie o arquivo para cloud_sql_proxy.exe.

Imagem do Docker do proxy do Cloud SQL Auth

Por conveniência, várias imagens de contêiner que contêm o proxy do Cloud SQL Auth estão disponíveis no GitHub no repositório do proxy do Cloud SQL Auth. É 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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Na seção Conectar-se a esta instância, copie o Nome da conexão. O nome da conexão está no formato projectID:region:instanceID.

Iniciar o proxy do Cloud SQL Auth

Inicie o proxy do Cloud SQL Auth em um terminal próprio para você monitorar a saída. Substitua INSTANCE_CONNECTION_NAME pelo nome da conexão da instância copiado no passo anterior.

Para ambientes Linux, use este comando para iniciar o proxy do Cloud SQL Auth:

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306

No PowerShell no Windows, use este comando para iniciar o proxy do Cloud SQL:

.\cloud_sql_proxy.exe -instances=INSTANCE_CONNECTION_NAME=tcp:3306

Você verá uma mensagem semelhante a esta:

Listening on 127.0.0.1:3306 for INSTANCE_CONNECTION_NAME
Ready for new connections

Execute este comando:

mysql -u root -p --host 127.0.0.1 --port 3306

No prompt Enter password:, insira a senha da sua conta de usuário raiz do MySQL.

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

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

Limpeza

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

    Acesse "Instâncias do Cloud SQL"

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

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

A seguir