Conectar-se ao Cloud SQL para PostgreSQL pelo ambiente padrão do App Engine

Conectar-se ao Cloud SQL para PostgreSQL pelo ambiente padrão do App Engine

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implantar um app de exemplo no ambiente padrão do App Engine 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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

6. Ative as APIs do Cloud necessárias para executar um aplicativo de exemplo do Cloud SQL no ambiente padrão do App Engine.

   Console

   Clique no botão abaixo para ativar as APIs necessárias para este guia de início rápido.

   Ative as APIs

   Isso permite as seguintes APIs:

   • API Cloud SQL Admin
   • API Compute Engine
   • API Cloud Build
   • API Cloud Logging

   gcloud

   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.

   Abra o Cloud Shell

   Execute o comando gcloud a seguir usando o Cloud Shell:

   gcloud services enable sqladmin.googleapis.com compute.googleapis.com \
   cloudbuild.googleapis.com logging.googleapis.com

   Esse comando ativa as seguintes APIs:

   • API Cloud SQL Admin
   • API Compute Engine
   • API Cloud Build
   • API Cloud Logging

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. Verifique se a edição Enterprise Plus está selecionada como a edição do Cloud SQL para sua instância.
5. No campo ID da instância, insira quickstart-instance.
6. No campo Senha, insira uma senha para o usuário postgres. Salve essa senha para uso futuro.
7. Na seção Escolher disponibilidade de região e zona, selecione Única zona.
8. Clique no menu Mostrar opções de configuração.
9. Expanda o nó Configuração da máquina.
10. Na região Formas de máquina, selecione o formato 4 vCPU, 32 GB.
11. 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 particular.
4. Selecione a guia Intervalos de IP alocados para serviços.
5. Clique em Alocar intervalo de IP.
6. Em Nome do intervalo alocado, especifique google-managed-services-default.
7. Selecione a opção Automático para o intervalo de IP e especifique o tamanho do prefixo como 16.
8. Clique em Alocar para criar o intervalo alocado.
9. Selecione a guia Conexões particulares com serviços para a rede VPC default.
10. Clique em Criar conexão para criar uma conexão particular entre a rede e um produtor de serviços.
11. Em Alocação atribuída, selecione google-managed-services-default.
12. Clique em Conectar para criar a conexão.

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

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

   Acesse Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em Escolher PostgreSQL.
4. Verifique se a edição Enterprise Plus está selecionada como a edição do Cloud SQL para sua instância.
5. No campo ID da instância, insira quickstart-instance.
6. No campo Senha, insira uma senha para o usuário postgres. Salve essa senha para uso futuro.
7. Na seção Escolher disponibilidade de região e zona, selecione Única zona.
8. Clique no menu Mostrar opções de configuração.
9. Expanda o nó Configuração da máquina.
10. Na região Formas de máquina, selecione o formato 4 vCPU, 32 GB.
11. Expanda o nó Conexões.
12. Desmarque a caixa de seleção IP público para criar uma instância apenas com um endereço IP privado.
13. Marque a caixa de seleção IP privado.
14. No menu Rede, selecione padrão.
15. Clique em Criar instância e aguarde a inicialização da instância.
16. Clique em Conexões.
17. Na seção Segurança, selecione Permitir apenas conexões SSL para ativar conexões SSL.
18. 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 à instância instance_name, adicione as seguintes informações:
   1. No campo Nome de usuário, digite quickstart-user.
   2. 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 Adicionar.

gcloud

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

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

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

Implantar um app de exemplo no ambiente padrão do App Engine

Criar o aplicativo do App Engine

Crie o aplicativo do App Engine no projeto Google Cloud . Isso ativa o serviço do App Engine, cria um aplicativo padrão do App Engine e cria uma conta de serviço do App Engine que será usada para se conectar ao Cloud SQL.

Observação:essa etapa só precisa ser realizada uma vez por Google Cloud projeto.

Console

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

   Acessar o App Engine

2. Clique no botão Criar aplicativo.
3. Escolha us-central no menu suspenso Selecionar uma região.
4. Clique em Próxima.
5. Clique no link Fazer isso mais tarde quando ele aparecer na página Primeiros passos.

gcloud

1. Execute este comando gcloud app create para criar um aplicativo do App Engine:

gcloud app create

2. Quando for solicitado que você escolha a região em que o aplicativo do App Engine estará localizado, digite a escolha numérica de us-central.

Configurar a conta de serviço do App Engine

