Estabeleça ligação ao Cloud SQL para PostgreSQL a partir do ambiente padrão do App Engine

Estabeleça ligação ao Cloud SQL para PostgreSQL a partir do ambiente padrão do App Engine

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implementar uma app de exemplo no ambiente padrão do App Engine ligado a uma instância do PostgreSQL através da Google Cloud consola e de uma aplicação cliente.

Partindo do princípio de que conclui todos os passos atempadamente, os recursos criados neste início rápido custam normalmente menos de um dólar (USD).

Antes de começar

Nota: O nome que usa para o seu projeto tem de ter entre 4 e 30 carateres. Quando escreve o nome, o formulário sugere um ID do projeto, que pode editar. O ID do projeto tem de ter entre 6 e 30 carateres, com uma letra minúscula como o primeiro caráter. Pode usar um traço, uma letra minúscula ou um dígito para os carateres restantes, mas o último caráter não pode ser um traço.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Ative as APIs Cloud necessárias para executar uma app de exemplo do Cloud SQL no ambiente padrão do App Engine.

   Consola

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

   Ative as APIs

   Isto ativa as seguintes APIs:

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

   gcloud

   Clique no botão seguinte para abrir o Cloud Shell, que oferece acesso à linha de comandos aos seus Google Cloud recursos diretamente a partir do navegador. Pode usar o Cloud Shell para executar os comandos gcloud apresentados ao longo deste início rápido.

   Abra o Cloud Shell

   Execute o seguinte comando gcloud através da Cloud Shell:

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

   Este comando ativa as seguintes APIs:

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

Configure o Cloud SQL

Crie uma instância do Cloud SQL

IP público

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em Escolher PostgreSQL.
4. Certifique-se de que a edição do Cloud SQL para a sua instância é a Enterprise Plus.
5. No campo ID da instância, introduza quickstart-instance.
6. No campo Palavra-passe, introduza uma palavra-passe para o utilizador do postgres. Guarde esta palavra-passe para utilização futura.
7. Na secção Escolher região e disponibilidade zonal, selecione Zona única.
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áquinas, selecione a forma 4 vCPU, 32 GB.
11. Clique em Criar instância e, de seguida, aguarde até a instância ser inicializada e iniciada.

gcloud

Antes de executar o comando da seguinte forma, substitua DB_ROOT_PASSWORD pela palavra-passe do utilizador da base de dados.

Opcionalmente, modifique os valores dos seguintes parâmetros:

• --database-version: o tipo e a versão do motor da base de dados. Se não for especificado, é usada a predefinição da API. Consulte a documentação versões da base de dados gcloud para ver as versões atualmente disponíveis.
• --cpu: O número de núcleos desejado na máquina.
• --memory: valor numérico inteiro que indica a quantidade de memória pretendida na máquina. Deve ser indicado um valor de tamanho (por exemplo, 3072 MB ou 9 GB). Se não forem especificadas unidades, é assumido que são GB.
• --region: localização regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, é usado o valor predefinido us-central.

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

Consola

Atribua um intervalo de endereços IP e crie uma ligação privada para configurar o acesso privado a serviços para o Cloud SQL

1. Na Google Cloud consola, aceda à página Redes VPC.

   Aceda a redes de VPC

2. Selecione a rede de VPC default.
3. Selecione o separador Ligação de serviço privada.
4. Selecione o separador Intervalos de IP atribuídos para serviços.
5. Clique em Atribuir intervalo de IPs.
6. Para o Nome do intervalo atribuído, especifique google-managed-services-default.
7. Selecione a opção Automático para o intervalo de IP e especifique o comprimento do prefixo como 16.
8. Clique em Atribuir para criar o intervalo atribuído.
9. Selecione o separador Ligações privadas a serviços para a rede VPC default.
10. Clique em Criar ligação para criar uma ligação privada entre a sua rede e um produtor de serviços.
11. Para a Atribuição atribuída, selecione google-managed-services-default.
12. Clique em Associar para criar a associação.

