Conectar-se ao Cloud SQL para PostgreSQL pelo Compute Engine

Conectar-se ao Cloud SQL para PostgreSQL pelo Compute Engine

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implantar um aplicativo de amostra em sua instância de VM do Compute Engine baseada em Linux ou Windows conectada a uma instância do PostgreSQL usando o console do Google Cloud e um aplicativo de cliente.

Supondo que você conclua todas as etapas em tempo hábil, os recursos criados neste guia de início rápido normalmente custam menos de um dólar (USD).

Antes de começar

Observação: o nome usado para seu projeto precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que pode ser editado. O ID do projeto precisa ter entre 6 e 30 caracteres, com uma letra minúscula como primeiro caractere. É possível usar um traço, uma letra minúscula ou um dígito para os caracteres restantes, mas o último caractere não pode ser um traço.

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

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

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

   Go to project selector

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

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

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

   Go to project selector

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

6. Ativar as APIs do Cloud necessárias para executar um app de amostra do Cloud SQL em uma instância de VM do Compute Engine.

   Console

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

   Ative as APIs

   Isso ativa a seguinte API:

   • API Cloud SQL Admin

   gcloud

   Instale a CLI gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud. A CLI gcloud é usada para executar os comandos gcloud CLI apresentados neste guia de início rápido. Todos os comandos são formatados para serem executados em um terminal ou uma janela do PowerShell.

   Execute o seguinte comando gcloud:

   gcloud services enable sqladmin.googleapis.com

   Este comando ativa a seguinte API:

   • API Cloud SQL Admin

Configurar o Cloud SQL

crie uma instância do Cloud SQL

IP público

Console

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

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

   Acesse Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em PostgreSQL.
4. No campo ID da instância, insira quickstart-instance.
5. No campo Senha, insira uma senha para o usuário postgres. Salve essa senha para uso futuro.
6. Na seção Escolher disponibilidade de região e zona, selecione Única zona.
7. Expanda a seção Mostrar configurações.
8. Na lista suspensa Tipo de máquina, selecione Leve.
9. Clique em Criar instância e aguarde até que a instância seja inicializada.

gcloud

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

Antes de executar o comando gcloud sql instances create da seguinte maneira, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.

Se quiser, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do mecanismo de banco de dados. Se não for especificado, a API padrão será usada. Consulte a documentação das versões de banco de dados do gcloud para ver as versões atuais disponíveis.
• --cpu: o número de núcleos desejados na máquina.
• --memory: valor inteiro que indica a quantidade de memória desejada na máquina. Uma unidade de tamanho precisa ser fornecida (por exemplo, 3.072 MB ou 9 GB). Se nenhuma unidade for especificada, serão considerados GB.
• --region: local regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, o padrão us-central será utilizado. 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

Console

Alocar um intervalo de endereço IP e criar uma conexão particular para configurar o acesso a serviços particulares do Cloud SQL

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

   Acessar redes VPC

2. Selecione a rede VPC default.
3. Selecione a guia Conexão de serviço privado.
4. Selecione a guia Intervalos de IP alocados para serviços.
5. Clique em Alocar intervalo de IP.
6. Em Nome do intervalo alocado, especifique google-managed-services-default.
7. Selecione a opção Automático para o intervalo de IP e especifique o tamanho do prefixo como 16.
8. Clique em Alocar para criar o intervalo alocado.
9. Selecione a guia Conexões particulares com serviços para a rede VPC default.
10. Clique em Criar conexão para criar uma conexão particular entre a rede e um produtor de serviços.
11. Em Alocação atribuída, selecione google-managed-services-default.
12. Clique em Conectar para criar a conexão.

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

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

   Acesse Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em PostgreSQL.
4. Insira quickstart-instance para o ID da instância.
5. Insira uma senha para o usuário postgres. Salve essa senha para uso futuro.
6. Clique na opção Zona única em Escolher disponibilidade por região e zona.
7. Clique e expanda Mostrar opções de configuração.
8. Em Tipo de máquina, selecione Leve.
9. Em Conexões, selecione IP particular.
10. Selecione padrão no menu suspenso Rede.
11. Desmarque a caixa de seleção IP público para criar uma instância apenas com um IP privado.
12. Clique em Criar instância e aguarde a inicialização da instância.
13. Clique em Conexões.
14. Na seção Segurança, selecione Permitir apenas conexões SSL para ativar conexões SSL.
15. Na caixa de diálogo Permitir apenas conexões SSL, clique em Salvar e aguarde a reinicialização da instância.

