Ligue-se ao Cloud SQL para PostgreSQL a partir do seu computador local

Ligue-se ao Cloud SQL para PostgreSQL a partir do seu computador local

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implementar uma app de exemplo no seu computador local baseado em Linux, macOS ou Windows 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 seu computador local.

   Consola

   Clique no botão Ativar APIs 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 IAM

   gcloud

   Instale a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos. A CLI gcloud é usada para executar os comandos gcloud CLI apresentados ao longo deste início rápido. Todos os comandos estão formatados para serem executados num terminal Linux/macOS ou no Windows Powershell.

   Abra o terminal e execute o seguinte comando gcloud:

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   Este comando ativa as seguintes APIs:

   • API Cloud SQL Admin
   • API IAM

Configure o Cloud SQL

Crie uma instância do Cloud SQL

Consola

Crie uma instância com um endereço IP público

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. Introduza quickstart-instance para o ID da instância.
5. Introduza uma palavra-passe para o utilizador do postgres. Guarde esta palavra-passe para utilização futura.
6. Clique na opção Zona única para Escolher região e disponibilidade zonal.
7. Clique e expanda a secção Mostrar opções de configuração.
8. No menu pendente Tipo de máquina, selecione Leve.

9. Clique em Criar instância e aguarde até a instância ser inicializada e iniciada.

gcloud

Crie uma instância com um endereço IP público

Antes de executar o comando gcloud sql instances create 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 do gcloud para ver as versões atualmente disponíveis.
• --cpu: o número de núcleos a definir na máquina.
• --memory: valor numérico inteiro que indica a quantidade de memória a definir 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. Veja a lista completa de regiões.

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

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

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. Abra o separador Bases de dados.
4. Clique em Criar base de dados.
1. Na caixa de diálogo Nova base de dados, introduza quickstart_db como o nome da base de dados.
   
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. Selecione Utilizadores no menu de navegação SQL.
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:
   • No campo Nome de utilizador, introduza quickstart-user
   • No campo Palavra-passe, especifique uma palavra-passe para o utilizador da base de dados. Anote esta informação para usar num passo posterior deste início rápido.
6. Clique em Adicionar.

gcloud

Substitua o seguinte:

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.

Configure uma conta de serviço

Crie e configure uma Google Cloud conta de serviço que tenha a função de cliente do Cloud SQL com autorizações para estabelecer ligação ao Cloud SQL. Depois de criar uma conta de serviço, pode ter de aguardar 60 segundos ou mais antes de a usar.

Consola

Criar uma conta de serviço

1. Na Google Cloud consola, aceda à página Criar conta de serviço.

Aceda a Criar conta de serviço

2. Selecione um Google Cloud projeto.
3. Introduza quickstart-service-account como nome da conta de serviço.
4. Opcional: introduza uma descrição da conta de serviço.
5. Clique em Criar e continuar e avance para o passo seguinte.
6. Escolha a função de cliente do Cloud SQL para conceder à conta de serviço no projeto.
7. Clique em Continuar.
8. Clique em Concluído para terminar de criar a conta de serviço.

Crie e transfira o ficheiro de chave da conta de serviço

1. Na Google Cloud consola, aceda à página Contas de serviço.

Aceda a Contas de serviço

2. Selecione um projeto.
3. Clique no endereço de email da quickstart-service-accountconta de serviço para a qual quer criar uma chave.
4. Clique no separador Chaves.
5. Clique no menu pendente Adicionar chave e, de seguida, selecione Criar nova chave.
6. Selecione JSON como o Tipo de chave e clique em Criar.

Se clicar em Criar, transfere um ficheiro de chave da conta de serviço. Depois de transferir o ficheiro de chave, não o pode transferir novamente.

Certifique-se de que armazena o ficheiro de chave em segurança, uma vez que pode ser usado para autenticar como a sua conta de serviço. Pode mover e mudar o nome deste ficheiro como quiser.

gcloud

Criar uma conta de serviço

1. Para criar a conta de serviço, execute o comando gcloud iam service-accounts create:

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

Substitua o seguinte valor:

• DESCRIPTION: uma descrição opcional da conta de serviço
2. Para conceder à sua conta de serviço a função de cliente do Cloud SQL no seu projeto, execute o comando gcloud projects add-iam-policy-binding. Substitua PROJECT_ID pelo ID do seu projeto do Google Cloud:

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Crie e transfira o ficheiro de chave da conta de serviço