Crie uma instância com um endereço IP privado e SSL ativado

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em Escolher PostgreSQL.
4. Certifique-se de que a edição do Cloud SQL para a sua instância é a Enterprise Plus.
5. No campo ID da instância, introduza quickstart-instance.
6. No campo Palavra-passe, introduza uma palavra-passe para o utilizador do postgres. Guarde esta palavra-passe para utilização futura.
7. Na secção Escolher região e disponibilidade zonal, selecione Zona única.
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áquinas, selecione a forma 4 vCPU, 32 GB.
11. Expanda o nó Associações.
12. Desmarque a caixa de verificação IP público para criar uma instância apenas com um endereço IP privado.
13. Selecione a caixa de verificação IP privado.
14. No menu Rede, selecione predefinição.
15. Clique em Criar instância e, de seguida, aguarde que a instância seja inicializada e iniciada.
16. Clique em Ligações.
17. Na secção Segurança, selecione Permitir apenas ligações SSL para ativar as ligações SSL.
18. Na caixa de diálogo Permitir apenas ligações SSL, clique em Guardar e, de seguida, aguarde que a instância seja reiniciada.

gcloud

Atribua um intervalo de endereços IP e crie uma ligação privada para configurar o acesso privado a serviços para o Cloud SQL

1. Execute o comando gcloud compute addresses create para atribuir 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 ligação privada ao intervalo de endereços IP atribuído. 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

Crie uma instância com um endereço IP privado e SSL ativado

1. Antes de executar o comando da seguinte forma, substitua DB_ROOT_PASSWORD pela palavra-passe do utilizador da base de dados.

Opcionalmente, modifique os valores dos seguintes parâmetros:

• --database-version: o tipo e a versão do motor da base de dados. Se não for especificado, é usada a predefinição da API. Consulte a documentação versões da base de dados gcloud para ver as versões atualmente disponíveis.
• --cpu: o número de núcleos na máquina.
• --memory: um valor numérico inteiro que indica a quantidade de memória a incluir na máquina. Pode indicar uma unidade de tamanho (por exemplo, 3072 MB ou 9 GB). Se não forem especificadas unidades, é assumido que são GB.
• --region: a localização regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, é usado o valor predefinido us-central1. 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 a opção Permitir apenas ligações SSL para a instância.

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

Crie uma base de dados

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Selecione quickstart-instance.
3. No menu de navegação SQL, selecione Bases de dados.
4. Clique em Criar base de dados.
1. No campo Nome da base de dados da caixa de diálogo Nova base de dados, introduza quickstart-db.
2. Clique em Criar.

gcloud

Execute o comando gcloud sql databases create para criar uma base de dados.

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

Crie um utilizador

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
3. No menu de navegação SQL, selecione Utilizadores.
4. Clique em Adicionar conta de utilizador.
5. Na página Adicione uma conta de utilizador à instância instance_name, adicione as seguintes informações:
   1. No campo Nome de utilizador, introduza quickstart-user.
   2. No campo Palavra-passe, especifique uma palavra-passe para o utilizador da base de dados. Anote esta palavra-passe para utilização num passo posterior deste início rápido.
6. Clique em Adicionar.

gcloud

Antes de executar o seguinte comando, faça as seguintes substituições:

1. PASSWORD com uma palavra-passe para o utilizador da base de dados. Anote esta informação para usar num passo posterior deste início rápido.

Execute o comando gcloud sql users create para criar o utilizador.

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

Os limites de comprimento dos nomes de utilizador são os mesmos para o Cloud SQL e para o PostgreSQL no local.

Implemente uma app de exemplo no ambiente padrão do App Engine

Crie a aplicação do App Engine

Crie a aplicação do App Engine no seu Google Cloud projeto. Isto ativa o serviço do App Engine, cria uma aplicação do App Engine predefinida e cria uma conta de serviço do App Engine que vai ser usada para estabelecer ligação ao Cloud SQL.

Nota: só tem de realizar este passo uma vez por Google Cloud projeto.

Consola

