Estabeleça ligação ao Cloud SQL para PostgreSQL a partir do Compute Engine

Estabeleça ligação ao Cloud SQL para PostgreSQL a partir do Compute Engine

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implementar uma app de exemplo na sua instância de VM do Compute Engine baseada em Linux ou Windows ligada 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 numa instância de VM do Compute Engine.

   Consola

   Clique no botão Ativar APIs para ativar a API necessária para este início rápido.

   Ative as APIs

   Isto ativa a seguinte API:

   • API Cloud SQL Admin

   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 ou numa janela do Powershell.

   Execute o seguinte comando gcloud:

   gcloud services enable sqladmin.googleapis.com

   Este comando ativa a seguinte API:

   • API Cloud SQL Admin

Configure o Cloud SQL

Crie uma instância do Cloud SQL

IP público

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 PostgreSQL.
4. No campo ID da instância, introduza quickstart-instance.
5. No campo Palavra-passe, introduza uma palavra-passe para o utilizador do postgres. Guarde esta palavra-passe para utilização futura.
6. Na secção Escolher região e disponibilidade zonal, selecione Zona única.
7. Expanda a secção Mostrar configurações.
8. Na lista pendente Tipo de máquina, selecione Leve.
9. Clique em Create Instance e, de seguida, 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 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. 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

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 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 Mostrar opções de configuração.
8. Para Tipo de máquina, selecione Leve.
9. Em Ligações, selecione IP privado.
10. Selecione predefinição no menu pendente Rede.
11. Desmarque a caixa de verificação IP público para criar uma instância apenas com um IP privado.
12. Clique em Criar instância e, de seguida, aguarde que a instância seja inicializada e iniciada.
13. Clique em Ligações.
14. Na secção Segurança, selecione Permitir apenas ligações SSL para ativar as ligações SSL.
15. 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 do 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 beta sql instances create quickstart-instance --database-version=POSTGRES_13 --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. 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 do 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

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.

Configure uma conta de serviço do Compute Engine

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 Adicionar outra função e escolha a função Visualizador de objetos do Storage para conceder à conta de serviço no projeto.
8. Clique em Continuar.
9. Clique em Concluído para terminar de criar a conta de serviço.

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 Cliente do Cloud SQL e a função Visualizador de objetos do Storage 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" --role="roles/storage.objectViewer"

Crie uma instância de VM do Compute Engine

Crie uma instância de VM do Compute Engine para alojar uma app Web de exemplo que se ligue ao Cloud SQL.

Crie uma instância de VM Linux

Consola

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Clique no botão Criar instância.
3. Em Nome da instância de VM, introduza quickstart-vm-instance.
4. Para Contas de serviço, selecione quickstart-service-account.
5. Para Firewall, selecione a opção Permitir tráfego HTTP.
6. Clique em Criar para criar a instância de VM.

gcloud

Antes de executar o comando seguinte, substitua YOUR_PROJECT_ID pelo ID do seu projeto.

Execute o seguinte comando gcloud compute instances create.

gcloud compute instances create quickstart-vm-instance --image-family=debian-10 --image-project=debian-cloud  --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Crie uma instância de VM do Windows

Consola

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Clique no botão Criar instância.
3. Em Nome da instância de VM, introduza quickstart-vm-instance.
4. Para Disco de arranque, clique no botão Alterar.
1. Para Sistema operativo, selecione Windows Server.
2. Em Versão, selecione Windows Server 2022 Datacenter.
3. Clique no botão Selecionar.
5. Para Contas de serviço, selecione quickstart-service-account.
6. Para Firewall, selecione a opção Permitir tráfego HTTP.
7. Clique em Criar para criar a instância de VM.
8. Após 2 a 3 minutos, quando a instância de VM for iniciada, clique no botão Definir palavra-passe do Windows na página de detalhes da instância de VM.
9. Copie e guarde esta palavra-passe num local seguro, pois vai usá-la para aceder à sua instância de VM no passo seguinte deste início rápido.