gcloud

Alocar um intervalo de endereço IP e criar uma conexão particular para configurar o acesso a serviços particulares do Cloud SQL

1. Execute o comando gcloud compute addresses create para alocar um intervalo de endereços IP.

   gcloud compute addresses create google-managed-services-default --global --purpose=VPC_PEERING --prefix-length=16 --description="peering range for Google" --network=default

2. Execute o comando gcloud services vpc-peerings connect para criar uma conexão particular com o intervalo de endereços IP alocado. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=google-managed-services-default --network=default --project=YOUR_PROJECT_ID

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

1. Antes de executar o comando abaixo, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.

Se quiser, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do mecanismo de banco de dados. Se não for especificado, a API padrão será usada. Consulte a documentação das versões de banco de dados do gcloud para ver as versões atuais disponíveis.
• --cpu: o número de núcleos na máquina;
• --memory: um valor inteiro que indica quanta memória incluir na máquina. Uma unidade de tamanho pode ser fornecida (por exemplo, 3.072 MB ou 9 GB). Se nenhuma unidade for especificada, serão considerados GB.
• --region: local regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, o padrão us-central1 será utilizado. Veja a lista completa de regiões.

Execute o comando gcloud sql instances create para criar uma instância do Cloud SQL com um endereço IP privado.

gcloud 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 apenas permitir conexões SSL para a instância.

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

Crie um banco de dados

Console

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

   Acesse Instâncias do Cloud SQL

2. Selecione quickstart-instance.
3. Abra a guia Bancos de dados.
4. Clique em Criar banco de dados.
1. Na caixa de diálogo Novo banco de dados, insira quickstart_db como o nome do banco de dados.
   
2. Clique em Criar.

gcloud

Execute o comando gcloud sql databases create para criar um banco de dados.

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

Criar um usuário

Console

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

   Acesse "Instâncias do Cloud SQL"

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Selecione Usuários no menu de navegação do SQL.
4. Clique em Adicionar conta de usuário.
5. Na página Adicionar uma conta de usuário à instância instance_name, adicione as seguintes informações:
   • No campo Nome de usuário, digite quickstart-user.
   • No campo Password, especifique uma senha para o usuário do banco de dados. Anote-a para usá-la em uma etapa posterior deste guia de início rápido.
6. Clique em Add.

gcloud

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

1. PASSWORD por uma senha para seu usuário do banco de dados. Anote-a para usá-la em uma etapa posterior deste guia de início rápido.

Execute o comando gcloud sql users create para criar o usuário.

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

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

Configurar uma conta de serviço do Compute Engine

Crie e configure uma conta de serviço do Google Cloud que tenha o papel Cliente do Cloud SQL com permissões para se conectar ao Cloud SQL. Depois de criar uma conta de serviço, talvez seja necessário aguardar 60 segundos ou mais para usar essa conta.

Console

Criar uma conta de serviço

1. No Console do Google Cloud, acesse a página Criar conta de serviço.

Acesse "Criar conta de serviço"

2. Selecione um projeto do Google Cloud.
3. Insira quickstart-service-account como o nome da conta de serviço.
4. Opcional: digite uma descrição da conta de serviço.
5. Clique em Criar e continuar e avance para a próxima etapa.
6. Escolha o papel de Cliente do Cloud SQL a ser concedido à conta de serviço no projeto.
7. Clique em Adicionar outro papel e escolha o papel Leitor de objetos do Storage para conceder à conta de serviço no projeto.
8. Clique em Continuar.
9. Clique em Concluído para terminar a criação da 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 o papel Cliente do Cloud SQL e o papel Leitor de objetos do Storage no seu projeto, execute o comando gcloud projects add-iam-policy-binding. Substitua PROJECT_ID pelo ID do 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"

Criar uma instância de VM do Compute Engine

Criar uma instância de VM do Compute Engine para hospedar um aplicativo da Web de amostra que se conecta ao Cloud SQL.

Crie uma instância de VM do Linux