1. Na Google Cloud consola, aceda à página App Engine.

   Aceder ao App Engine

2. Clique no botão Criar aplicação.
3. Selecione us-central no menu pendente Selecionar uma região.
4. Clicar em Seguinte.
5. Clique no link Faço isto mais tarde assim que aparecer na página Começar.

gcloud

1. Execute o seguinte comando gcloud app create para criar uma aplicação do App Engine:

gcloud app create

2. Quando lhe for pedido que escolha a região onde quer que a sua aplicação do App Engine esteja localizada, introduza a opção numérica para us-central.

Configure a conta de serviço do App Engine

Configure a conta de serviço usada pelo App Engine para que tenha a função cliente do Cloud SQL com autorizações para se ligar ao Cloud SQL.

Consola

1. Na Google Cloud consola, aceda à página IAM.

   Aceda ao IAM

2. Para a conta de serviço denominada Conta de serviço predefinida do App Engine, clique no ícone de lápis.
   Nota: O nome da conta de serviço é apresentado junto ao principal da conta. O nome do principal é [e-mail].
3. Clique em Adicionar outra função.
4. Adicione a função denominada Cliente do Cloud SQL.
5. Clique em Guardar.

gcloud

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

   gcloud iam service-accounts list

2. Copie o EMAIL da conta de serviço do App Engine.
3. Execute o seguinte comando para adicionar a função Cliente do Cloud SQL à conta de serviço do App Engine:

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

Configure e implemente uma app de exemplo do Cloud SQL

Com uma instância, uma base de dados e uma conta de serviço do Cloud SQL com autorizações de cliente, já pode configurar e implementar uma aplicação de exemplo para estabelecer ligação à sua instância do Cloud SQL.

IP público

Para caminhos de IP público, o ambiente padrão do App Engine fornece encriptação e estabelece ligação através do proxy Auth do Cloud SQL através de sockets Unix.

Ir

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

   Abra o editor do Cloud Shell

2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro 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 ficheiro app.standard.yaml pelos seguintes valores:
• <PROJECT-ID> com o ID do seu projeto.
• <INSTANCE-REGION> com us-central1.
• <INSTANCE-NAME> com o ID da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• <YOUR_DB_USER_NAME> com quickstart-user.
• <YOUR_DB_PASSWORD> com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• <YOUR_DB_NAME> com quickstart-db.
7. Na linha de comandos do Cloud Shell, no diretório golang-samples/cloudsql/postgres/database-sql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

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

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Java

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

   Abra o editor do Cloud Shell

2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro 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 ficheiro appengine-web.xml pelos seguintes valores:
• my-project:region:instance com o nome de ligação da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• my-db-user com quickstart-user.
• my-db-password com a palavra-passe do quickstart-user que criou em Criar um utilizador.
• my_db com quickstart-db.
7. Na linha de comandos do Cloud Shell, no diretório java-docs-samples/cloud-sql/postgres/servlet, execute o seguinte comando Apache Maven mvn clean package para implementar a app de exemplo no ambiente padrão do App Engine.

mvn clean package appengine:deploy -DskipTests

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Node.js

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

   Abra o editor do Cloud Shell

2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro 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 ficheiro app.standard.yaml pelos seguintes valores:
• <MY-PROJECT> com o ID do seu projeto.
• <INSTANCE-REGION> com us-central1.
• <INSTANCE-NAME> com o ID da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• MY_DB_USER com quickstart-user.
• MY_DB_PASSWORD com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• MY_DATABASE com quickstart-db.
7. Na linha de comandos do Cloud Shell, no diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Python

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

   Abra o editor do Cloud Shell

2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro 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 ficheiro app.standard.yaml pelos seguintes valores:
• <PROJECT-ID> com o ID do seu projeto.
• <INSTANCE-REGION> com us-central1.
• <INSTANCE-NAME> com o ID da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• <YOUR_DB_USER_NAME> com quickstart-user.
• <YOUR_DB_PASSWORD> com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• <YOUR_DB_NAME> com quickstart-db.
7. Na linha de comandos do Cloud Shell, no diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

11. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

IP privado

Para caminhos de IP privado, a sua aplicação liga-se diretamente à instância através do acesso a VPC sem servidor. Este método usa um socket TCP para se ligar diretamente à instância do Cloud SQL sem usar o proxy Auth do Cloud SQL.

Ir

Crie e transfira certificados de cliente e servidor SSL

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a respetiva página Vista geral
3. Clique no separador Ligações.
4. Na secção Segurança, clique em Criar certificado de cliente.
5. Na caixa de diálogo Criar um certificado de cliente, introduza quickstart-key como nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de transferência para transferir os certificados. Em seguida, clique em Fechar.

   Importante: armazene esta chave privada em segurança. Se o perder, tem de criar um novo certificado de cliente.

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IPs
6. Clique em Criar para criar o conector.

Crie uma app de exemplo com certificados SSL

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. Carregue ficheiros de certificados SSL para a pasta certs.
   1. No menu de navegação do Explorador do Cloud Shell Editor, navegue para a pasta golang-samples/cloudsql/postgres/database-sql/certs.
   2. Clique com o botão direito do rato na pasta certs no editor do Cloud Shell e selecione Carregar ficheiros
   3. Selecione os seguintes ficheiros na sua máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Com os três ficheiros de certificado SSL selecionados, clique em Abrir para concluir o processo de carregamento dos ficheiros para o Cloud Shell Editor.
6. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml e abra-o.
7. Copie e cole o seguinte código no ficheiro, substituindo o conteúdo do ficheiro existente:

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 com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• INSTANCE_HOST com o endereço IP privado da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• PROJECT_ID com o ID do seu projeto.
9. Na linha de comandos do Cloud Shell, no diretório golang-samples/cloudsql/postgres/database-sql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

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

10. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

13. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Java

Crie e transfira certificados de cliente e servidor SSL

Para os utilizadores do Java, o conetor já fornece uma ligação segura para que a criação e a transferência de certificados SSL de servidor e cliente sejam desnecessárias.

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IPs
6. Clique em Criar para criar o conector.

Crie uma app de exemplo

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro 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 ficheiro appengine-web.xml, substituindo o conteúdo do ficheiro existente:

<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 ligação da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• my-db-password com a palavra-passe do quickstart-user que criou em Criar um utilizador.
• PROJECT_ID com o ID do seu projeto.
8. Na linha de comandos do Cloud Shell, no diretório java-docs-samples/cloud-sql/postgres/servlet, execute o seguinte comando Apache Maven mvn clean package para implementar a app de exemplo no ambiente padrão do App Engine.

mvn clean package appengine:deploy -DskipTests

9. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
10. Quando lhe for perguntado Quer continuar?, introduza Y.
11. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

12. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Node.js

Crie e transfira certificados de cliente e servidor SSL

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a respetiva página Vista geral
3. Clique no separador Ligações.
4. Na secção Segurança, clique em Criar certificado de cliente.
5. Na caixa de diálogo Criar um certificado de cliente, introduza quickstart-key como nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de transferência para transferir os certificados. Em seguida, clique em Fechar.

   Importante: armazene esta chave privada em segurança. Se o perder, tem de criar um novo certificado de cliente.

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IPs
6. Clique em Criar para criar o conector.

Crie uma app de exemplo com certificados SSL

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. Carregue ficheiros de certificados SSL para a pasta certs.
   1. No menu de navegação do Explorador do Cloud Shell Editor, navegue para a pasta nodejs-docs-samples/cloud-sql/postgres/knex/certs.
   2. Clique com o botão direito do rato na pasta certs no editor do Cloud Shell e selecione Carregar ficheiros
   3. Selecione os seguintes ficheiros na sua máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Com os três ficheiros de certificado SSL selecionados, clique em Abrir para concluir o processo de carregamento dos ficheiros para o Cloud Shell Editor.
6. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml e abra-o.
7. Copie o seguinte código e cole-o no ficheiro, substituindo o conteúdo do ficheiro existente:

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 com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• INSTANCE_HOST com o endereço IP privado da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• PROJECT_ID com o ID do seu projeto.
9. Na linha de comandos do Cloud Shell, no diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

10. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

13. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Python

Crie e transfira certificados de cliente e servidor SSL

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a respetiva página Vista geral
3. Clique no separador Ligações.
4. Na secção Segurança, clique em Criar certificado de cliente.
5. Na caixa de diálogo Criar um certificado de cliente, introduza quickstart-key como nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de transferência para transferir os certificados. Em seguida, clique em Fechar.

   Importante: armazene esta chave privada em segurança. Se o perder, tem de criar um novo certificado de cliente.

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IPs
6. Clique em Criar para criar o conector.

Crie uma app de exemplo com certificados SSL

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.
3. Na linha de comandos do Cloud Shell, execute o seguinte comando para ativar o seu projeto:

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. Carregue ficheiros de certificados SSL para a pasta certs.
   1. No menu de navegação do Explorador do Cloud Shell Editor, navegue para a pasta python-docs-samples/cloud-sql/postgres/sqlalchemy/certs.
   2. Clique com o botão direito do rato na pasta certs no editor do Cloud Shell e selecione Carregar ficheiros
   3. Selecione os seguintes ficheiros na sua máquina local:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Com os três ficheiros de certificado SSL selecionados, clique em Abrir para concluir o processo de carregamento dos ficheiros para o Cloud Shell Editor.
6. No menu de navegação do Explorador do Cloud Shell Editor, navegue para o ficheiro python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml e abra-o.
7. Copie o seguinte código e cole-o no ficheiro, substituindo o conteúdo do ficheiro existente:

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 com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• INSTANCE_HOST com o endereço IP privado da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• PROJECT_ID com o ID do seu projeto.
9. Na linha de comandos do Cloud Shell, no diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

10. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Quando o comando de implementação estiver concluído, execute o comando gcloud app browse:

gcloud app browse

13. Clique no link gerado para ver a app de exemplo em execução no ambiente padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a 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 Eliminar.
4. Na caixa de diálogo Eliminar instância, escreva quickstart-instance e, de seguida, clique em Eliminar para eliminar a instância. A desativação da sua app impede a execução de instâncias e a publicação de pedidos. Se a sua app estiver a processar um pedido, conclui o pedido antes de ser desativada.

Para desativar uma app do App Engine e reter os respetivos dados, faça o seguinte:

1. Na Google Cloud consola, aceda à página Definições:

   Aceda às Definições

2. No separador Definições da aplicação, clique em Desativar aplicação.

3. No campo ID da app, introduza o ID da app que quer desativar e, em seguida, clique em Desativar.

Passos de limpeza opcionais

Se não estiver a usar a função de cliente do Cloud SQL que atribuiu à conta de serviço do Compute Engine, pode removê-la.

1. Na Google Cloud consola, aceda à página IAM.

   Aceda ao IAM

2. Clique no ícone de edição (que se assemelha a um lápis) para a conta de IAM denominada Conta de serviço predefinida do Compute Engine.
3. Elimine a função cliente do Cloud SQL.
4. Clique em Guardar.

Se não estiver a usar as APIs que foram ativadas como parte deste início rápido, pode desativá-las.

• APIs 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. Na Google Cloud consola, aceda à página APIs.

   Aceder às APIs

2. Selecione qualquer API que queira desativar e, de seguida, clique no botão Desativar API.

O que se segue?

Com base nas suas necessidades, pode saber mais sobre como criar instâncias do Cloud SQL.

Também pode saber como criar utilizadores do PostgreSQL e bases de dados para a sua instância do Cloud SQL.

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

Saiba mais sobre:

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

Além disso, pode saber como estabelecer ligação a uma instância do Cloud SQL a partir de outras aplicações do Google Cloud:

• A partir de uma aplicação em execução no ambiente padrão do App Engine
• A partir de uma aplicação em execução no Compute Engine
• A partir de uma aplicação executada no GKE
• Do Cloud Run