Conectar-se ao Cloud SQL para SQL Server pelo Cloud Run

Conectar-se ao Cloud SQL para SQL Server pelo Cloud Run

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implantar um app de amostra no Cloud Run conectado a uma instância do SQL Server usando o Console do Google Cloud e um aplicativo do cliente.

Supondo que você conclua todas as etapas em tempo hábil, os recursos criados neste guia de início rápido normalmente custam menos de um dólar (USD).

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.

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

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Ative as APIs do Cloud necessárias para executar um app de amostra do Cloud SQL no Cloud Run.

   Console

   Clique em Ativar APIs para ativar as APIs necessárias para este guia de início rápido.

   Ative as APIs

   Isso permite as seguintes APIs:

   • API Compute Engine
   • API Cloud SQL Admin
   • API Cloud Run
   • API Container Registry
   • API Cloud Build
   • API Service Networking

   gcloud

   Clique no botão a seguir para abrir o Cloud Shell, que fornece acesso de linha de comando aos 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 a seguir usando o Cloud Shell:

   gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
   containerregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

   Esse comando ativa as seguintes APIs:

   • API Compute Engine
   • API Cloud SQL Admin
   • API Cloud Run
   • API Container Registry
   • API Cloud Build
   • API Service Networking

Configurar o Cloud SQL

crie uma instância do Cloud SQL

IP público

O Cloud Run não pode se conectar ao Cloud SQL para SQL Server por meio de um IP público. Em vez disso, use o IP particular.

IP privado

Console

Alocar um intervalo de endereço IP e criar uma conexão particular para configurar o acesso a serviços particulares do Cloud SQL

1. No Console do Google Cloud, acesse a página Redes VPC.

   Acessar redes VPC

2. Selecione a rede VPC default.
3. Selecione a guia Conexão de serviço particular.
4. Selecione a guia Intervalos de IP alocados para serviços.
5. Clique em Alocar intervalo de IP.
6. Em Nome do intervalo alocado, especifique google-managed-services-default.
7. Selecione a opção Automático para o intervalo de IP e especifique o tamanho do prefixo como 16.
8. Clique em Alocar para criar o intervalo alocado.
9. Selecione a guia Conexões particulares com serviços para a rede VPC default.
10. Clique em Criar conexão para criar uma conexão particular entre a rede e um produtor de serviços.
11. Em Alocação atribuída, selecione google-managed-services-default.
12. Clique em Conectar para criar a conexão.

Criar uma instância com SSL e endereço IP privado ativados

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 SQL Server.
4. Insira quickstart-instance para o ID da instância.
5. Digite uma senha para o usuário sqlserver. Salve essa senha para uso futuro.
6. Clique na opção Zona única em Escolher disponibilidade por região e zona.
7. Clique e expanda Mostrar opções de configuração.
8. Em Tipo de máquina, selecione Leve.
9. Em Conexões, selecione IP privado.
10. Selecione padrão no menu suspenso Rede.
11. Desmarque a caixa de seleção IP público para criar uma instância apenas com um IP privado.
12. Clique em Criar instância e aguarde a inicialização da instância.
13. Clique em Conexões.
14. Na seção Segurança, selecione Permitir apenas conexões SSL para ativar conexões SSL.
15. Na caixa de diálogo Permitir apenas conexões SSL, clique em Salvar e reiniciar e aguarde a reinicialização da instância.

gcloud

Alocar um intervalo de endereço IP e criar uma conexão particular para configurar o acesso a serviços particulares do Cloud SQL

1. Execute o comando gcloud compute addresses create para alocar um intervalo de endereços IP.

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. Execute o comando gcloud services vpc-peerings connect para criar uma conexão particular com o intervalo de endereços IP alocado. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

Criar uma instância com SSL e endereço IP privado ativados

1. Antes de executar o comando abaixo, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.

Se quiser, modifique os valores dos seguintes parâmetros:

• --database-version: o tipo e a versão do mecanismo de banco de dados. Se não for especificado, a API padrão será usada. Consulte a documentação das versões de banco de dados do gcloud para ver as versões atuais disponíveis.
• --cpu: o número de núcleos na máquina;
• --memory: um valor inteiro que indica quanta memória incluir na máquina. Uma unidade de tamanho pode ser fornecida (por exemplo, 3.072 MB ou 9 GB). Se nenhuma unidade for especificada, serão considerados GB.
• --region: local regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, o padrão us-central1 será utilizado. Veja a lista completa de regiões.