gcloud

Antes de executar o comando seguinte, substitua YOUR_PROJECT_ID pelo ID do seu projeto.

Execute o seguinte comando gcloud compute instances create numa janela do terminal.

gcloud compute instances create quickstart-vm-instance --image-project=windows-cloud --image-family=windows-2022 --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Após 2 a 3 minutos, quando a instância de VM tiver sido iniciada, execute o seguinte comando para definir a palavra-passe do Windows na instância de VM.

gcloud compute reset-windows-password quickstart-vm-instance

Copie e guarde esta palavra-passe num local seguro, pois vai usá-la para aceder à sua instância de VM no passo seguinte deste início rápido.

Aceda à instância de VM do Compute Engine

Aceda à instância de VM do Linux

Consola

Na Google Cloud consola, aceda à página Instâncias de VM.

Aceder às instâncias de VM

Na lista de instâncias de máquinas virtuais, clique em SSH na linha da instância à qual quer estabelecer ligação.

Nota: quando se liga a VMs através da Google Cloud consola, o Compute Engine cria uma chave SSH efémera para si. Para mais informações acerca das chaves SSH, consulte Ligações SSH a VMs do Linux

gcloud

Use o comando gcloud compute ssh para estabelecer ligação a uma instância da VM do Linux. Substitua YOUR_PROJECT_ID pelo ID do seu projeto:

gcloud compute ssh --project=YOUR_PROJECT_ID --zone=us-central1-a quickstart-vm-instance

Aceda à instância de VM do Windows

Plugin Chrome RDP

O Chrome RDP para Google Cloud é um plugin de terceiros que lhe permite estabelecer ligação a instâncias do Windows através do navegador Chrome. O plugin está integrado na Google Cloud consola. Depois de instalar o plug-in, ligue-se a qualquer instância do Windows Server através do botão RDP no Google Cloud console.

Para estabelecer ligação através do plug-in Chrome RDP, faça o seguinte:

1. Instale a extensão Chrome RDP for Google Cloud.
2. Na Google Cloud consola, aceda à página Instâncias de VM e encontre a instância do Windows à qual quer ligar-se.

Aceda à página de instâncias de VM

3. Clique no botão RDP para a instância à qual quer estabelecer ligação. A extensão do Chrome RDP é aberta.
4. Uma vez que a sua instância de VM não tem um domínio configurado, pode deixar o campo Domínio em branco
5. Introduza o nome de utilizador e a palavra-passe e clique em OK para estabelecer ligação.

6. Se lhe for pedido, prima Continuar para aceitar o certificado.

Outro

Consulte o artigo Estabeleça ligação a VMs do Windows através do RDP para ver mais opções de acesso a uma instância de VM do Windows do Compute Engine.

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

Configure o ambiente de programação da instância de VM do Compute Engine para a sua linguagem de programação preferida.

Configure o ambiente de programação da instância de VM Linux

Ir

Conclua os passos seguintes para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar a app de exemplo 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 da instância de VM do Compute Engine 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 da instância de VM do Compute Engine 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 da instância de VM do Compute Engine 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.

Configure o ambiente de programação da instância de VM do Windows

Ir

Conclua os passos seguintes para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar a app de exemplo 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 da instância de VM do Compute Engine 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. Conclua as instruções na secção 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 da instância de VM do Compute Engine 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 da instância de VM do Compute Engine para executar a app de exemplo do Python.

1. Instale o Python e o gestor de pacotes PIP para 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.
1. As instruções acima indicam que deve visitar a página de transferência Python Releases for Windows. Nessa página, clique no link Último lançamento do Python 3.
2. Na página do Python 3.X.X, clique no link Windows Installer 64-bit para transferir o ficheiro do instalador para a instância da VM do Windows Compute Engine.
3. Depois de transferir o instalador do Python para a instância de VM, abra a pasta que contém o ficheiro transferido. Em seguida, clique com o botão direito do rato no ficheiro do instalador e selecione Executar como administrador.
4. Na caixa de diálogo Instalar Python apresentada, selecione a opção para Adicionar Python 3.X.X ao PATH e clique em → Instalar agora.
2. Use o PIP para instalar o virtualenv.
1. Abra o Powershell na instância de VM do Compute Engine do Windows e execute o seguinte comando pip install.