Console

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

   Acessar instâncias de VM

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

gcloud

Antes de executar o comando a seguir, substitua YOUR_PROJECT_ID pelo ID do 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

Criar uma instância de VM do Windows

Console

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

   Acessar instâncias de VM

2. Clique no botão Criar instância.
3. Em Nome da instância de VM, insira quickstart-vm-instance.
4. Em Disco de inicialização, clique no botão Alterar.
1. Em Sistema operacional, selecione Windows Server.
2. Em Versão, selecione Windows Server 2022 Datacenter.
3. Clique no botão Selecionar.
5. Em Contas de serviço, selecione quickstart-service-account.
6. Em Firewall, selecione a opção Permitir tráfego HTTP.
7. Clique em Criar para gerar a instância de VM.
8. Após 2 a 3 minutos da inicialização da instância de VM, clique no botão Definir senha do Windows na página de detalhes da instância.
9. Copie e salve essa senha em um local seguro porque ela será usada para acessar sua instância de VM na próxima etapa deste guia de início rápido.

gcloud

Antes de executar o comando a seguir, substitua YOUR_PROJECT_ID pelo ID do projeto.

Execute o seguinte comando gcloud compute instances create em uma 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 da inicialização da instância da VM, execute o seguinte comando para definir a senha do Windows na instância da VM.

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

Copie e salve essa senha em um local seguro porque ela será usada para acessar sua instância de VM na próxima etapa deste guia de início rápido.

Acessar a instância da VM do Compute Engine

Acessar instância de VM Linux

Console

No console do Google Cloud, acesse a página Instâncias de VMs.

Acessar instâncias de VM

Na lista de instâncias de máquina virtual, clique em SSH na linha da instância à qual você quer se conectar.

Observação: quando você se conecta a VMs usando o console do Google Cloud, o Compute Engine cria uma chave SSH temporária para você. Para mais informações sobre chaves SSH, consulte Conexões SSH com VMs do Linux.

gcloud

Use o comando gcloud compute ssh para se conectar a uma instância de VM do Linux. Substitua YOUR_PROJECT_ID pelo ID do projeto:

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

Acessar instância da VM do Windows

Plug-in Chrome RDP

O Chrome RDP para Google Cloud é um plug-in terceirizado que possibilita a conexão com instâncias do Windows usando o navegador Chrome. O plug-in é integrado ao Console do Google Cloud. Depois de instalar o plug-in, conecte-se a qualquer instância do Windows Server usando o botão RDP no Console do Google Cloud.

Para se conectar usando o plug-in Chrome RDP, faça o seguinte:

1. Instale a extensão Chrome RDP para Google Cloud.
2. No Console do Google Cloud, acesse a página Instâncias de VM e encontre a instância do Windows à qual você quer se conectar.

Acessar a página "Instâncias de VMs"

3. Clique no botão RDP referente à instância a que você quer se conectar. A extensão Chrome RDP será aberta.
4. Como sua instância de VM não tem um domínio configurado, deixe o campo Domínio em branco
5. Digite o nome de usuário e a senha e clique em OK para se conectar.

6. Se solicitado, pressione Continuar para aceitar o certificado.

Outro

Consulte Conectar-se a VMs do Windows usando o RDP para ver mais opções de acesso a uma instância de VM do Windows do Compute Engine.

Configurar o ambiente de desenvolvimento para a linguagem de programação

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

Configurar o ambiente de desenvolvimento de instância de VM do Linux

Go

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o aplicativo de amostra Go.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Go.
2. Siga as instruções na seção Instalar Go.

Java

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o app Java de amostra.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Java.
2. Siga as instruções da seção Instalar um JDK (Java Development Kit).
3. Conclua as instruções em Instalar uma ferramenta de automação de build para configurar o Apache Maven.

Node.js

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o aplicativo de amostra Node.js.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Node.js.
2. Siga as instruções na seção Como instalar o Node.js e o npm.

Python

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o aplicativo de amostra em Python.

1. Acesse o guia de configuração de um ambiente para desenvolvedores do Python.
2. Siga as instruções na seção Como instalar o Python.

Configurar o ambiente de desenvolvimento de instância de VM do Windows

Go

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o aplicativo de amostra Go.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Go.
2. Siga as instruções na seção Instalar Go.