Configure a conta de serviço usada pelo App Engine 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 App Engine, clique no ícone de lápis.
   Observação: o nome da conta de serviço aparece ao lado do principal da conta. O nome do principal é [e-mail].
3. Clique em Adicionar outro papel.
4. Adicione o Papel chamado Cliente do Cloud SQL.
5. Clique em Salvar.

gcloud

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

   gcloud iam service-accounts list

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

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

Configurar e implantar um aplicativo de exemplo do Cloud SQL

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

IP público

Para caminhos de IP público, o ambiente padrão do App Engine fornece criptografia e se conecta usando o proxy Cloud SQL Auth por 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, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no arquivo app.standard.yaml pelos seguintes valores:
• <PROJECT-ID> pelo ID do projeto.
• <INSTANCE-REGION> por us-central1.
• <INSTANCE-NAME> pelo ID da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• <YOUR_DB_USER_NAME> por quickstart-user.
• <YOUR_DB_PASSWORD> pela senha de quickstart-user que você criou em Criar um usuário.
• <YOUR_DB_NAME> por quickstart-db.
7. No prompt de comando do Cloud Shell, no diretório golang-samples/cloudsql/postgres/database-sql, execute o seguinte comando gcloud app deploy para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

gcloud app deploy cmd/app/app.standard.yaml

8. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
9. Quando a mensagem Você quer continuar? aparecer, digite Y.
10. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no arquivo appengine-web.xml pelos seguintes valores:
• my-project:region:instance com o Nome de conexão da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• my-db-user por quickstart-user.
• my-db-password pela senha de quickstart-user que você criou em Criar um usuário.
• my_db por quickstart-db.
7. No prompt de comando do Cloud Shell, no diretório java-docs-samples/cloud-sql/postgres/servlet, execute o seguinte comando do Apache Maven mvn clean package para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

mvn clean package appengine:deploy -DskipTests

8. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
9. Quando a mensagem Você quer continuar? aparecer, digite Y.
10. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.

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, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no arquivo app.standard.yaml pelos seguintes valores:
• <MY-PROJECT> pelo ID do projeto.
• <INSTANCE-REGION> por us-central1.
• <INSTANCE-NAME> pelo ID da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• MY_DB_USER por quickstart-user.
• MY_DB_PASSWORD pela senha de quickstart-user que você criou em Criar um usuário.
• MY_DATABASE por quickstart-db.
7. No prompt de comando do Cloud Shell, no diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute o seguinte comando gcloud app deploy para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

8. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
9. Quando a mensagem Você quer continuar? aparecer, digite Y.
10. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no arquivo app.standard.yaml pelos seguintes valores:
• <PROJECT-ID> pelo ID do projeto.
• <INSTANCE-REGION> por us-central1.
• <INSTANCE-NAME> pelo ID da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• <YOUR_DB_USER_NAME> por quickstart-user.
• <YOUR_DB_PASSWORD> pela senha de quickstart-user que você criou em Criar um usuário.
• <YOUR_DB_NAME> por quickstart-db.
7. No prompt de comando do Cloud Shell, no diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute o seguinte comando gcloud app deploy para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

8. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
9. Quando a mensagem Você quer continuar? aparecer, digite Y.
10. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.

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, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
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. No menu de navegação do Explorer do Cloud Shell Editor, navegue até a pasta golang-samples/cloudsql/postgres/database-sql/certs.
   2. Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
   3. Selecione os seguintes arquivos na máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. 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. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml e abra-o.
7. Copie e cole o seguinte código no arquivo, substituindo o conteúdo nele:

runtime: go116

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 3306
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Faça as seguintes substituições de variáveis:
• YOUR_DB_PASSWORD pela senha de quickstart-user que você criou em Criar um usuário.
• INSTANCE_HOST pelo endereço IP particular da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• PROJECT_ID pelo ID do projeto.
9. No prompt de comando do Cloud Shell, no diretório golang-samples/cloudsql/postgres/database-sql, execute o seguinte comando gcloud app deploy para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

gcloud app deploy cmd/app/app.standard.yaml

10. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
11. Quando a mensagem Você quer continuar? aparecer, digite Y.
12. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

13. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud 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 exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
3. No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
4. Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
5. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml e abra-o.
6. Copie e cole o seguinte código no arquivo appengine-web.xml, substituindo o conteúdo dele:

<runtime>java17</runtime>
  <env-variables>
    <env-var name="INSTANCE_CONNECTION_NAME" value="project-name:region-name:instance-name" />
    <env-var name="DB_PORT" value="5432" />
    <env-var name="DB_USER" value="quickstart-user" />
    <env-var name="DB_PASS" value="my-db-password" />
    <env-var name="DB_NAME" value="quickstart-db" />
  </env-variables>
<vpc-access-connector>
  <name>projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector</name>
  <egress-setting>all-traffic</egress-setting>
</vpc-access-connector>

7. Faça as seguintes substituições de variáveis:
• project-name:region-name:instance-name com o Nome de conexão da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• my-db-password pela senha de quickstart-user que você criou em Criar um usuário.
• PROJECT_ID pelo ID do projeto.
8. No prompt de comando do Cloud Shell, no diretório java-docs-samples/cloud-sql/postgres/servlet, execute o seguinte comando do Apache Maven mvn clean package para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

mvn clean package appengine:deploy -DskipTests

9. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
10. Quando a mensagem Você quer continuar? aparecer, digite Y.
11. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

12. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.

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, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
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. No menu de navegação do Explorer do Cloud Shell Editor, navegue até a pasta nodejs-docs-samples/cloud-sql/postgres/knex/certs.
   2. Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
   3. Selecione os seguintes arquivos na máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. 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. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml e abra-o.
7. Copie e cole o seguinte código no arquivo, substituindo o conteúdo dele:

runtime: nodejs16

env_variables:
  DB_USER: quickstart-user
  DB_PASS: MY_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Faça as seguintes substituições de variáveis:
• MY_DB_PASSWORD pela senha de quickstart-user que você criou em Criar um usuário.
• INSTANCE_HOST pelo endereço IP particular da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• PROJECT_ID pelo ID do projeto.
9. No prompt de comando do Cloud Shell, no diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute o seguinte comando gcloud app deploy para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

10. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
11. Quando a mensagem Você quer continuar? aparecer, digite Y.
12. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

13. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud 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.

   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, execute o seguinte comando para ativar o projeto:

   gcloud config set project YOUR-PROJECT-ID

   Observação: substitua YOUR-PROJECT-ID pelo ID do projeto.
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. No menu de navegação do Explorer do Cloud Shell Editor, navegue até a pasta python-docs-samples/cloud-sql/postgres/sqlalchemy/certs.
   2. Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
   3. Selecione os seguintes arquivos na máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. 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. No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml e abra-o.
7. Copie e cole o seguinte código no arquivo, substituindo o conteúdo dele:

runtime: python37
entrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Faça as seguintes substituições de variáveis:
• YOUR_DB_PASSWORD pela senha de quickstart-user que você criou em Criar um usuário.
• INSTANCE_HOST pelo endereço IP particular da instância que aparece na página Instâncias do Cloud SQL no console Google Cloud .
• PROJECT_ID pelo ID do projeto.
9. No prompt de comando do Cloud Shell, no diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute o seguinte comando gcloud app deploy para implantar o aplicativo de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

10. Se for necessário escolher a região para criar o aplicativo, insira a escolha numérica de us-central.
11. Quando a mensagem Você quer continuar? aparecer, digite Y.
12. Quando o comando de implantação for concluído, execute o comando gcloud app browse:

gcloud app browse

13. Clique no link gerado para ver o aplicativo de exemplo em execução no ambiente padrão do App Engine. Esse ambiente está 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. Desativar o app impedirá que ele execute instâncias e atenda a solicitações. Se o aplicativo estiver processando uma solicitação, ele a concluirá antes de ser desativado.

Para desativar um aplicativo do App Engine e manter os dados dele, faça o seguinte:

1. No console do Google Cloud, acesse a página Configurações:

   Acesse configurações

2. Na guia Configurações do aplicativo, clique em Desativar aplicativo.

3. No campo ID do app, insira o ID do aplicativo que você quer desativar e clique em Desativar.

Etapas de limpeza opcionais

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

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

   Acessar IAM

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

Se você não estiver usando as APIs que foram ativadas como parte deste guia de início rápido, é possível desativá-las.

• APIs que foram ativadas neste guia de início rápido:
  • API Compute Engine
  • API Cloud SQL Admin
  • API Cloud Run
  • API Container Registry
  • API Cloud Build

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

   Acesse APIs

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

A seguir

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

Também é possível aprender a criar usuários do 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
• A partir do Cloud Run functions
• no Cloud Run