pip install virtualenv

Instale o Git

Instale o Git, um sistema de controlo de versões de código aberto, na instância de VM do Compute Engine.

Instância de VM do Linux do Compute Engine

Na instância de VM Linux do Compute Engine, siga a documentação de instalação oficial do Git para Linux.

• Execute o comando Debian/Ubuntu sugerido install git com o prefixo de comando sudo para executar o comando como administrador. O comando de instalação completo a executar no terminal deve ser formatado da seguinte forma:

sudo apt-get install git

Instância de VM do Windows do Compute Engine

Na instância de VM do Windows do Compute Engine, siga a documentação oficial de instalação do Git para Windows para transferir o instalador autónomo de 64 bits e executá-lo para instalar o Git.

Clone a app de exemplo

Clone uma app de exemplo para a sua instância de VM do Compute Engine através do comando git clone.

Ir

Na instância de VM do Compute Engine, abra um novo terminal ou uma janela do Powershell. Execute os seguintes comandos para clonar a app de exemplo Go 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

Na instância de VM do Compute Engine, abra um novo terminal ou uma janela do Powershell. Execute os seguintes comandos para clonar a app de exemplo Java 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

Na instância de VM do Compute Engine, abra um novo terminal ou uma janela do Powershell. Execute os seguintes comandos para clonar a app de exemplo do Node.js 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

Na instância de VM do Compute Engine, abra um novo terminal ou uma janela do Powershell. Execute os seguintes comandos para clonar a app de exemplo do Python 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 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 uma aplicação de exemplo em execução na sua instância de VM do Compute Engine para se ligar à sua instância do Cloud SQL.

Instância do Cloud SQL com IP público e VM do Compute Engine baseada em Linux

Ir

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

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'

Na instância da VM do Compute Engine no terminal aberto, execute os seguintes comandos para obter as dependências da app de exemplo Go na instância da VM do Compute Engine 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

No computador local, obtenha o endereço IP externo da instância de VM do Compute Engine onde a app de exemplo está a ser executada e veja-o num navegador.

Nota: este passo de início rápido requer a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, obtenha o endereço IP externo da instância de VM do Compute Engine executando o seguinte comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Veja a app de exemplo em execução. Abra um navegador no seu computador local e aceda ao endereço IP externo e à porta :8080 da instância de VM do Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Java

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

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'

Na instância de VM do Compute Engine no terminal aberto, execute o seguinte comando para obter as dependências da app de exemplo Java na instância de VM do Compute Engine e executar a app de exemplo.

mvn jetty:run

No computador local, obtenha o endereço IP externo da instância de VM do Compute Engine onde a app de exemplo está a ser executada e veja-o num navegador.

Nota: este passo de início rápido requer a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, obtenha o endereço IP externo da instância de VM do Compute Engine executando o seguinte comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Veja a app de exemplo em execução. Abra um navegador no seu computador local e aceda ao endereço IP externo e à porta :8080 da instância de VM do Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Node.js

1. Na instância de VM do Compute Engine no terminal aberto, 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 a seguinte substituição:

   • YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

   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. Defina autorizações para tornar o ficheiro do proxy Auth do Cloud SQL executável.

   chmod +x cloud-sql-proxy

4. 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 Instâncias do Cloud SQL na Google Cloud consola.

   ./cloud-sql-proxy 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 as teclas Ctrl + C para parar a tarefa de proxy.

Na instância de VM do Compute Engine no terminal aberto, execute os seguintes comandos para transferir os pacotes Node.js necessários para a instância de VM do Compute Engine 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