Execute o comando gcloud sql instances create para criar uma instância do Cloud SQL com um endereço IP privado.

gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. Execute o comando gcloud sql instances patch para ativar apenas permitir conexões SSL para a instância.

gcloud sql instances patch quickstart-instance --require-ssl

Crie um banco de dados

Console

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

   Acesse Instâncias do Cloud SQL

2. Selecione quickstart-instance.
3. No menu de navegação SQL, selecione Bancos de dados.
4. Clique em Criar banco de dados.
1. No campo Nome do banco de dados da caixa de diálogo Novo banco de dados, insira quickstart-db.
2. Clique em Criar.

gcloud

Execute o comando gcloud sql databases create para criar um banco de dados.

gcloud sql databases create quickstart-db --instance=quickstart-instance

Implantar um app de amostra no Cloud Run

Configurar uma conta de serviço do Cloud Run

Configure a conta de serviço usada pelo Cloud Run para que ela tenha o papel Cliente do Cloud SQL com permissões para se conectar ao Cloud SQL.

Console

1. No Console do Google Cloud, abra a página IAM.

   Acessar IAM

2. Na conta de serviço denominada Conta de serviço padrão do Compute Engine, clique no ícone de lápis.
3. Clique em ADICIONAR OUTRO PAPEL.
4. Adicione o Papel chamado Cliente do Cloud SQL.
5. Clique em Salvar.

gcloud

1. Execute o seguinte comando gcloud para ver uma lista de contas de serviço do seu projeto:

   gcloud iam service-accounts list

2. Copie o E-MAIL da conta de serviço do Compute Engine.
3. Execute o seguinte comando para adicionar o papel Cliente do Cloud SQL à conta de serviço do Compute Engine:

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/cloudsql.client"

Configurar um app de amostra do Cloud SQL

Agora é possível configurar um aplicativo de amostra para se conectar à instância do Cloud SQL usando uma instância, um banco de dados e uma conta de serviço do Cloud SQL com permissões de cliente.

IP público

O Cloud Run não pode se conectar ao Cloud SQL para SQL Server por meio de um IP público. Em vez disso, use o IP particular.

IP privado

Para caminhos de IP privados, o aplicativo se conecta diretamente à instância por meio do acesso VPC sem servidor. Esse método usa um soquete TCP para se conectar diretamente à instância do Cloud SQL sem usar o proxy do Cloud SQL Auth.

Go

Criar e fazer o download do certificado do servidor SSL

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

   Acesse "Instâncias do Cloud SQL"

2. Clique em quickstart-instance para ver a página Visão geral correspondente.
3. Clique na guia Conexões.
4. Na seção Segurança, clique em Fazer download dos certificados para fazer o download do certificado do servidor SSL.

Criar uma conexão VPC sem servidor para conexões com a instância via IP particular

1. No Console do Google Cloud, acesse a página Acesso VPC sem servidor - Criar conector.

   Criar conector de VPC sem servidor

2. Insira quickstart-connector como nome.
3. Selecione padrão no menu suspenso Rede.
4. Selecione Intervalo de IPs personalizado no menu suspenso Sub-rede.
5. Digite 10.8.0.0 na caixa de entrada Intervalo de IP.
6. Clique em Criar.

Criar app de amostra com certificado do servidor SSL

1. No editor do Cloud Shell, abra o código-fonte do app de amostra.

   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para fazer o download do código do app de amostra e abrir o diretório do app de amostra no editor do Cloud Shell.
3. Faça upload do arquivo do certificado do servidor SSL para a pasta certs.
   1. Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
   2. Selecione o arquivo a seguir na máquina local: server-ca.pem.
   3. Com o arquivo de certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de upload do arquivo para o editor do Cloud Shell.
4. Execute o comando a seguir no Cloud Shell para criar um contêiner do Docker e publicá-lo no Container Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql

Java

Criar e fazer o download do certificado do servidor SSL

Para usuários do Java, o conector já fornece uma conexão segura para que não seja necessário criar e fazer o download do certificado do servidor SSL.

