Conectar-se ao Cloud SQL para MySQL usando o proxy de autenticação do Cloud SQL

Conectar-se ao Cloud SQL para MySQL usando o proxy de autenticação do Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

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.

As instruções nesta página são apenas para um ambiente de teste e não podem ser usadas em ambientes de produção. Para mais informações sobre a configuração necessária para ambientes de produção, consulte Usar o proxy do Cloud SQL Auth em um ambiente de produção e Conectar-se usando o proxy do Cloud SQL Auth.

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.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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 (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 (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. Ative as APIs do Google Cloud necessárias.

   Console

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

   Acesse APIs

   Ative a API Cloud SQL Admin.

   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

2. Make sure that you have the following role or roles on the project: Cloud SQL Admin (roles/cloudsql.admin)

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
   2. Selecione o projeto.
   3. Clique em Conceder acesso.

   4. No campo Novos principais, digite seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

   5. Na lista Selecionar papel, escolha um.
   6. Para conceder outros papéis, adicione-os clicando em Adicionar outro papel.
   7. Clique em Salvar.

crie uma instância do Cloud SQL

Neste guia de início rápido, você usa o console Google Cloud . Para usar a CLI gcloud, o cURL ou o PowerShell, consulte Criar instâncias.

1. No console 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 Escolher MySQL.
4. No campo ID da instância, insira myinstance.
5. No campo Senha, insira uma senha para o usuário root.

6. Clique em Criar instância.

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

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

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 de autenticação do Cloud SQL

O binário do proxy de autenticação do Cloud SQL a ser baixado depende do sistema operacional e do uso de 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 uname -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 de autenticação do Cloud SQL:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.18.2/cloud-sql-proxy.linux.amd64

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 de autenticação do Cloud SQL:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.18.2/cloud-sql-proxy.linux.386

2. Se o comando curl não for encontrado, execute sudo apt install curl 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 de autenticação do Cloud SQL:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.18.2/cloud-sql-proxy.darwin.amd64

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

   chmod +x cloud-sql-proxy

Mac M1

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

     curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.18.2/cloud-sql-proxy.darwin.arm64
     

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://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.18.2/cloud-sql-proxy.x64.exe e selecione Salvar link como para fazer o download do proxy de autenticação do Cloud SQL. Renomeie o arquivo para cloud-sql-proxy.exe.

Windows de 32 bits

Clique com o botão direito do mouse em https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.18.2/cloud-sql-proxy.x86.exe e selecione Salvar link como para fazer o download do proxy de autenticação do Cloud SQL. Renomeie o arquivo para cloud-sql-proxy.exe.

Imagem Docker do proxy do Cloud SQL Auth

O proxy do Cloud SQL Auth tem imagens de contêiner diferentes, como distroless, alpine e buster. A imagem de contêiner padrão do proxy do Cloud SQL Auth usa distroless, que não contém shell. Se você precisar de um shell ou de ferramentas relacionadas, faça o download de uma imagem baseada em alpine ou buster. Para mais informações, consulte Imagens de contêiner do proxy do Cloud SQL Auth.

Você pode extrair a imagem mais recente para sua máquina local usando o Docker usando o seguinte comando:

docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.18.2

Observação: o proxy do Cloud SQL Auth usa um repositório que oferece suporte ao domínio gcr.io, mas disponibiliza imagens do Artifact Registry. Para mais informações, consulte Transição do Container Registry.

Outros SOs

Para outros sistemas operacionais não incluídos aqui, compile o proxy do Cloud SQL Auth a partir do código-fonte.

Conseguir o nome da conexão da instância

1. No console 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 INSTANCE_CONNECTION_NAME

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

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

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

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.

A seguir

• Confira como solucionar problemas com informações sobre o proxy de autenticação do Cloud SQL.

• Saiba mais sobre o proxy do Cloud SQL Auth.

• Saiba mais sobre outras opções de conexão.