No computador local, obtenha o endereço IP externo da instância de VM do Compute Engine onde a app de exemplo está a ser executada e veja-o num navegador.

Nota: este passo de início rápido requer a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, obtenha o endereço IP externo da instância de VM do Compute Engine executando o seguinte comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Veja a app de exemplo em execução. Abra um navegador no seu computador local e aceda ao endereço IP externo e à porta :8080 da instância de VM do Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Python

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

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'

Na instância de VM do Compute Engine no terminal aberto, execute os seguintes comandos para obter os requisitos da app de exemplo do Python na instância de VM do Compute Engine e executar a app de exemplo.

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

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

2. Execute a app de exemplo.

   python app.py

No computador local, configure o encaminhamento de porta através de SSH seguindo as instruções no passo seguinte do início rápido. Isto permite-lhe usar um navegador no seu computador local para ver a app em execução na instância de VM do Compute Engine.

Nota: este passo de início rápido requer a CLI gcloud, que dá acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, execute o seguinte comando gcloud compute ssh para configurar o encaminhamento de porta através de SSH. Antes de executar o comando, substitua YOUR_PROJECT_ID pelo ID do seu projeto.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. Veja a app de exemplo em execução. Com o encaminhamento de portas em execução ativa, abra um navegador no seu computador local e introduza http://127.0.0.1:8000 na barra de endereço do navegador.

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Instância do Cloud SQL com IP público e VM do Compute Engine baseada no Windows

Ir

Na instância de VM do Compute Engine na janela do PowerShell aberta, 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:

• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

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

Na instância de VM do Compute Engine na janela do Powershell aberta, execute os seguintes comandos para transferir as dependências da app de exemplo Go para a instância de VM do Compute Engine 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 um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Java

Na instância de VM do Compute Engine na janela do PowerShell aberta, 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:

• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$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. Na instância de VM do Compute Engine na janela do Powershell aberta, execute o seguinte comando para transferir as dependências da app de exemplo Java para a instância de VM do Compute Engine e executar a app de exemplo.

   mvn jetty:run

2. Veja a app de exemplo em execução. Abra um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Node.js

1. Na instância de VM do Compute Engine na janela do PowerShell aberta, 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 a seguinte substituição:

   • YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

   $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 Instâncias do Cloud SQL na Google Cloud consola.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "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. Em seguida, feche a janela para parar a tarefa de proxy.

Na instância de VM do Compute Engine na janela do Powershell aberta, execute os seguintes comandos para transferir os pacotes Node.js necessários para a instância de VM do Compute Engine 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 um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Python

Na instância de VM do Compute Engine na janela do PowerShell aberta, 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:

• INSTANCE_CONNECTION_NAME com o nome de ligação da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

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

Na instância de VM do Compute Engine na janela do Powershell aberta, execute os seguintes comandos para obter os requisitos da app de exemplo do Python na instância de VM do Compute Engine e executar a app de exemplo.

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

   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 um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Instância do Cloud SQL de IP privado e VM do Compute Engine baseada em Linux

Crie e transfira certificados de cliente e servidor SSL para o seu computador local

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.

Carregue certificados SSL para o contentor do Cloud Storage

Consola

Num navegador no seu computador local, crie um contentor do Cloud Storage e carregue certificados SSL para o contentor, onde podem ser acedidos a partir da instância de VM do Compute Engine.

1. Crie um contentor do Cloud Storage.
1. Em Nome do seu contentor, introduza o seguinte nome. Substitua YOUR_PROJECT_ID pelo ID do seu projeto:

   YOUR_PROJECT_ID-quickstart-certs

2. Clique no botão Criar para criar o contentor.
2. Clique no botão Carregar ficheiros para carregar ficheiros para o contentor do Cloud Storage criado recentemente.
3. Selecione os seguintes ficheiros a carregar do seu computador local para o Cloud Storage:
• server-ca.pem
• client-cert.pem
• client-key.pem