Java

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o app Java de amostra.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Java.
2. Siga as instruções da seção Instalar um JDK (Java Development Kit).
3. Siga as instruções em Instalar uma ferramenta de automação de build para configurar o Apache Maven.

Node.js

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o aplicativo de amostra Node.js.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Node.js.
2. Siga as instruções na seção Como instalar o Node.js e o npm.

Python

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento da instância de VM do Compute Engine para executar o aplicativo de amostra em Python.

1. Instale o Python e o gerenciador de pacotes PIP para Python.
1. Acesse o guia de configuração de um ambiente para desenvolvedores do Python.
2. Siga as instruções na seção Como instalar o Python.
1. Seguindo as instruções acima, você acessará a página de download Versões do Python para Windows. Nessa página, clique no link Versão mais recente do Python 3.
2. Na página Python 3.XX, clique no link Windows Installer 64-bit para fazer o download do arquivo do instalador na instância de VM do Windows Compute Engine.
3. Depois de fazer o download do instalador do Python na instância de VM, abra a pasta que contém o arquivo transferido por download. Clique com o botão direito do mouse no arquivo do instalador e selecione Executar como administrator.
4. Na caixa de diálogo Instalar Python que é exibida, selecione a opção para Adicionar Python 3.XX ao PATH e clique em → Instalar agora.
2. Use o PIP para instalar virtualenv.
1. Abra o Powershell na instância de VM do Windows Compute Engine e execute o comando pip install a seguir.

pip install virtualenv

Instalar o Git

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

Instância da VM Linux do Compute Engine

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

• Execute o comando install git sugerido do Debian/Ubuntu usando o prefixo de comando sudo para executar o comando como administrador. O comando de instalação completo que deve ser executado no terminal precisa ser formatado da seguinte maneira:

sudo apt-get install git

Instância da VM do Windows do Compute Engine

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

Clonar app de exemplo

Clone um aplicativo de amostra para sua instância de VM do Compute Engine usando o comando git clone.

Go

Na instância de VM do Compute Engine, abra um novo terminal ou janela do PowerShell. Execute os comandos a seguir para clonar o app de exemplo Go e mudar o diretório para o diretório que contém o aplicativo de exemplo.

1. Clone o app de exemplo:

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

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

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

Java

Na instância de VM do Compute Engine, abra um novo terminal ou janela do PowerShell. Execute os comandos a seguir para clonar o app de exemplo Java e mudar o diretório para o diretório que contém o app de exemplo.

1. Clone o app de exemplo:

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

2. Altere o diretório para o diretório que contém o 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 janela do PowerShell. Execute os comandos a seguir para clonar o app de exemplo Node.js e mudar o diretório para o diretório que contém o aplicativo de exemplo.

1. Clone o app de exemplo:

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

2. Altere o diretório para o diretório que contém o 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 janela do PowerShell. Execute os comandos a seguir para clonar o app de exemplo Python e mudar o diretório para o diretório que contém o app de exemplo.

1. Clone o app de exemplo:

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

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

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

Configurar e executar um app de amostra do Cloud SQL

Agora você pode configurar um aplicativo de amostra em execução na instância de VM do Compute Engine para se conectar à instância do Cloud SQL com uma instância, um banco de dados e uma conta de serviço do Cloud SQL.

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

Go

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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_CONNECTION_NAME com o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comandos a seguir para receber as dependências do aplicativo de amostra do Go em sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Consiga as dependências necessárias para executar o app de exemplo.

   go get ./...
   

2. Execute o app de exemplo.

   go run cmd/app/main.go
   

No seu computador local, localize o endereço IP externo da instância de VM do Compute Engine em que o aplicativo de exemplo está em execução e visualize-o em um navegador.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell no seu computador local, execute o seguinte comando gcloud compute instances describe para receber o endereço IP externo da instância da VM do Compute Engine:

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

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

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_CONNECTION_NAME com o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comando a seguir para receber as dependências do aplicativo de amostra do Java na instância de VM do Compute Engine e executar o aplicativo de amostra.

mvn jetty:run

No seu computador local, localize o endereço IP externo da instância de VM do Compute Engine em que o aplicativo de exemplo está em execução e visualize-o em um navegador.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell no seu computador local, execute o seguinte comando gcloud compute instances describe para receber o endereço IP externo da instância da VM do Compute Engine:

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

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

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

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 o aplicativo de amostra. Antes de executar os comandos, faça a substituição a seguir:

   • YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

   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. Faça o download do proxy do Cloud SQL Auth.

   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 permissões para tornar o arquivo do Cloud SQL Auth Proxy executável.

   chmod +x cloud-sql-proxy

4. Execute o proxy do Cloud SQL Auth como um processo em segundo plano. Substitua INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.

   ./cloud-sql-proxy INSTANCE_CONNECTION_NAME &

Observação: o processo que executa o proxy do Cloud SQL Auth em segundo plano pode ser interrompido usando o comando fg na janela do terminal em que você iniciou o app de exemplo. Isso coloca o job do proxy do Cloud SQL Auth em execução em primeiro plano no terminal. Em seguida, pressione as teclas Ctrl + C para interromper o job do proxy.

Na instância de VM do Compute Engine no terminal aberto, execute os comandos a seguir para receber os pacotes Node.js necessários para sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Instale os pacotes Node.js necessários para executar o aplicativo localmente.

   npm install
   

2. Execute o app de exemplo.

   npm start
   

No seu computador local, localize o endereço IP externo da instância de VM do Compute Engine em que o aplicativo de exemplo está em execução e visualize-o em um navegador.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell no seu computador local, execute o seguinte comando gcloud compute instances describe para receber o endereço IP externo da instância da VM do Compute Engine:

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

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

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_CONNECTION_NAME com o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comandos a seguir para receber os requisitos do aplicativo de amostra em Python na instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Inicializar um ambiente virtual e instalar os requisitos para executar o app de amostra.

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

2. Execute o app de exemplo.

   python app.py
   

No computador local, configure o encaminhamento de portas por SSH seguindo as instruções da próxima etapa do guia de início rápido. Isso permite que você use um navegador no computador local para ver o aplicativo em execução na instância de VM do Compute Engine.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell do seu computador local, execute o seguinte comando gcloud compute ssh para configurar o encaminhamento de portas por SSH. Antes de executar o comando, substitua YOUR_PROJECT_ID pelo ID do 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. Confira o app de exemplo em execução. Com o encaminhamento de portas em execução, abra um navegador no computador local e digite http://127.0.0.1:8000 na barra de endereço do navegador.

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

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

Go

Na instância de VM do Compute Engine na janela aberta do PowerShell, execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• INSTANCE_CONNECTION_NAME com o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$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 aberta do PowerShell, execute os comandos a seguir para receber as dependências do aplicativo de amostra do Go em sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Consiga as dependências necessárias para executar o app de exemplo.

   go get ./...
   

2. Execute o app de exemplo.

   go run cmd\app\main.go
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Java

Na instância de VM do Compute Engine na janela aberta do PowerShell, execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• INSTANCE_CONNECTION_NAME com o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$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 aberta do PowerShell, execute o comando a seguir para colocar as dependências do aplicativo de amostra do Java na instância de VM do Compute Engine e executar o aplicativo de amostra.

   mvn jetty:run
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Node.js

1. Na instância de VM do Compute Engine na janela aberta do PowerShell, execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, faça a substituição a seguir:

   • YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

   $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. Faça o download do proxy do Cloud SQL Auth.

   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 do Cloud SQL Auth como um processo em segundo plano. Substitua INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "INSTANCE_CONNECTION_NAME"

Observação: o processo que executa o proxy do Cloud SQL Auth em segundo plano pode ser interrompido selecionando a janela cmd.exe que foi gerada pelo comando Start-Process. Feche a janela para interromper o job do proxy.

Na instância de VM do Compute Engine na janela aberta do PowerShell, execute os comandos a seguir para receber os pacotes Node.js necessários para sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Instale os pacotes Node.js necessários para executar o aplicativo localmente.

   npm install
   

2. Execute o app de exemplo.

   npm start
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Python

Na instância de VM do Compute Engine na janela aberta do PowerShell, execute os seguintes comandos para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, faça as seguintes substituições:

