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

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

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implementar uma app de exemplo no ambiente flexível do App Engine ligado a uma instância do SQL Server através da Google Cloud consola e de uma app cliente.

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

Antes de começar

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

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

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

Roles required to select or create a project

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

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

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

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Ative as APIs Cloud necessárias para executar uma app de exemplo do Cloud SQL no ambiente flexível do App Engine.

   Consola

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

   Ative as APIs

   Isto ativa as seguintes APIs:

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

   Ao clicar no botão, também ativa o Google App Engine Flexible Environment.

   gcloud

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

   Abra o Cloud Shell

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

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

   Este comando ativa as seguintes APIs:

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

   Ao executar o comando acima, também ativa o ambiente flexível do Google App Engine.

Configure o Cloud SQL

Crie uma instância do Cloud SQL

IP público

IP privado

Consola

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

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

   Aceda a redes de VPC

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

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

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

   Aceda a Instâncias do Cloud SQL

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

gcloud

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

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

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

2. Execute o comando gcloud services vpc-peerings connect para criar uma ligação privada ao intervalo de endereços IP atribuído. Substitua YOUR_PROJECT_ID pelo ID do projeto.

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

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

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

Opcionalmente, modifique os valores dos seguintes parâmetros:

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

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

gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. Execute o comando gcloud sql instances patch para ativar a opção Permitir apenas ligações SSL para a instância.

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

Crie uma base de dados

Consola

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

   Aceda a Instâncias do Cloud SQL

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

gcloud

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

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

Implemente uma app de exemplo no ambiente flexível do App Engine

Crie uma app do App Engine

Crie uma app do App Engine no seu Google Cloud projeto. Isto ativa o serviço do App Engine, cria uma app do App Engine predefinida e cria uma conta de serviço do App Engine que usa para se ligar ao Cloud SQL.

Nota: só cria uma app do App Engine uma vez por Google Cloud projeto.

Consola

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

   Aceder ao App Engine

2. Clique em Criar candidatura.
3. No menu pendente Selecionar uma região, selecione us-central.
4. Clicar em Seguinte.
5. Depois de aparecer a página Começar, desloque a página até à parte inferior.
6. Clique no link Farei isso mais tarde.

gcloud

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

gcloud app create

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

Configure a conta de serviço do App Engine

Configure a conta de serviço usada pelo App Engine para que tenha a função Cliente do Cloud SQL. Ao atribuir a função à conta de serviço, a conta tem autorizações para se ligar ao Cloud SQL.

Consola

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

   Aceda ao IAM

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

gcloud

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

   gcloud iam service-accounts list

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

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

Configure e implemente uma app de exemplo para o Cloud SQL

Agora que criou uma instância e uma base de dados do Cloud SQL e configurou a conta de serviço do App Engine para que tenha autorizações para se ligar ao Cloud SQL, pode configurar e implementar uma app de exemplo para se ligar à sua instância do Cloud SQL.

IP público

Ir

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

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
6. Navegue para o ficheiro cloudshell_open/golang-samples/cloudsql/sqlserver/database-sql/app.flexible.yaml e abra-o.
7. Substitua os marcadores de posição das variáveis de ambiente no ficheiro app.flexible.yaml pelos seguintes valores:
• <PROJECT-ID> com o ID do seu projeto.
• <INSTANCE-REGION> com us-central1.
• <INSTANCE-NAME> com quickstart-instance.
• <YOUR_DB_USER_NAME> com sqlserver.
• <YOUR_DB_PASSWORD> com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• <YOUR_DB_NAME> com quickstart-db.
8. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/golang-samples/cloudsql/sqlserver/database-sql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente flexível do App Engine.

gcloud app deploy app.flexible.yaml

9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