gcloud

No seu computador local, numa janela de terminal ou do Powershell aberta para o diretório onde transferiu os certificados SSL, pode agora criar um contentor do Cloud Storage e carregar os certificados SSL para o contentor, onde podem ser acedidos a partir da instância de VM do Compute Engine. A CLI gcloud vai ser usada para carregar os ficheiros.

1. Execute o seguinte comando gcloud storage buckets create para criar um novo contentor do Cloud Storage:

gcloud storage buckets create gs://YOUR_PROJECT_ID-quickstart-certs --location=us-central1

2. No diretório onde transferiu os certificados para o seu computador local, execute os seguintes comandos gcloud storage cp para copiar os certificados SSL para o contentor do Cloud Storage recém-criado:

gcloud storage cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-cert.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-key.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Ir

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine, num terminal aberto ao diretório golang-samples/cloudsql/postgres/database-sql , execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export DB_CERT='certs/client-cert.pem'
export DB_KEY='certs/client-key.pem'
export PRIVATE_IP='TRUE'

Na instância da VM do Compute Engine no terminal aberto, execute os seguintes comandos para obter as dependências da app de exemplo Go na instância da VM do Compute Engine 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

No computador local, obtenha o endereço IP externo da instância de VM do Compute Engine onde a app de exemplo está a ser executada e veja-o num navegador.

Nota: este passo de início rápido requer a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, obtenha o endereço IP externo da instância de VM do Compute Engine executando o seguinte comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Veja a app de exemplo em execução. Abra um navegador no seu computador local e aceda ao endereço IP externo e à porta :8080 da instância de VM do Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Java

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância da VM do Compute Engine num terminal aberto ao diretório java-docs-samples/cloud-sql/postgres/servlet, execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório atual.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem .

Configure os certificados SSL para utilização em Java na instância de VM do Compute Engine

1. No terminal da instância de VM do Compute Engine, execute o seguinte comando para converter o certificado e a chave PEM transferidos num arquivo PKCS12 através do openssl. Antes de executar o comando seguinte, substitua SSL_CLIENT_KEY_PASSWD pela sua própria palavra-passe do repositório de chaves personalizado a usar para criar o repositório de chaves do cliente Java.

openssl pkcs12 -export -in client-cert.pem -inkey client-key.pem \
-name "postgresclient" -passout pass:SSL_CLIENT_KEY_PASSWD \
-out client-keystore.p12

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• SSL_CLIENT_KEY_PASSWD com a palavra-passe que especificou para criar o keystore do cliente Java com openssl no passo de início rápido anterior.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export SSL_CLIENT_KEY_PATH='client-keystore.p12'
export SSL_CLIENT_KEY_PASSWD='SSL_CLIENT_KEY_PASSWD'
export SSL_SERVER_CA_PATH='server-ca.pem'
export PRIVATE_IP='TRUE'

Na instância de VM do Compute Engine no terminal aberto, execute o seguinte comando para obter as dependências da app de exemplo Java na instância de VM do Compute Engine e executar a app de exemplo.

mvn jetty:run

No computador local, obtenha o endereço IP externo da instância de VM do Compute Engine onde a app de exemplo está a ser executada e veja-o num navegador.

Nota: este passo de início rápido requer a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, obtenha o endereço IP externo da instância de VM do Compute Engine executando o seguinte comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Veja a app de exemplo em execução. Abra um navegador no seu computador local e aceda ao endereço IP externo e à porta :8080 da instância de VM do Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Node.js

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine num terminal aberto ao diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export DB_CERT='certs/client-cert.pem'
export DB_KEY='certs/client-key.pem'
export PRIVATE_IP='TRUE'

Na instância de VM do Compute Engine no terminal aberto, execute os seguintes comandos para transferir os pacotes Node.js necessários para a instância de VM do Compute Engine 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