• INSTANCE_CONNECTION_NAME com o Nome da conexão da instância que aparece na página Instâncias do Cloud SQL no Console do Google Cloud.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$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 aberta do PowerShell, execute os comandos a seguir para receber os requisitos do aplicativo de amostra em Python na instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Inicializar um ambiente virtual e instalar os requisitos para executar o app de amostra.

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

2. Execute o app de exemplo.

   python app.py
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

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

Criar e fazer o download de certificados do servidor e do cliente SSL para seu computador local

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

   Acesse Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a página Visão geral correspondente.
3. Clique na guia Conexões.
4. Na seção Segurança, clique em Criar certificado do cliente.
5. Na caixa de diálogo Criar um certificado do cliente, insira quickstart-key como o nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de download para fazer o download dos certificados. Clique em Fechar.

   Importante: armazene essa chave privada com segurança. Em caso de perda, será necessário criar um novo certificado de cliente.

Fazer o upload de certificados SSL para o bucket do Cloud Storage

Console

Em um navegador no computador local, crie um bucket do Cloud Storage e faça upload dos certificados SSL para o bucket em que eles podem ser acessados a partir da instância de VM do Compute Engine.

1. Crie um bucket do Cloud Storage.
1. Em Nome do bucket, insira o nome a seguir. Substitua YOUR_PROJECT_ID pelo código do projeto:

   YOUR_PROJECT_ID-quickstart-certs

2. Clique no botão Criar para criar o bucket.
2. Clique no botão Fazer upload de arquivos para fazer upload de arquivos para o bucket do Cloud Storage recém-criado.
3. Selecione os seguintes arquivos para upload do seu computador local para o Cloud Storage:
• server-ca.pem
• client-cert.pem
• client-key.pem

gcloud

No computador local em um terminal ou janela do PowerShell, aberto para o diretório onde você fez o download dos certificados SSL, é possível criar um bucket do Cloud Storage e fazer upload dos certificados SSL para o bucket em que eles poderão ser acessados na Instância de VM do Compute Engine. O utilitário de linha de comando do Cloud Storage gsutil, incluído na Cloud CLI, será usado para fazer upload dos arquivos.

1. Execute este comando do gsutil mb para criar um novo bucket do Cloud Storage:

gsutil mb -l us-central1 gs://YOUR_PROJECT_ID-quickstart-certs

2. No diretório em que você fez o download dos certificados no computador local, execute os seguintes comandos gsutil cp para copiar os certificados SSL para o bucket do Cloud Storage recém-criado:

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

Go

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em um terminal aberto para ogolang-samples/cloudsql/postgres/database-sql, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório certs

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

Defina as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comandos a seguir para receber as dependências do aplicativo de amostra do Go em sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Consiga as dependências necessárias para executar o app de exemplo.

   go get ./...
   

2. Execute o app de exemplo.

   go run cmd/app/main.go
   

No seu computador local, localize o endereço IP externo da instância de VM do Compute Engine em que o aplicativo de exemplo está em execução e visualize-o em um navegador.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell no seu computador local, execute o seguinte comando gcloud compute instances describe para receber o endereço IP externo da instância da VM do Compute Engine:

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

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

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

Java

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em um terminal aberto no diretório java-docs-samples/cloud-sql/postgres/servlet, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para a atual diretório

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

Configure os certificados SSL para uso em Java na instância de VM do Compute Engine

1. No terminal da instância de VM do Compute Engine, execute o comando a seguir para converter o certificado e a chave PEM salvos em um arquivo PKCS12 usando openssl. Antes de executar o comando a seguir, substitua SSL_CLIENT_KEY_PASSWD pela sua própria senha personalizada de keystore a ser usada para criar o keystore 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 as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• SSL_CLIENT_KEY_PASSWD pela senha que você especificou para criar o keystore do cliente Java com openssl na etapa anterior do guia de início rápido.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comando a seguir para receber as dependências do aplicativo de amostra do Java na instância de VM do Compute Engine e executar o aplicativo de amostra.

mvn jetty:run

No seu computador local, localize o endereço IP externo da instância de VM do Compute Engine em que o aplicativo de exemplo está em execução e visualize-o em um navegador.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell no seu computador local, execute o seguinte comando gcloud compute instances describe para receber o endereço IP externo da instância da VM do Compute Engine:

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

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

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