Java

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

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
6. Navegue para o ficheiro cloudshell_open/java-docs-samples/cloud-sql/sqlserver/servlet/src/main/webapp/WEB-INF/appengine-web.xml e abra-o.
7. Substitua os marcadores de posição das variáveis de ambiente no ficheiro appengine-web.xml pelos seguintes valores:
• project-name:region-name:instance-name com o nome de ligação da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• my-db-user com quickstart-user.
• my-db-password com a palavra-passe do sqlserver que criou em Criar um utilizador.
• my_db com quickstart-db.
8. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/java-docs-samples/cloud-sql/sqlserver/servlet, execute o seguinte comando Apache Maven para implementar a app de exemplo no ambiente flexível do App Engine.mvn clean package

mvn clean package appengine:deploy -DskipTests

9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

Node.js

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

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
6. Navegue para o ficheiro cloudshell_open/nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.flexible.yaml e abra-o.
7. Substitua os marcadores de posição das variáveis de ambiente no ficheiro app.flexible.yaml pelos seguintes valores:
• <MY-PROJECT> com o ID do seu projeto.
• <INSTANCE-REGION> com us-central1.
• <INSTANCE-NAME> com quickstart-instance.
• MY_DB_USER com quickstart-user.
• MY_DB_PASSWORD com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• MY_DATABASE com quickstart-db.
8. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/nodejs-docs-samples/cloud-sql/sqlserver/mssql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente flexível do App Engine.

gcloud app deploy app.flexible.yaml

9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

Python

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

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
6. Navegue para o ficheiro cloudshell_open/python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.flexible.yaml e abra-o.
7. Substitua os marcadores de posição das variáveis de ambiente no ficheiro app.flexible.yaml pelos seguintes valores:
• <PROJECT-ID> com o ID do seu projeto.
• <INSTANCE-REGION> com us-central1.
• <INSTANCE-NAME> com quickstart-instance.
• <YOUR_DB_USER_NAME> com sqlserver.
• <YOUR_DB_PASSWORD> com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• <YOUR_DB_NAME> com quickstart-db.
8. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/python-docs-samples/cloud-sql/sql-server/sqlalchemy, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente flexível do App Engine.

gcloud app deploy app.flexible.yaml

9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

IP privado

Para caminhos de IP privados, certifique-se de que a VM do ambiente flexível do App Engine e a instância do Cloud SQL estão alojadas na mesma rede da nuvem virtual privada (VPC). Quando localizada na mesma rede VPC, a sua app do ambiente flexível do App Engine pode ligar-se diretamente à instância do Cloud SQL sem usar o proxy Auth do Cloud SQL.

Ir

Crie e transfira o certificado de servidor SSL

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

   Aceda a Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a respetiva página Vista geral.
3. Clique no separador Ligações.
4. Na secção Segurança, clique em Transferir certificados para transferir o certificado do servidor SSL.

Crie uma app de exemplo com um certificado de servidor SSL

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

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. Carregue o ficheiro do certificado do servidor SSL para a pasta certs.
   1. No menu de navegação do Explorador do Cloud Shell Editor, navegue para a pasta golang-samples/cloudsql/sqlserver/database-sql/certs.
   2. Clique com o botão direito do rato na pasta certs no editor do Cloud Shell e selecione Carregar ficheiros.
   3. Selecione o seguinte ficheiro no seu computador local: server-ca.pem.
   4. Com o ficheiro do certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de carregamento do ficheiro para o Cloud Shell Editor.
6. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
7. Navegue para o ficheiro cloudshell_open/golang-samples/cloudsql/sqlserver/database-sql/app.flexible.yaml e abra-o.
8. Copie e cole o seguinte código no ficheiro, substituindo o conteúdo do ficheiro existente:

runtime: custom
env: flex

env_variables:
  INSTANCE_CONNECTION_NAME: PROJECT-ID:INSTANCE-REGION:INSTANCE-NAME
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 1433
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Faça as seguintes substituições de variáveis:
• PROJECT_ID com o ID do seu projeto.
• INSTANCE-REGION com us-central1.
• INSTANCE-NAME com o ID da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• INSTANCE_HOST com o endereço IP privado da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
10. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/golang-samples/cloudsql/sqlserver/database-sql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente flexível do App Engine.

gcloud app deploy app.flexible.yaml

11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

Node.js