No computador local, obtenha o endereço IP externo da instância de VM do Compute Engine onde a app de exemplo está a ser executada e veja-o num navegador.

Nota: este passo de início rápido requer a CLI gcloud, que fornece acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, obtenha o endereço IP externo da instância de VM do Compute Engine executando o seguinte comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Veja a app de exemplo em execução. Abra um navegador no seu computador local e aceda ao endereço IP externo e à porta :8080 da instância de VM do Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Python

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine num terminal aberto ao diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine no terminal aberto, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export DB_CERT='certs/client-cert.pem'
export DB_KEY='certs/client-key.pem'
export PRIVATE_IP='TRUE'

Na instância de VM do Compute Engine no terminal aberto, execute os seguintes comandos para obter os requisitos da app de exemplo do Python na instância de VM do Compute Engine e executar a app de exemplo.

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

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

2. Execute a app de exemplo.

   python app.py

No seu computador local, configure o encaminhamento de porta através de SSH seguindo as instruções no passo de início rápido seguinte. Isto permite-lhe usar um navegador no seu computador local para ver a app em execução na instância de VM do Compute Engine.

Nota: este passo de início rápido requer a CLI gcloud, que dá acesso à linha de comandos aos seus Google Cloud recursos através de comandos gcloud CLI. Se não tiver a CLI gcloud instalada no seu computador local, instale a CLI gcloud para continuar.

1. Num terminal ou no Powershell no seu computador local, execute o seguinte comando gcloud compute ssh para configurar o encaminhamento de porta através de SSH. Antes de executar o comando, substitua YOUR_PROJECT_ID pelo ID do seu projeto.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. Veja a app de exemplo em execução. Com o encaminhamento de portas em execução ativa, abra um navegador no seu computador local e introduza http://127.0.0.1:8000 na barra de endereço do navegador.

   

Para parar a app de exemplo, prima Control+C no terminal da instância de VM do Compute Engine onde iniciou a app de exemplo.

Instância do Cloud SQL de IP privado e VM do Compute Engine baseada no Windows

Crie e transfira certificados de cliente e servidor SSL para o seu computador local

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.

Carregue certificados SSL para o contentor do Cloud Storage

Consola

Num navegador no seu computador local, crie um contentor do Cloud Storage e carregue certificados SSL para o contentor, onde podem ser acedidos a partir da instância de VM do Compute Engine.

1. Crie um contentor do Cloud Storage.
1. Em Nome do seu contentor, introduza o seguinte nome. Substitua YOUR_PROJECT_ID pelo ID do seu projeto:

   YOUR_PROJECT_ID-quickstart-certs

2. Clique no botão Criar para criar o contentor.
2. Clique no botão Carregar ficheiros para carregar ficheiros para o contentor do Cloud Storage criado recentemente.
3. Selecione os seguintes ficheiros a carregar do seu computador local para o Cloud Storage:
• server-ca.pem
• client-cert.pem
• client-key.pem

gcloud

No seu computador local, numa janela de terminal ou do Powershell aberta para o diretório onde transferiu os certificados SSL, pode agora criar um contentor do Cloud Storage e carregar os certificados SSL para o contentor, onde podem ser acedidos a partir da instância de VM do Compute Engine. A CLI gcloud vai ser usada para carregar os ficheiros.

1. Execute o seguinte comando gcloud storage buckets create para criar um novo contentor do Cloud Storage:

gcloud storage buckets create gs://YOUR_PROJECT_ID-quickstart-certs --location=us-central1

2. No diretório onde transferiu os certificados para o seu computador local, execute os seguintes comandos gcloud storage cp para copiar os certificados SSL para o contentor do Cloud Storage recém-criado:

gcloud storage cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-cert.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-key.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Ir

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine numa janela do PowerShell aberta para o diretório golang-samples/cloudsql/postgres/database-sql, execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine na janela do PowerShell, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:DB_CERT="certs/client-cert.pem"
$env:DB_KEY="certs/client-key.pem"
$env:PRIVATE_IP="TRUE"