Node.js

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em um terminal aberto para o diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório certs.

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

Defina as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comandos a seguir para receber os pacotes Node.js necessários para sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Instale os pacotes Node.js necessários para executar o aplicativo localmente.

   npm install
   

2. Execute o app de exemplo.

   npm start
   

No seu computador local, localize o endereço IP externo da instância de VM do Compute Engine em que o aplicativo de exemplo está em execução e visualize-o em um navegador.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell no seu computador local, execute o seguinte comando gcloud compute instances describe para receber o endereço IP externo da instância da VM do Compute Engine:

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

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

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

Python

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em um terminal aberto para o diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório certs.

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

Defina as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

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 comandos a seguir para receber os requisitos do aplicativo de amostra em Python na instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Inicializar um ambiente virtual e instalar os requisitos para executar o app de amostra.

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

2. Execute o app de exemplo.

   python app.py
   

No computador local, configure o encaminhamento de portas por SSH seguindo as instruções da próxima etapa do guia de início rápido. Isso permite que você use um navegador no computador local para ver o aplicativo em execução na instância de VM do Compute Engine.

Observação: esta etapa do guia de início rápido requer a CLI da gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud usando comandos gcloud CLI. Se você não tiver a CLI da gcloud instalada no seu computador local, instale a CLI da gcloud para continuar.

1. Em um terminal ou no PowerShell do seu computador local, execute o seguinte comando gcloud compute ssh para configurar o encaminhamento de portas por SSH. Antes de executar o comando, substitua YOUR_PROJECT_ID pelo ID do 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. Confira o app de exemplo em execução. Com o encaminhamento de portas em execução, abra um navegador no computador local e digite http://127.0.0.1:8000 na barra de endereço do navegador.

   

Para interromper o aplicativo de amostra, pressione Control+C no terminal da instância de VM do Compute Engine em que você iniciou o aplicativo de amostra.

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

Criar e fazer o download de certificados do servidor e do cliente SSL para seu computador local

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

   Acesse Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a página Visão geral correspondente.
3. Clique na guia Conexões.
4. Na seção Segurança, clique em Criar certificado do cliente.
5. Na caixa de diálogo Criar um certificado do cliente, insira quickstart-key como o nome e clique em Criar.

6. Na caixa de diálogo Novo certificado SSL criado, clique em cada link de download para fazer o download dos certificados. Clique em Fechar.

   Importante: armazene essa chave privada com segurança. Em caso de perda, será necessário criar um novo certificado de cliente.

Fazer o upload de certificados SSL para o bucket do Cloud Storage

Console

Em um navegador no computador local, crie um bucket do Cloud Storage e faça upload dos certificados SSL para o bucket em que eles podem ser acessados a partir da instância de VM do Compute Engine.

1. Crie um bucket do Cloud Storage.
1. Em Nome do bucket, insira o nome a seguir. Substitua YOUR_PROJECT_ID pelo código do projeto:

   YOUR_PROJECT_ID-quickstart-certs

2. Clique no botão Criar para criar o bucket.
2. Clique no botão Fazer upload de arquivos para fazer upload de arquivos para o bucket do Cloud Storage recém-criado.
3. Selecione os seguintes arquivos para upload do seu computador local para o Cloud Storage:
• server-ca.pem
• client-cert.pem
• client-key.pem

gcloud

No computador local em um terminal ou janela do PowerShell, aberto para o diretório onde você fez o download dos certificados SSL, é possível criar um bucket do Cloud Storage e fazer upload dos certificados SSL para o bucket em que eles poderão ser acessados na Instância de VM do Compute Engine. O utilitário de linha de comando do Cloud Storage gsutil, incluído na Cloud CLI, será usado para fazer upload dos arquivos.

1. Execute este comando do gsutil mb para criar um novo bucket do Cloud Storage:

gsutil mb -l us-central1 gs://YOUR_PROJECT_ID-quickstart-certs

2. No diretório em que você fez o download dos certificados no computador local, execute os seguintes comandos gsutil cp para copiar os certificados SSL para o bucket do Cloud Storage recém-criado:

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

Go

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em uma janela do PowerShell aberta para o diretório golang-samples/cloudsql/postgres/database-sql, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório certs.

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

Defina as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$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 aberta do PowerShell, execute os comandos a seguir para receber as dependências do aplicativo de amostra do Go em sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Consiga as dependências necessárias para executar o app de exemplo.

   go get ./...
   

2. Execute o app de exemplo.

   go run cmd\app\main.go
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Java

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em uma janela do PowerShell aberta para o diretório java-docs-samples/cloud-sql/postgres/servlet, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório atual.

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

Configure os certificados SSL para uso em Java na instância de VM do Compute Engine

1. No terminal da instância de VM do Compute Engine, execute o comando a seguir para converter o certificado e a chave PEM salvos em um arquivo PKCS12 usando openssl. Antes de executar o comando a seguir, substitua SSL_CLIENT_KEY_PASSWD pela sua própria senha personalizada de keystore a ser usada para criar o keystore 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 as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.
• SSL_CLIENT_KEY_PASSWD pela senha que você 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 aberta do PowerShell, execute o comando a seguir para colocar as dependências do aplicativo de amostra do Java na instância de VM do Compute Engine e executar o aplicativo de amostra.

   mvn jetty:run
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Node.js

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em uma janela do PowerShell aberta para o diretório nodejs-docs-samples/cloud-sql/postgres/knex, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório certs.

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

Defina as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$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 aberta do PowerShell, execute os comandos a seguir para receber os pacotes Node.js necessários para sua instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Instale os pacotes Node.js necessários para executar o aplicativo localmente.

   npm install
   

2. Execute o app de exemplo.

   npm start
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Python

Fazer o download dos certificados SSL usando a gsutil na instância de VM do Compute Engine

Na instância de VM do Compute Engine em uma janela do PowerShell aberta para o diretório python-docs-samples/cloud-sql/postgres/sqlalchemy, execute os seguintes comandos gsutil cp para fazer o download dos certificados SSL do Cloud Storage para o diretório certs.

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

Defina as variáveis de ambiente na instância da 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 o aplicativo de amostra. Antes de executar os comandos, faça as substituições a seguir:

• INSTANCE_HOST definido como o endereço IP particular da sua instância exibido na página Instâncias do Cloud SQL no Console do Google Cloud.
Observação: As conexões com uma instância do Cloud SQL usando um endereço IP privado são autorizadas automaticamente para ntervalos de endereços RFC 1918. Para intervalos de endereços não RFC 1918, consulte Saiba mais sobre o uso de IP particular.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$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 aberta do PowerShell, execute os comandos a seguir para receber os requisitos do aplicativo de amostra em Python na instância de VM do Compute Engine e executar o aplicativo de amostra.

1. Inicializar um ambiente virtual e instalar os requisitos para executar o app de amostra.

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

2. Execute o app de exemplo.

   python app.py
   

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

   

Para interromper o aplicativo de exemplo, pressione Control+C na janela do PowerShell da instância de VM do Compute Engine, onde você iniciou o app de amostra.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

Excluir instância do Cloud SQL

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

   Acesse Instâncias do Cloud SQL

2. Selecione a instância quickstart-instance para abrir a página Detalhes da instância.
3. Na barra de ícones na parte superior da página, clique em Excluir.
4. Na caixa de diálogo Excluir instância, digite quickstart-instance e clique em Excluir para excluir a instância.

Excluir instância de VM do Compute Engine

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

   Acessar 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 Excluir.
4. Clique em Excluir para remover a instância.

Etapas de limpeza opcionais

Se você não estiver usando o papel Cliente do Cloud SQL que foi atribuído à conta de serviço Compute Engine default, remova-o.

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

   Acessar IAM

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

Se você não estiver usando a API que foi ativada como parte deste guia de início rápido, poderá desativá-la.

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

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

   Acesse APIs

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

A seguir

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

Também é possível aprender a criar usuários do PostgreSQL e bancos de dados para sua instância do Cloud SQL.

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

Saiba mais sobre estas situações:

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

Além disso, é possível aprender a se conectar a uma instância do Cloud SQL usando outros aplicativos do Google Cloud, como:

• Um aplicativo em execução no ambiente padrão do App Engine
• A partir de um aplicativo em execução no Compute Engine
• a partir de um aplicativo em execução no GKE;
• no Cloud Functions.
• no Cloud Run