Conectar-se ao Cloud SQL para SQL Server pelo Cloud Run functions
Saiba como implantar um app de exemplo no Cloud Run functions conectado a uma instância do SQL Server usando o Console do Google Cloud e um aplicativo 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
- 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.
-
Make sure that billing is enabled for your Google Cloud project.
-
Ative as APIs do Cloud necessárias para executar um app de exemplo do Cloud SQL no Cloud Run functions.
Clique em Ativar APIs para ativar as APIs necessárias para este guia de início rápido.
Isso permite as seguintes APIs:
- API Funções do Cloud Run
- API Cloud SQL Admin
- API Cloud Run Admin
- API Cloud Build
- API Artifact Registry
- API Eventarc
- API Compute Engine
- API Service Networking
- API Cloud Logging
Clique no botão a seguir para abrir o Cloud Shell, que fornece acesso de linha de comando aos seus recursos Google Cloud diretamente no navegador. O Cloud Shell pode ser usado para executar os comandos
gcloud
apresentados neste guia de início rápido.Execute o comando
gcloud
a seguir usando o Cloud Shell:gcloud services enable cloudfunctions.googleapis.com sqladmin.googleapis.com run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com eventarc.googleapis.com compute.googleapis.com servicenetworking.googleapis.com pubsub.googleapis.com logging.googleapis.com
Esse comando ativa as seguintes APIs:
- API Funções do Cloud Run
- API Cloud SQL Admin
- API Cloud Run
- API Cloud Build
- API Artifact Registry
- API Eventarc
- API Compute Engine
- API Service Networking
- API Cloud Logging
Adicione o papel do IAM Invocador do Cloud Run functions ao seu usuário.
Configurar o Cloud SQL
crie uma instância do Cloud SQL
IP público
O Cloud Run functions 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
Alocar um intervalo de endereço IP e criar uma conexão particular para configurar o acesso a serviços particulares do Cloud SQL
-
No Console do Google Cloud, acesse a página Redes VPC.
- Selecione a rede VPC
default
. - Selecione a guia Conexão de serviço particular.
- Selecione a guia Intervalos de IP alocados para serviços.
- Clique em Alocar intervalo de IP.
- Em Nome do intervalo alocado, especifique
google-managed-services-default
. - Selecione a opção Automático para o intervalo de IP e especifique o tamanho do prefixo como
16
. - Clique em Alocar para criar o intervalo alocado.
- Selecione a guia Conexões particulares com serviços para a rede VPC
default
. - Clique em Criar conexão para criar uma conexão particular entre a rede e um produtor de serviços.
- Em Alocação atribuída, selecione
google-managed-services-default
. - Clique em Conectar para criar a conexão.
Criar uma instância com SSL e endereço IP privado ativados
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Clique em Criar instância.
- Clique em Escolher SQL Server.
- Verifique se a edição Enterprise Plus está selecionada como a edição do Cloud SQL para sua instância.
- No campo ID da instância, insira
quickstart-instance
. - No campo Senha, insira uma senha para o usuário sqlserver. Salve essa senha para uso futuro.
- Na seção Escolher disponibilidade de região e zona, selecione Única zona.
- Clique no menu Mostrar opções de configuração.
- Expanda o nó Configuração da máquina.
- Na região Formas de máquina, selecione o formato 4 vCPU, 32 GB.
- Expanda o nó Conexões.
- Desmarque a caixa de seleção IP público para criar uma instância apenas com um endereço IP privado.
- Marque a caixa de seleção IP privado.
- No menu Rede, selecione padrão.
- Clique em Criar instância e aguarde a inicialização da instância.
- Clique em Conexões.
- Na seção Segurança, selecione Permitir apenas conexões SSL para ativar conexões SSL.
- Na caixa de diálogo Permitir apenas conexões SSL, clique em Salvar e reiniciar e aguarde a reinicialização da instância.
Alocar um intervalo de endereço IP e criar uma conexão particular para configurar o acesso a serviços particulares do Cloud SQL
-
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 -
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
-
Antes de executar o comando abaixo, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.
- --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 patch
para ativar apenas permitir conexões SSL para a instância.
Se quiser, modifique os valores dos seguintes parâmetros:
Execute o comando gcloud
sql instances create
para criar uma instância do Cloud SQL com um endereço IP privado.
gcloud sql instances createquickstart-instance \ --database-version=SQLSERVER_2017_STANDARD \ --cpu=1 \ --memory=4GB \ --region=us-central \ --root-password=DB_ROOT_PASSWORD \ --no-assign-ip \ --network=default
gcloud sql instances patchquickstart-instance --require-ssl
Crie um banco de dados
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Selecione
quickstart-instance
. - No menu de navegação SQL, selecione Bancos de dados.
- Clique em Criar banco de dados.
- No campo Nome do banco de dados da caixa de diálogo
Novo banco de dados, insira
quickstart-db
. - Clique em Criar.
Execute o comando gcloud
sql databases create
para criar um banco de dados.
gcloud sql databases createquickstart-db --instance=quickstart-instance
Configurar uma conta de serviço do Cloud Run functions
-
No console do Google Cloud, abra a página IAM.
- Na conta de serviço denominada Conta de serviço padrão do Compute Engine, clique no ícone de lápis.
- Clique em ADICIONAR OUTRO PAPEL.
- Adicione o Papel chamado Cliente do Cloud SQL.
- Clique em Salvar.
-
Execute o seguinte comando
gcloud
para ver uma lista de contas de serviço do seu projeto:gcloud iam service-accounts list
- Copie o E-MAIL da conta de serviço do Compute Engine.
- 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"
Criar uma função
-
No console do Google Cloud, acesse a página das funções do Cloud Run.
- Clique em Criar função.
- Em Ambiente, selecione 2a geração.
- No campo Nome da função, insira
quickstart-function
. - Na região Autenticação, selecione Permitir invocações não autenticadas.
- Clique em Próxima.
- No menu Ambiente de execução, selecione uma das seguintes linguagens:
- No menu Código-fonte, verifique se o Editor in-line está selecionado. Nesta etapa, você vai usar a função padrão fornecida no editor.
Linguagem | Número da versão |
---|---|
Go | 1.20 |
Python | 3.10 |
implantar a função
- Na parte de baixo da página do Cloud Run functions, clique em Implantar. O console Google Cloud redireciona você para a página de detalhes da função.
- Quando a implantação da função estiver concluída, clique no link URL para ver
um navegador da Web que exibe a mensagem
Hello, World!
.
Implantar o app de exemplo do Cloud SQL como uma função
Você configura e implanta o app de exemplo do Cloud SQL como uma função no Cloud Run functions. Primeiro, use o Cloud Shell para configurar e criar o app de exemplo. Em seguida, você usará o Cloud Run functions para implantar o app de exemplo.
Configurar um app de exemplo do Cloud SQL
IP público
O Cloud Run functions 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.Criar e fazer o download do certificado do servidor SSL
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Clique em
quickstart-instance
para ver a página Visão geral correspondente. - Clique na guia Conexões.
- 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
-
No console do Google Cloud, acesse a página Acesso VPC sem servidor - Criar conector.
- Insira
quickstart-connector
como nome. - Selecione padrão no menu suspenso Rede.
- Selecione Intervalo de IPs personalizado no menu suspenso Sub-rede.
- Digite
10.8.0.0
na caixa de entrada Intervalo de IP. - Clique em Criar.
Criar app de amostra com certificado do servidor SSL
-
No editor do Cloud Shell, abra o código-fonte do app de amostra.
Abra o editor do Cloud Shell - Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
- No prompt de comando do Cloud Shell, na metade inferior da tela,
abaixo do editor do Cloud Shell, execute o comando a seguir para ativar
o projeto. Substitua YOUR_PROJECT_ID pelo ID do projeto.
gcloud config set project
YOUR_PROJECT_ID - Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
-
Faça upload do arquivo do certificado do servidor SSL para a pasta certs.
- Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
- Selecione o arquivo a seguir na máquina local:
server-ca.pem
. - Com o arquivo de certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de upload do arquivo no editor do Cloud Shell.
-
Execute o seguinte comando
gcloud artifacts repositories create
no Cloud Shell para criar um repositório no Artifact Registry chamadoquickstart-repo
na mesma região da sua instância do Cloud SQL. Substitua YOUR_PROJECT_ID pelo ID do projeto e YOUR_REGION_NAME pelo nome da região.gcloud artifacts repositories create quickstart-repo \ --project=
YOUR_PROJECT_ID \ --repository-format=docker \ --location=YOUR_REGION_NAME \ --description="Cloud Function Quickstart Cloud SQL sample app" -
Execute o comando
gcloud builds submit
da seguinte maneira no Cloud Shell para criar um contêiner do Docker e publicá-lo no Artifact Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto e YOUR_REGION_NAME pelo nome da região.gcloud builds submit \ --tag
YOUR_REGION_NAME -docker.pkg.dev/YOUR_PROJECT_ID /quickstart-repo/function-sql . -
No
gen2
do Cloud Run functions, não é possível configurar e executar o proxy do Cloud SQL Auth automaticamente. Essa funcionalidade é compatível com o uso do Cloud Run. Para configurar e executar o proxy do Cloud SQL Auth com o serviço, use a flag--add-cloudsql-instances
para revisar manualmente o serviço subjacente do Cloud Run. Substitua INSTANCE_CONNECTION_NAME pelo nome da conexão da instância.gcloud run deploy quickstart-function --source . \ --region
YOUR_REGION_NAME \ --add-cloudsql-instancesINSTANCE_CONNECTION_NAME
Criar e fazer o download do certificado do servidor SSL
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Clique em
quickstart-instance
para ver a página Visão geral correspondente. - Clique na guia Conexões.
- 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
-
No console do Google Cloud, acesse a página Acesso VPC sem servidor - Criar conector.
- Insira
quickstart-connector
como nome. - Selecione padrão no menu suspenso Rede.
- Selecione Intervalo de IPs personalizado no menu suspenso Sub-rede.
- Digite
10.8.0.0
na caixa de entrada Intervalo de IP. - Clique em Criar.
Criar app de amostra com certificado do servidor SSL
-
No editor do Cloud Shell, abra o código-fonte do app de amostra.
Abra o editor do Cloud Shell - Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
- No prompt de comando do Cloud Shell, na metade inferior da tela,
abaixo do editor do Cloud Shell, execute o comando a seguir para ativar
o projeto. Substitua YOUR_PROJECT_ID pelo ID do projeto.
gcloud config set project
YOUR_PROJECT_ID -
Faça upload do arquivo de certificado do servidor SSL para a pasta certs.
- Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
- Selecione o arquivo a seguir na máquina local:
server-ca.pem
. - Com o arquivo de certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de upload do arquivo no editor do Cloud Shell.
-
Execute o seguinte comando
gcloud artifacts repositories create
no Cloud Shell para criar um repositório no Artifact Registry chamadoquickstart-repo
na mesma região da sua instância do Cloud SQL. Substitua YOUR_PROJECT_ID pelo ID do projeto e YOUR_REGION_NAME pelo nome da região.gcloud artifacts repositories create quickstart-repo \ --project=
YOUR_PROJECT_ID \ --repository-format=docker \ --location=YOUR_REGION_NAME \ --description="Cloud Function Quickstart Cloud SQL sample app" -
Execute o comando
gcloud builds submit
da seguinte maneira no Cloud Shell para criar um contêiner do Docker e publicá-lo no Artifact Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto e YOUR_REGION_NAME pelo nome da região.gcloud builds submit \ --tag
YOUR_REGION_NAME -docker.pkg.dev/YOUR_PROJECT_ID /quickstart-repo/function-sql . -
No
gen2
do Cloud Run functions, não é possível configurar e executar o proxy do Cloud SQL Auth automaticamente. Essa funcionalidade é compatível com o uso do Cloud Run. Para configurar e executar o proxy do Cloud SQL Auth com o serviço, use a flag--add-cloudsql-instances
para revisar manualmente o serviço subjacente do Cloud Run. Substitua INSTANCE_CONNECTION_NAME pelo nome da conexão da instância.gcloud run deploy quickstart-function --source . \ --region
YOUR_REGION_NAME \ --add-cloudsql-instancesINSTANCE_CONNECTION_NAME
Implantar o app de exemplo
As etapas para implantar o exemplo no Cloud Run functions dependem do tipo de endereço IP atribuído à instância do Cloud SQL.
IP público
O Cloud Run functions 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
-
No console do Google Cloud, acesse a página das funções do Cloud Run.
- Selecione o
quickstart-function
que você criou em uma etapa anterior deste guia de início rápido. - Na página Detalhes da função, clique no link do painel Powered by Cloud Run para acessar o serviço subjacente do Cloud Run functions.
- Clique em Editar e implantar nova versão.
- No campo URL da imagem do contêiner, clique em Selecionar.
- Selecione a guia Artifact Registry e expanda o nó
quickstart-repo
. - Expanda o contêiner
function-sql
e selecione a imagem dele que você criou na etapa anterior. - Clique em Selecionar.
- Para criar as variáveis de ambiente a seguir, clique em Adicionar variável na seção Variáveis de ambiente:
- Defina
DB_NAME
comoquickstart-db
. DB_USER
: defina comosqlserver
.DB_PASS
: defina a senha do usuário dosqlserver
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.INSTANCE_HOST
: defina o endereço de IP particular da instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.- Defina
DB_ROOT_CERT
comocerts/server-ca.pem
. PRIVATE_IP
: defina comoTRUE
.-
Ative a conexão com o Cloud SQL:
- Na seção Conexões do Cloud SQL, clique em Adicionar conexão.
- Selecione o nome da conexão da instância.
- Selecione
default: Serverless VPC Access Connector "quickstart-connector"
no menu suspenso Rede VPC. - Selecione a opção Rotear todo o tráfego pelo conector VPC.
- Na parte inferior da página, clique em Implantar.
- Após a implantação do quickstart-function, a página quickstart-function
mostra um URL para o serviço em execução. Clique no link URL para conferir
o app de exemplo do Cloud Run functions implantado e conectado ao Cloud SQL.
O app será semelhante a este:
- Para implantar uma função
gen2
no Cloud Run functions, execute o seguinte comandogcloud functions deploy
. Antes de executar o comando, atualize as seguintes variáveis: - YOUR_REGION_NAME pelo nome da região
- PRIVATE_IP_ADDRESS pelo endereço de IP particular da instância exibido na página Instâncias do Cloud SQL no console do Google Cloud.
-
DB_PASS pela senha do
quickstart-user
que você criou na etapa anterior do guia de início rápido Criar um usuário -
Quando você vir uma mensagem de confirmação de que a função foi implantada, clique no link URL de serviço na mensagem para ver o app de exemplo do Cloud Run functions implantado e conectado ao Cloud SQL.
Execute o comando gcloud functions deploy
da seguinte maneira para criar Cloud Run functions:
gcloud functions deploy quickstart-function \ --gen2 \ --runtime go120 \ --trigger-http \ --allow-unauthenticated \ --entry-point Votes \ --regionYOUR_REGION_NAME \ --vpc-connector=quickstart-connector \ --vpc-egress=all-traffic \ --set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \ --set-env-vars DB_USER=sqlserver \ --set-env-vars DB_PASS=DB_PASS \ --set-env-vars DB_NAME=quickstart-db \ --set-env-vars DB_PORT=1433 \ --set-env-vars DB_ROOT_CERT=certs/server-ca.pem \ --set-env-vars PRIVATE_IP=TRUE
- Para implantar uma função
gen2
no Cloud Run functions, execute o seguinte comandogcloud functions deploy
. Antes de executar o comando, atualize as seguintes variáveis: - YOUR_REGION_NAME pelo nome da região
- PRIVATE_IP_ADDRESS pelo endereço de IP particular da instância exibido na página Instâncias do Cloud SQL no console do Google Cloud.
-
DB_PASS pela senha do
quickstart-user
que você criou na etapa anterior do guia de início rápido Criar um usuário -
Quando você vir uma mensagem de confirmação de que a função foi implantada, clique no link URL de serviço na mensagem para ver o app de exemplo do Cloud Run functions implantado e conectado ao Cloud SQL.
Execute o comando gcloud functions deploy
da seguinte maneira para criar Cloud Run functions:
gcloud functions deploy quickstart-function \ --gen2 \ --runtime python310 \ --trigger-http \ --allow-unauthenticated \ --entry-point votes \ --regionYOUR_REGION_NAME \ --vpc-connector=quickstart-connector \ --vpc-egress=all-traffic \ --set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \ --set-env-vars DB_USER=sqlserver \ --set-env-vars DB_PASS=DB_PASS \ --set-env-vars DB_NAME=quickstart-db \ --set-env-vars DB_PORT=1433 \ --set-env-vars DB_ROOT_CERT=certs/server-ca.pem \ --set-env-vars PRIVATE_IP=TRUE
Limpar
Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Selecione a instância
quickstart-instance
para abrir a página Detalhes da instância. - Na barra de ícones na parte superior da página, clique em Excluir.
- Na caixa de diálogo Excluir instância, digite
quickstart-instance
e clique em Excluir para excluir a instância. -
No console do Google Cloud, acesse a página das funções do Cloud Run.
- Marque a caixa de seleção ao lado do nome do serviço do
quickstart-function
. - Clique em Excluir na parte de cima da página do Cloud Run functions.
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.
-
No console do Google Cloud, abra a página IAM.
- 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.
- Exclua o papel Cliente do Cloud SQL.
- 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
No Console do Google Cloud, acesse a página APIs.
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: