Conectar-se ao Cloud SQL para PostgreSQL pelo Cloud Run

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

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

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

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

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

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

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

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

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

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.

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

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.

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

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.

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

Console

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

   Acesse o Cloud Run

2. Clique em Criar serviço.

3. Clique no botão Selecionar na caixa de texto de entrada URL de imagem do contêiner.
1. Selecione a imagem de contêiner gcr.io/YOUR_PROJECT_ID/run-sql que você criou na etapa anterior.
4. No campo Nome da conta de serviço, insira quickstart-service.
5. Na seção Autenticação, selecione a opção Allow unauthenticated invocations.
6. Expanda a seção Contêiner, variáveis, secrets, conexões e segurança .
7. Para criar as Environment variables a seguir, clique em Adicionar variável em Variáveis de ambiente. Defina os valores das variáveis de ambiente desta maneira:
• INSTANCE_UNIX_SOCKET: defina como /cloudsql/YOUR_PROJECT_ID:us-central1:quickstart-instance.
• INSTANCE_CONNECTION_NAME: defina como o nome de conexão da instância que aparece na página Instâncias do Cloud SQL no console do Google Cloud.
• DB_NAME: defina como quickstart-db;
• DB_USER: defina como quickstart-user;
• DB_PASS: defina a senha do quickstart-user criada na etapa anterior do guia de início rápido Criar um usuário.

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

   • Clique na guia Conexões.
   • Clique no botão Adicionar conexão na seção Conexões do Cloud SQL.
   • Selecione o quickstart-instance criado anteriormente no menu suspenso.

   

9. Clique em Criar para criar o 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 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 run deploy da seguinte maneira para criar o serviço do Cloud Run:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE-CONNECTION-NAME \
  --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="quickstart-user" \
  --set-env-vars DB_PASS="DB_PASS"

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.

   

Console

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

   Acesse o Cloud Run

2. Clique em 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.
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 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.
• INSTANCE_HOST: defina como o endereço IP privado da instância conforme mencionado na página Visão geral da instância do Cloud SQL.
• 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.

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 criar o 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 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.
• INSTANCE_HOST pelo endereço IP privado 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.

Execute o comando gcloud run deploy da seguinte maneira para criar o serviço do Cloud Run:

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="quickstart-user" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="5432" \
  --set-env-vars INSTANCE_HOST="INSTANCE_HOST" \
  --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 precisam executar o comando gcloud run deploy sem as sinalizações INSTANCE_HOST, DB_ROOT_CERT, DB_CERT, DB_KEY 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="quickstart-user" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="5432"

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.