Na instância de VM do Compute Engine na janela do Powershell aberta, execute os seguintes comandos para transferir as dependências da app de exemplo Go para a instância de VM do Compute Engine 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 um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Java

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine, numa janela do Powershell aberta para o diretório java-docs-samples/cloud-sql/postgres/servlet , execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório atual.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem .

Configure os certificados SSL para utilização em Java na instância de VM do Compute Engine

1. No terminal da instância de VM do Compute Engine, execute o seguinte comando para converter o certificado e a chave PEM transferidos num arquivo PKCS12 através do openssl. Antes de executar o comando seguinte, substitua SSL_CLIENT_KEY_PASSWD pela sua própria palavra-passe do repositório de chaves personalizado a usar para criar o repositório de chaves do cliente Java.

openssl pkcs12 -export -in client-cert.pem -inkey client-key.pem `
-name "postgresclient" -passout pass:SSL_CLIENT_KEY_PASSWD `
-out client-keystore.p12

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine na janela do PowerShell, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.
• SSL_CLIENT_KEY_PASSWD com a palavra-passe que especificou para SSL_CLIENT_KEY_PASSWD.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:SSL_CLIENT_KEY_PATH="client-keystore.p12"
$env:SSL_CLIENT_KEY_PASSWD="SSL_CLIENT_KEY_PASSWD"
$env:SSL_SERVER_CA_PATH="server-ca.pem"
$env:PRIVATE_IP="TRUE"

1. Na instância de VM do Compute Engine na janela do Powershell aberta, execute o seguinte comando para transferir as dependências da app de exemplo Java para a instância de VM do Compute Engine e executar a app de exemplo.

   mvn jetty:run

2. Veja a app de exemplo em execução. Abra um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Node.js

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine numa janela do PowerShell aberta para o diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine na janela do PowerShell, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:DB_CERT="certs/client-cert.pem"
$env:DB_KEY="certs/client-key.pem"
$env:PRIVATE_IP="TRUE"

Na instância de VM do Compute Engine na janela do Powershell aberta, execute os seguintes comandos para transferir os pacotes Node.js necessários para a instância de VM do Compute Engine 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 um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine onde iniciou a app de exemplo.

Python

Transfira certificados SSL através da CLI gcloud na instância de VM do Compute Engine

Na instância de VM do Compute Engine numa janela do PowerShell aberta para o diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute os seguintes comandos gcloud storage cp para transferir os certificados SSL do Cloud Storage para o diretório certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

Defina variáveis de ambiente na instância de VM do Compute Engine

Na instância de VM do Compute Engine na janela do PowerShell, 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:

• INSTANCE_HOST definido como o endereço IP privado da sua instância apresentado na página Instâncias do Cloud SQL na Google Cloud consola.
Nota: as ligações a uma instância do Cloud SQL através de um endereço IP privado são autorizadas automaticamente para intervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte o artigo Saiba como usar o IP privado.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou no passo de início rápido Crie um utilizador anterior.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:DB_CERT="certs/client-cert.pem"
$env:DB_KEY="certs/client-key.pem"
$env:PRIVATE_IP="TRUE"

Na instância de VM do Compute Engine na janela do Powershell aberta, execute os seguintes comandos para obter os requisitos da app de exemplo do Python na instância de VM do Compute Engine e executar a app de exemplo.

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

   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 um navegador na instância de VM do Compute Engine e aceda a http://127.0.0.1:8080.

   

Para parar a app de exemplo, prima Control+C na janela do Powershell da instância de VM do Compute Engine 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.

Elimine a instância do Cloud SQL

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.

Elimine uma instância de VM do Compute Engine

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Selecione a instância quickstart-vm-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. 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 Compute Engine default, 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 a API que foi ativada como parte deste início rápido, pode desativá-la.

• API ativada neste guia de início rápido:
  • API Cloud SQL Admin

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