Criar uma conexão VPC sem servidor para conexões com a instância via IP particular

1. No Console do Google Cloud, acesse a página Acesso VPC sem servidor - Criar conector.

   Criar conector de VPC sem servidor

2. Insira quickstart-connector como nome.
3. Selecione padrão no menu suspenso Rede.
4. Selecione Intervalo de IPs personalizado no menu suspenso Sub-rede.
5. Digite 10.8.0.0 na caixa de entrada Intervalo de IP.
6. Clique em Criar.

Criar app de amostra

1. No editor do Cloud Shell, abra o código-fonte do app de amostra.

   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para fazer o download do código do app de amostra e abrir o diretório do app de amostra no editor do Cloud Shell.
3. Execute o comando a seguir no Cloud Shell para criar um contêiner do Docker e publicá-lo no Container Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
    -Dimage=gcr.io/YOUR_PROJECT_ID/run-sql -DskipTests

Python

Criar e fazer o download do certificado do servidor SSL

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

   Acesse "Instâncias do Cloud SQL"

2. Clique em quickstart-instance para ver a página Visão geral correspondente.
3. Clique na guia Conexões.
4. Na seção Segurança, clique em Fazer download dos certificados para fazer o download do certificado do servidor SSL.

Criar uma conexão VPC sem servidor para conexões com a instância via IP particular

1. No Console do Google Cloud, acesse a página Acesso VPC sem servidor - Criar conector.

   Criar conector de VPC sem servidor

2. Insira quickstart-connector como nome.
3. Selecione padrão no menu suspenso Rede.
4. Selecione Intervalo de IPs personalizado no menu suspenso Sub-rede.
5. Digite 10.8.0.0 na caixa de entrada Intervalo de IP.
6. Clique em Criar.

Criar app de amostra com certificado do servidor SSL

1. No editor do Cloud Shell, abra o código-fonte do app de amostra.

   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para fazer o download do código do app de amostra e abrir o diretório do app de amostra no editor do Cloud Shell.
3. Faça upload do arquivo de certificado do servidor SSL para a pasta certs.
   1. Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
   2. Selecione o arquivo a seguir na máquina local: server-ca.pem.
   3. Com o arquivo de certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de upload do arquivo para o editor do Cloud Shell.
4. Execute o comando a seguir no Cloud Shell para criar um contêiner do Docker e publicá-lo no Container Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql

Implantar o app de exemplo

As etapas para implantar a amostra no Cloud Run dependem do tipo de endereço IP atribuído à instância do Cloud SQL.

IP público

O Cloud Run não pode se conectar ao Cloud SQL para SQL Server por meio de um IP público. Em vez disso, use o IP particular.

IP privado

Console

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

   Acesse o Cloud Run

2. Clique em Criar contêiner e selecione Serviço para exibir o formulário Criar serviço.

3. Mantenha a opção de implantar a partir de uma imagem de contêiner atual e clique em Selecionar para especificar a imagem de contêiner gcr.io/YOUR_PROJECT_ID/run-sql criada na etapa anterior.
4. Digite quickstart-service no campo Nome do serviço.
5. Na seção Autenticação, selecione a opção Allow unauthenticated invocations. Se você não tiver permissões (função de administrador do Cloud Run) para selecionar essa opção, o serviço será implantado e exigirá autenticação.
6. Expanda a seção Contêiner, variáveis, secrets, conexões e segurança .
7. Para criar as variáveis de ambiente a seguir, clique em Adicionar variável em Variáveis de ambiente. Defina os valores das variáveis de ambiente desta maneira:
• Defina DB_NAME como quickstart-db.
• DB_USER: defina como sqlserver.
• DB_PASS: defina a senha do usuário do sqlserver que você criou em Criar uma instância do Cloud SQL.
• INSTANCE_CONNECTION_NAME: defina o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no console do Google Cloud.
• Defina DB_PORT como 1433.
Observação: para usuários de Java, o conector já fornece uma conexão segura. Portanto, as variáveis de ambiente INSTANCE_HOST, DB_ROOT_CERT e PRIVATE_IP não devem ser definidas.
• INSTANCE_HOST: defina como o endereço IP particular da instância conforme mencionado na página Visão geral da instância do Cloud SQL.
• DB_ROOT_CERT: defina como certs/server-ca.pem.
• PRIVATE_IP: defina como TRUE.

