Conectar-se ao Cloud SQL para PostgreSQL pelo Cloud Functions

Conectar-se ao Cloud SQL para PostgreSQL pelo Cloud Functions

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implantar um app de exemplo no Cloud Functions conectado a uma instância do PostgreSQL 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

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

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

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

   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 Cloud Functions
   • 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

   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 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 Cloud Functions
   • API Cloud SQL Admin
   • API Cloud Run
   • API Cloud Build
   • API Artifact Registry
   • API Eventarc
   • API Compute Engine
   • API Service Networking
   • API Cloud Logging

7. Adicione o papel do IAM Invocador do Cloud Functions ao seu usuário.

   Adicionar o papel

Configurar o Cloud SQL

crie uma instância do Cloud SQL

IP público

Console

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 Escolher PostgreSQL.
4. No campo ID da instância, insira quickstart-instance.
5. No campo Senha, insira uma senha para o usuário postgres. Salve essa senha para uso futuro.
6. Na seção Escolher disponibilidade de região e zona, selecione Única zona.
7. Clique no menu Mostrar opções de configuração.
8. Na lista suspensa Tipo de máquina, selecione Leve.
9. Clique em Criar instância e aguarde até que a instância seja inicializada.

gcloud

Antes de executar o comando da seguinte maneira, 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 desejados na máquina.
• --memory: valor inteiro que indica a quantidade de memória desejada na máquina. Uma unidade de tamanho precisa 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-central será utilizado.

Execute o comando gcloud sql instances create para criar uma instância do Cloud SQL.

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD

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 privado.
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 PostgreSQL.
4. Insira quickstart-instance para o ID da instância.
5. Insira uma senha para o usuário postgres. 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 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=POSTGRES_14 \
 --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

Criar um usuário

Console

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

   Acesse "Instâncias do Cloud SQL"

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. No menu de navegação SQL, selecione Usuários.
4. Clique em Adicionar conta de usuário.
5. Na página Adicionar uma conta de usuário da quickstart-instance, adicione as seguintes informações:
   • No campo Nome de usuário, digite quickstart-user.
   • No campo Password, especifique uma senha para o usuário do banco de dados. Anote-a para usá-la em uma etapa posterior deste guia de início rápido.
6. Clique em Add.

gcloud

Antes de executar o comando a seguir, faça estas substituições:

1. DB_PASS por uma senha para seu usuário do banco de dados. Anote-a para usá-la em uma etapa posterior deste guia de início rápido.

Execute o comando gcloud sql users create para criar o usuário.

gcloud sql users create quickstart-user \
--instance=quickstart-instance \
--password=DB_PASS

Os limites de tamanho de nome de usuário são os mesmos no Cloud SQL e no PostgreSQL no local.

Configurar uma conta de serviço do Cloud Functions

Configure a conta de serviço usada pelo Cloud Functions 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.
Observação: o nome da conta de serviço aparece na coluna Nome. Essa coluna está ao lado do identificador da conta de serviço (na coluna Principal). O identificador normalmente é um endereço de e-mail.
3. Clique em ADICIONAR OUTRO PAPEL.
4. Adicione o Papel chamado Cliente do Cloud SQL.
5. Clique em Save.

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"

Criar uma função

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

   Acesse o Cloud Functions

2. Clique em Criar função.
3. Em Ambiente, selecione 2a geração.
4. No campo Nome da função, insira quickstart-function.
5. Na região Autenticação, selecione Permitir invocações não autenticadas.
6. Clique em Next.
7. No menu Ambiente de execução, selecione um dos seguintes idiomas:

Idioma	Número da versão
Go	1.20
Java	17
Node.js	18
Python	3.10

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

Implante a função

1. Na parte inferior da página do Cloud Functions, clique em Implantar. O console do Google Cloud redireciona você para a página de detalhes da função.
2. 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 Functions. Primeiro, use o Cloud Shell para configurar e criar o app de exemplo. Em seguida, use o Cloud Functions para implantar o app de exemplo.

Há duas maneiras de configurar, criar e implantar o app dependendo se você criou uma instância do Cloud SQL para PostgreSQL com um IP público ou um IP particular.

Configurar um app de exemplo do Cloud SQL

IP público

Para caminhos de IP público, o Cloud Functions fornece criptografia e se conecta usando o proxy Cloud SQL Auth por meio de soquetes Unix.

Go

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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

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

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Java

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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

6. Execute o comando mvn 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.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
     -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
     -DskipTests -Djib.to.credHelper=gcloud
   

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Node.js

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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

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

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Python

1. No editor do Cloud Shell, abra o código-fonte do aplicativo 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

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

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

IP particular

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 dos certificados SSL e 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 Criar certificado do cliente.
5. Na caixa de diálogo Criar um certificado do cliente, insira quickstart-key como o nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de download para fazer o download dos certificados. Clique em Fechar.

   Importante: armazene essa chave privada com segurança. Em caso de perda, será necessário criar um novo certificado de cliente.

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

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 para criar o conector.

Criar um aplicativo de amostra com certificados SSL

1. No editor do Cloud Shell, abra o código-fonte do aplicativo 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. Faça upload dos arquivos de certificados 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 os seguintes arquivos na máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Com os três arquivos de certificado SSL selecionados, clique em Abrir para concluir o processo de upload dos arquivos para o editor do Cloud Shell.
6. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

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

8. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Java

Criar e fazer o download dos certificados SSL e 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 de certificados do servidor SSL e cliente.

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

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 para criar o conector.

Criar app de amostra

1. No editor do Cloud Shell, abra o código-fonte do aplicativo 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

6. Execute o comando mvn 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.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
     -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
     -DskipTests -Djib.to.credHelper=gcloud
   

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Node.js

Criar e fazer o download dos certificados SSL e 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 Criar certificado do cliente.
5. Na caixa de diálogo Criar um certificado do cliente, insira quickstart-key como o nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de download para fazer o download dos certificados. Clique em Fechar.

   Importante: armazene essa chave privada com segurança. Em caso de perda, será necessário criar um novo certificado de cliente.

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

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 para criar o conector.

Criar um aplicativo de amostra com certificados SSL

1. No editor do Cloud Shell, abra o código-fonte do aplicativo 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Faça upload dos arquivos de certificados 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 os seguintes arquivos na máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Com os três arquivos de certificado SSL selecionados, clique em Abrir para concluir o processo de upload dos arquivos para o editor do Cloud Shell.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

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

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Python

Criar e fazer o download dos certificados SSL e 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 Criar certificado do cliente.
5. Na caixa de diálogo Criar um certificado do cliente, insira quickstart-key como o nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de download para fazer o download dos certificados. Clique em Fechar.

   Importante: armazene essa chave privada com segurança. Em caso de perda, será necessário criar um novo certificado de cliente.

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

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 para criar o conector.

Criar um aplicativo de amostra com certificados SSL

1. No editor do Cloud Shell, abra o código-fonte do aplicativo 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. 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
   

4. Faça upload dos arquivos de certificados 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 os seguintes arquivos na máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Com os três arquivos de certificado SSL selecionados, clique em Abrir para concluir o processo de upload dos arquivos para o editor do Cloud Shell.
5. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry chamado quickstart-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"
   

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

7. No gen2 do Cloud 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-instances INSTANCE_CONNECTION_NAME
   

Implantar o app de exemplo

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

IP público

Console

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

   Acesse o Cloud Functions

2. Selecione o quickstart-function que você criou em uma etapa anterior deste guia de início rápido.
3. Na página Detalhes da função, clique no link do painel Powered by Cloud Run para acessar o serviço subjacente do Cloud Functions.
4. Clique em Editar e implantar nova versão.
5. No campo URL da imagem do contêiner, clique em Selecionar.
1. Selecione a guia Artifact Registry e expanda o nó quickstart-repo.
2. Expanda o contêiner function-sql e selecione a imagem dele que você criou na etapa anterior.
3. Clique em Selecionar.
6. Para criar as variáveis de ambiente a seguir, clique em Adicionar variável na seção Variáveis de ambiente:
• INSTANCE_UNIX_SOCKET: defina como /cloudsql/YOUR_PROJECT_ID:YOUR_REGION_NAME:quickstart-instance.
• DB_NAME: defina como quickstart-db;
• DB_USER: defina como quickstart-user;
• DB_PASS: defina a senha do quickstart-user especificada na etapa anterior do guia de início rápido Criar um usuário.

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

   1. Na seção Conexões do Cloud SQL, clique em Adicionar conexão.
   2. Selecione o nome da conexão da instância.
8. Na parte inferior da página, clique em Implantar.
9. Após a implantação do quickstart-function, a página Detalhes do serviço mostra um URL para o serviço em execução. Clique no link URL para ver o app de exemplo do Cloud Functions implantado e conectado ao Cloud SQL. O app será semelhante a este:

   

gcloud

Go

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud functions deploy. Antes de executar o comando, atualize as seguintes variáveis:
• YOUR_REGION_NAME pelo nome da região

• INSTANCE_CONNECTION_NAME com o 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 quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

Java

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud functions deploy. Antes de executar o comando, atualize as seguintes variáveis:
• YOUR_REGION_NAME pelo nome da região

• INSTANCE_CONNECTION_NAME com o 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 quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

Node.js

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud functions deploy. Antes de executar o comando, atualize as seguintes variáveis:
• YOUR_REGION_NAME pelo nome da região

• INSTANCE_CONNECTION_NAME com o 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 quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

Python

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud functions deploy. Antes de executar o comando, atualize as seguintes variáveis:
• YOUR_REGION_NAME pelo nome da região

• INSTANCE_CONNECTION_NAME com o 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 quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

IP privado

Console

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

   Acesse o Cloud Functions

2. Selecione o quickstart-function que você criou em uma etapa anterior deste guia de início rápido.
3. Na página Detalhes da função, clique no link do painel Powered by Cloud Run para acessar o serviço subjacente do Cloud Functions.
4. Clique em Editar e implantar nova versão.
5. No campo URL da imagem do contêiner, clique em Selecionar.
1. Selecione a guia Artifact Registry e expanda o nó quickstart-repo.
2. Expanda o contêiner function-sql e selecione a imagem dele que você criou na etapa anterior.
3. Clique em Selecionar.
6. Para criar as variáveis de ambiente a seguir, clique em Adicionar variável na seção Variáveis de ambiente:
• Defina DB_NAME como quickstart-db.
• DB_USER: defina como quickstart-user.
• DB_PASS: defina como a senha do quickstart-user especificado na etapa anterior do guia de início rápido Criar um usuário.
• 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 5432.
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, DB_CERT, DB_KEY e PRIVATE_IP não devem ser definidas.
• 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 como certs/server-ca.pem.
• DB_CERT: defina como certs/client-cert.pem.
• DB_KEY: defina como certs/client-key.pem.
• PRIVATE_IP: defina como TRUE.

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

   1. Na seção Conexões do Cloud SQL, clique em Adicionar conexão.
   2. Selecione o nome da conexão da instância.
   3. Selecione default: Serverless VPC Access Connector "quickstart-connector" no menu suspenso Rede VPC.
   4. Selecione a opção Rotear todo o tráfego pelo conector VPC.
8. Na parte inferior da página, clique em Implantar.
9. Após a implantação do quickstart-function, a página Detalhes do serviço mostra um URL para o serviço em execução. Clique no link URL para ver o app de exemplo do Cloud Functions implantado e conectado ao Cloud SQL. O app será semelhante a este:

   

gcloud

Go

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud 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

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

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=5432 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Os usuários de Java devem executar gcloud functions deploy sem o INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY e PRIVATE_IP da seguinte forma, para criar o Cloud Functions porque o conector Java já fornece uma conexão segura:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

Java

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud 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

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

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=5432 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Os usuários de Java devem executar gcloud functions deploy sem o INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY e PRIVATE_IP da seguinte forma, para criar o Cloud Functions porque o conector Java já fornece uma conexão segura:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

Node.js

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud 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

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

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=5432 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Os usuários de Java devem executar gcloud functions deploy sem o INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY e PRIVATE_IP da seguinte forma, para criar o Cloud Functions porque o conector Java já fornece uma conexão segura:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado conectado ao Cloud SQL.

   

Python

1. Para implantar uma função gen2 no Cloud Functions, execute o seguinte comando gcloud 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

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

Execute o comando gcloud functions deploy da seguinte maneira para criar o Cloud Functions:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=5432 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Os usuários de Java devem executar gcloud functions deploy sem o INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY e PRIVATE_IP da seguinte forma, para criar o Cloud Functions porque o conector Java já fornece uma conexão segura:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Quando você acessar uma mensagem de confirmação de que o Cloud Functions foi implantado, clique no link URL de serviço na mensagem para ver o aplicativo de amostra do Cloud Functions implantado 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 Cloud Functions.

   Acesse o Cloud Functions

6. Marque a caixa de seleção ao lado do nome do serviço do quickstart-function.
7. Clique em Excluir na parte de cima da página do Cloud 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.

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

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

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;
• no Cloud Functions.