Para usar a conta de serviço que acabou de criar a partir do seu computador local, precisa de um ficheiro de chave da conta de serviço para autenticar a aplicação de exemplo como a conta de serviço. Para criar e transferir o ficheiro de chave da conta de serviço, execute o comando gcloud iam service-accounts keys create:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Substitua os seguintes valores:

• KEY_FILE: o caminho para um novo ficheiro de saída para a chave privada, por exemplo, ~/sa-private-key.json.
• PROJECT_ID: o ID do seu projeto do Google Cloud.

O ficheiro de chave da conta de serviço é agora transferido para o seu computador local. Depois de transferir o ficheiro de chave, não o pode transferir novamente.

Certifique-se de que armazena o ficheiro de chave em segurança, uma vez que qualquer pessoa o pode usar para se autenticar como a sua conta de serviço. Pode mover e mudar o nome deste ficheiro como quiser.

Configure o ambiente de programação para a linguagem de programação

Configure o ambiente de desenvolvimento do seu computador local para o seu idioma de programação preferido.

Ir

Conclua os passos seguintes para configurar o ambiente de desenvolvimento para executar a app de exemplo do Go.

1. Aceda ao guia de configuração de um ambiente de programação Go.
2. Conclua as instruções na secção Instalar Go.

Java

Conclua os passos seguintes para configurar o ambiente de desenvolvimento para executar a app de exemplo Java.

1. Aceda ao guia de configuração de um ambiente de programação Java.
2. Siga as instruções na secção Instale um JDK (Java Development Kit).
3. Siga as instruções em Instale uma ferramenta de automatização de compilação para configurar o Apache Maven.

Node.js

Conclua os passos seguintes para configurar o ambiente de desenvolvimento para executar a app de exemplo do Node.js.

1. Aceda ao guia de configuração de um ambiente de desenvolvimento Node.js.
2. Siga as instruções na secção Instalar o Node.js e o npm.

Python

Conclua os passos seguintes para configurar o ambiente de desenvolvimento para executar a app de exemplo do Python.

1. Aceda ao guia de configuração de um ambiente de programação Python.
2. Conclua as instruções na secção Instalar o Python.

Instale o Git

Instale o Git, um sistema de controlo de versões de código aberto.

Linux

Siga a documentação de instalação do Git oficial para Linux.

macOS

Siga a documentação de instalação do Git oficial para macOS.

Windows

Siga a documentação de instalação do Git oficial para Windows.

Clone uma app de exemplo

Clone uma app de exemplo para o seu computador local através do comando git clone.

Ir

Execute os seguintes comandos para clonar a app de exemplo Go para o seu computador local e alterar o diretório para o diretório que contém a app de exemplo.

1. Clone a app de exemplo.

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. Altere o diretório para o diretório que contém a app de exemplo.

   cd golang-samples/cloudsql/postgres/database-sql

Java

Execute os seguintes comandos para clonar a app de exemplo Java para o seu computador local e alterar o diretório para o diretório que contém a app de exemplo.

1. Clone a app de exemplo.

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. Altere o diretório para o diretório que contém a app de exemplo.

   cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Execute os seguintes comandos para clonar a app de exemplo do Node.js para o seu computador local e alterar o diretório para o diretório que contém a app de exemplo.

1. Clone a app de exemplo.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. Altere o diretório para o diretório que contém a app de exemplo.

   cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Execute os seguintes comandos para clonar a app de exemplo do Python para o seu computador local e alterar o diretório para o diretório que contém a app de exemplo.

1. Clone a app de exemplo.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Altere o diretório para o diretório que contém a app de exemplo.

   cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Configure e execute a app de exemplo

Configure e execute a app de exemplo.

Linux/macOS

Ir

Abra o terminal e execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância que aparece na página Vista geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Execute os seguintes comandos para obter as dependências da app de exemplo Go no seu computador local e executar a app de exemplo.

1. Obtenha as dependências necessárias para executar a app de exemplo.

   go get ./...

2. Execute a app de exemplo.

   go run cmd/app/main.go

3. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

4. Para parar a app de exemplo, prima Control+C na janela de terminal onde iniciou a app de exemplo.