8. Ative a conexão com o Cloud SQL:

   1. Clique em Conexões.
   2. Clique em Adicionar conexão na seção Conexões do Cloud SQL.
   3. Selecione a instância do Cloud SQL quickstart-instance criada anteriormente.
   4. Selecione default: Serverless VPC Access Connector "quickstart-connector" no menu suspenso Rede VPC.
   5. Selecione a opção Rotear todo o tráfego pelo conector VPC.

9. Clique em Criar para concluir a criação do serviço do Cloud Run.

10. Depois que o serviço do Cloud Run é implantado, a página Detalhes do serviço exibe o URL dele na parte superior da página. Clique no link URL para ver o app de amostra implantado no Cloud Run conectado ao Cloud SQL.

    

gcloud

1. Antes de executar o comando a seguir, faça as seguintes substituições:

• YOUR_PROJECT_ID pelo código do projeto;

• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no `console do Google Cloud.

• DB_PASS pela senha do usuário do sqlserver que você criou em Criar uma instância do Cloud SQL.
• INSTANCE_HOST pelo endereço IP particular da instância. Acesse a página Visão geral da instância do Cloud SQL em que o endereço IP privado da instância é exibido.

Para criar o serviço do Cloud Run, execute o comando gcloud run deploy da seguinte maneira:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433" \
  --set-env-vars INSTANCE_HOST="INSTANCE_HOST" \
  --set-env-vars DB_ROOT_CERT="certs/server-ca.pem" \
  --set-env-vars PRIVATE_IP="TRUE"

Os usuários de Java precisam executar o comando gcloud run deploy sem as sinalizações INSTANCE_HOST, DB_ROOT_CERT e PRIVATE_IP --set-env-vars, conforme mostrado a seguir, para criar o serviço do Cloud Run porque o conector Java já fornece uma conexão segura:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433"

Digite a opção numérica fornecida para us-central1 quando aparecer a solicitação para especificar uma região.

2. Depois de ver uma mensagem de confirmação informando que o serviço do Cloud Run foi implantado, clique no link URL do serviço na mensagem para ver o aplicativo de amostra no Cloud Run conectado ao Cloud SQL.

   

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

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

   Acesse Instâncias do Cloud SQL

2. Selecione a instância quickstart-instance 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 caixa de diálogo Excluir instância, digite quickstart-instance e clique em Excluir para excluir a instância.

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

   Acesse o Cloud Run

6. Marque a caixa de seleção ao lado do nome do serviço do quickstart-service.
7. Clique em Excluir na parte superior da página do Cloud Run.

Etapas de limpeza opcionais

Se você não estiver usando o papel Cliente do Cloud SQL que foi atribuído à conta de serviço do Compute Engine, será possível removê-lo.

1. No Console do Google Cloud, abra a página IAM.

   Acessar IAM

2. Clique no ícone de edição (que parece com um lápis) da conta do IAM chamada conta de serviço padrão do Compute Engine.
3. Exclua o papel Cliente do Cloud SQL.
4. Clique em Salvar.

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 Compute Engine
  • API Cloud SQL Admin
  • API Cloud Run
  • API Container Registry
  • API Cloud Build

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

   Acesse APIs

2. Selecione qualquer API que você quer desativar e clique no botão Desativar API.

A seguir

Com base nas suas necessidades, é possível saber mais sobre como criar instâncias do Cloud SQL.

Também é possível aprender a criar usuários do SQL Server e bancos de dados para sua instância do Cloud SQL.

Para mais informações sobre preços, consulte Preços do Cloud SQL para SQL Server.

Saiba mais sobre estas situações:

• Como configurar sua instância do Cloud SQL com um endereço IP público.
• Como configurar sua instância do Cloud SQL com um endereço IP privado.

Além disso, é possível aprender a se conectar a uma instância do Cloud SQL usando outros aplicativos do Google Cloud, como:

• Um aplicativo em execução no ambiente padrão do App Engine
• A partir de um aplicativo em execução no Compute Engine
• A partir de um aplicativo em execução no GKE
• A partir do Cloud Run functions
• no Cloud Run