Crie uma app de exemplo

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
6. Navegue para o ficheiro cloudshell_open/nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.flexible.yaml e abra-o.
7. Copie o seguinte código e cole-o no ficheiro, substituindo o conteúdo do ficheiro existente:

runtime: nodejs
env: flex

env_variables:
  DB_USER: quickstart-user
  DB_PASS: MY_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 1433
  INSTANCE_HOST: INSTANCE_HOST
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Faça as seguintes substituições de variáveis:
• MY_DB_PASSWORD com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• INSTANCE_HOST com o endereço IP privado da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• PROJECT_ID com o ID do seu projeto.
9. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/nodejs-docs-samples/cloud-sql/sqlserver/mssql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente flexível do App Engine.

gcloud app deploy app.flexible.yaml

10. Quando lhe for perguntado Quer continuar?, introduza Y.
11. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

Python

Crie e transfira o certificado de servidor SSL

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

   Aceda a Instâncias do Cloud SQL

2. Clique em quickstart-instance para ver a respetiva página Vista geral.
3. Clique no separador Ligações.
4. Na secção Segurança, clique em Transferir certificados para transferir o certificado do servidor SSL.

Crie uma app de exemplo com um certificado de servidor SSL

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

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

   gcloud config set project YOUR-PROJECT-ID

   Nota: substitua YOUR-PROJECT-ID pelo ID do seu projeto.
4. Se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
5. Carregue o ficheiro do certificado do servidor SSL para a pasta certs.
   1. No menu de navegação do Explorador do Cloud Shell Editor, navegue para a pasta python-docs-samples/cloud-sql/sql-server/sqlalchemy/certs.
   2. Clique com o botão direito do rato na pasta certs no Editor do Cloud Shell e selecione Carregar ficheiros
   3. Selecione o seguinte ficheiro no seu computador local: server-ca.pem.
   4. Com o ficheiro do certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de carregamento do ficheiro para o Cloud Shell Editor.
6. No menu de navegação do Explorador do Cloud Shell Editor, clique no nó expansível que é o nome de utilizador da sua Google Cloud conta.
7. Navegue para o ficheiro cloudshell_open/python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.flexible.yaml e abra-o.
8. Copie o seguinte código e cole-o no ficheiro, substituindo o conteúdo do ficheiro existente:

runtime: custom
env: flex
entrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_NAME: quickstart-db
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  INSTANCE_HOST: INSTANCE_HOST
  DB_PORT: 1433
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

9. Faça as seguintes substituições de variáveis:
• YOUR_DB_PASSWORD com a palavra-passe do quickstart-user que criou em Crie um utilizador.
• INSTANCE_HOST com o endereço IP privado da sua instância que aparece na página Instâncias do Cloud SQL na Google Cloud consola.
• PROJECT_ID com o ID do seu projeto.
10. Na linha de comandos do Cloud Shell, no diretório cloudshell_open/python-docs-samples/cloud-sql/sql-server/sqlalchemy, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente flexível do App Engine.

gcloud app deploy app.flexible.yaml

11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Depois de as ações executadas com o comando gcloud app deploy ficarem concluídas, execute o comando gcloud app browse:

gcloud app browse

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

Limpar

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

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

   Aceda a Instâncias do Cloud SQL

2. Selecione a instância quickstart-instance para abrir a página Detalhes da instância.
3. Na barra de ícones na parte superior da página, clique em Eliminar.
4. Na caixa de diálogo Eliminar instância, escreva quickstart-instance e, de seguida, clique em Eliminar para eliminar a instância. A desativação da sua app impede a execução de instâncias e a publicação de pedidos. Se a sua app estiver a processar um pedido, conclui o pedido antes de ser desativada.

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

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

   Aceda às Definições

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

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

Passos de limpeza opcionais

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

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

   Aceda ao IAM

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

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

• APIs ativadas neste guia de início rápido:
  • API Compute Engine
  • API Cloud SQL Admin
  • API Cloud Run
  • API Container Registry
  • API Cloud Build

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

   Aceder às APIs

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

O que se segue?

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

Também pode saber como criar utilizadores do SQL Server 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 SQL Server.

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 outros produtos do Google Cloud:

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