Java

Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância que aparece na página Vista geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. Execute o seguinte comando para obter as dependências da app de exemplo Java no seu computador local e executar a app de exemplo.

   mvn jetty:run

2. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

3. Para parar a app de exemplo, prima Control+C na janela de terminal onde iniciou a app de exemplo.

Node.js

1. Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

   • CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
   • YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='5432'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'

2. Transfira o proxy Auth do Cloud SQL.

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Execute o proxy Auth do Cloud SQL como um processo em segundo plano. Substitua INSTANCE_CONNECTION_NAME pelo nome de ligação da instância que aparece na página Vista geral da instância do Cloud SQL.

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

Nota: o processo que executa o proxy Auth do Cloud SQL em segundo plano pode ser parado através do comando fg na janela do terminal onde iniciou a app de exemplo. Isto deve trazer a tarefa de execução do proxy Auth do Cloud SQL para o primeiro plano do terminal. Em seguida, prima Control+C para parar a tarefa de proxy.

Execute os seguintes comandos para obter os pacotes Node.js necessários no seu computador local e executar a app de exemplo.

1. Instale os pacotes Node.js necessários para executar a app localmente.

   npm install

2. Execute a app de exemplo.

   npm start

3. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

4. Para parar a app de exemplo, prima Control+C na janela de terminal onde iniciou a app de exemplo.

Python

Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância que aparece na página Vista geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Execute os seguintes comandos para transferir os requisitos da app de exemplo do Python para o seu computador local e executar a app de exemplo.

1. Inicialize um ambiente virtual e instale os requisitos para executar a app de exemplo.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt

2. Execute a app de exemplo.

   python app.py

3. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

4. Para parar a app de exemplo, prima Control+C na janela de terminal onde iniciou a app de exemplo.

Windows

Ir

Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância que aparece na página Vista geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Execute os seguintes comandos para obter as dependências da app de exemplo Go no seu computador local e executar a app de exemplo.

1. Obtenha as dependências necessárias para executar a app de exemplo.

   go get ./...

2. Execute a app de exemplo.

   go run cmd\app\main.go

3. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

4. Para parar a app de exemplo, prima Control+C na janela do Powershell onde iniciou a app de exemplo.

Java

Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância que aparece na página Vista geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Execute o seguinte comando para obter as dependências da app de exemplo Java no seu computador local e executar a app de exemplo.

   mvn jetty:run

2. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

3. Para parar a app de exemplo, prima Control+C na janela do Powershell onde iniciou a app de exemplo.

Node.js

1. Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

   • CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
   • YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="5432"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"

2. Transfira o proxy Auth do Cloud SQL.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe 
   -O cloud-sql-proxy.exe

3. Execute o proxy Auth do Cloud SQL como um processo em segundo plano. Substitua INSTANCE_CONNECTION_NAME pelo nome de ligação da instância que aparece na página Vista geral da instância do Cloud SQL.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

Nota: o processo que executa o proxy Auth do Cloud SQL em segundo plano pode ser parado selecionando a janela cmd.exe gerada pelo comando Start-Process. Feche a janela para parar a tarefa de proxy.

Execute os seguintes comandos para obter os pacotes Node.js necessários no seu computador local e executar a app de exemplo.

1. Instale os pacotes Node.js necessários para executar a app localmente.

   npm install

2. Execute a app de exemplo.

   npm start

3. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

4. Para parar a app de exemplo, prima Control+C na janela do Powershell onde iniciou a app de exemplo.

Python

Execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar a app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• CREDENTIALS_JSON_FILE com o caminho do ficheiro da chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância que aparece na página Vista geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Execute os seguintes comandos para obter os requisitos da app de exemplo do Python no seu computador local e executar a app de exemplo.

1. Inicialize um ambiente virtual e instale os requisitos para executar a app de exemplo.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt

2. Execute a app de exemplo.

   python app.py

3. Veja a app de exemplo em execução. Abra uma janela do navegador e aceda a http://127.0.0.1:8080.

   

4. Para parar a app de exemplo, prima Control+C na janela do Powershell onde iniciou a app de exemplo.

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.

Passos de limpeza opcionais

Se não estiver a usar a função de cliente do Cloud SQL que atribuiu à conta de serviço quickstart-service-account, 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 do IAM denominada quickstart-service-account.
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 Cloud SQL Admin
  • API Identity and Access Management

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