O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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

MySQL | PostgreSQL | SQL Server

Saiba como implementar uma app de exemplo no ambiente flexível do App Engine ligado a uma instância do PostgreSQL através da Google Cloud consola e de uma app 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

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Ative as APIs Cloud necessárias para executar uma app de exemplo do Cloud SQL no ambiente flexível 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:
- Cloud SQL Admin API
- API Compute Engine
- API Cloud Build
- Cloud Logging API
Ao clicar no botão, também ativa o Google App Engine Flexible Environment.
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 appengineflex.googleapis.com sqladmin.googleapis.com \
compute.googleapis.com cloudbuild.googleapis.com logging.googleapis.com
```
Este comando ativa as seguintes APIs:
- Cloud SQL Admin API
- API Compute Engine
- API Cloud Build
- Cloud Logging API
Ao executar o comando acima, também ativa o ambiente flexível do Google App Engine.

Configure o Cloud SQL

Crie uma instância do Cloud SQL

IP público

Consola

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

Aceda a Instâncias do Cloud SQL
Clique em Criar instância.
Clique em Escolher PostgreSQL.
Certifique-se de que a edição do Cloud SQL para a sua instância é a Enterprise Plus.
No campo ID da instância, introduza quickstart-instance.
No campo Palavra-passe, introduza uma palavra-passe para o utilizador do postgres. Guarde esta palavra-passe para utilização futura.
Na secção Escolher região e disponibilidade por zona, selecione Zona única.
Clique no menu Mostrar opções de configuração.
Expanda o nó Configuração da máquina.
Na região Formas de máquinas, selecione a forma 4 vCPU, 32 GB.
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 disponíveis atuais.
--cpu: o número de núcleos desejados 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

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

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

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

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

Aceda a Instâncias do Cloud SQL
Clique em Criar instância.
Clique em Escolher PostgreSQL.
Certifique-se de que a edição do Cloud SQL para a sua instância é a Enterprise Plus.
No campo ID da instância, introduza quickstart-instance.
No campo Palavra-passe, introduza uma palavra-passe para o utilizador do postgres. Guarde esta palavra-passe para utilização futura.
Na secção Escolher região e disponibilidade por zona, selecione Zona única.
Clique no menu Mostrar opções de configuração.
Expanda o nó Configuração da máquina.
Na região Formas de máquinas, selecione a forma 4 vCPU, 32 GB.
Expanda o nó Ligações.
Desmarque a caixa de verificação IP público para criar uma instância apenas com um endereço IP privado.
Selecione a caixa de verificação IP privado.
No menu Rede, selecione predefinição.
Clique em Criar instância e, de seguida, aguarde que a instância seja inicializada e iniciada.
Clique em Ligações.
Na secção Segurança, selecione Permitir apenas ligações SSL para ativar as ligações SSL.
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

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

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

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 disponíveis atuais.
--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