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

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

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implementar uma app de exemplo no ambiente padrão do App Engine ligado a uma instância do SQL Server através da Google Cloud consola e de uma aplicação cliente.

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

Antes de começar

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

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

   Roles required to select or create a project

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

2. Verify that billing is enabled for your Google Cloud project.

3. Ative as APIs Cloud necessárias para executar uma app de exemplo do Cloud SQL no ambiente padrão do App Engine.

   Consola

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

   Ative as APIs

   Isto ativa as seguintes APIs:

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

   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 sqladmin.googleapis.com compute.googleapis.com \
   cloudbuild.googleapis.com logging.googleapis.com

   Este comando ativa as seguintes APIs:

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

Configure o Cloud SQL

Crie uma instância do Cloud SQL

IP público

O ambiente padrão do App Engine não suporta a ligação ao Cloud SQL para SQL Server através de IP público com sockets Unix, mas as ligações são possíveis através dos conetores Go, Java e Python.

Consola

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 por zona, 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. Clique em Criar instância e, de seguida, aguarde até a instância ser inicializada e iniciada.

gcloud

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

Opcionalmente, modifique os valores dos seguintes parâmetros:

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

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

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

IP privado

Consola

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

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

   Aceda a redes de VPC

2. Selecione a rede de VPC default.
3. Selecione o separador Ligação de serviço privada.
4. Selecione o separador Intervalos de IPs 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 por zona, 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ó Ligaçõ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 disponíveis atuais.
• --cpu: o número de núcleos na máquina.
• --memory: um valor numérico inteiro que indica a quantidade de memória a incluir na máquina. Pode indicar uma unidade de tamanho (por exemplo, 3072 MB ou 9 GB). Se não forem especificadas unidades, é assumido que são GB.
• --region: a localização regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, é usado o valor predefinido us-central1. Veja a lista completa de regiões.

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

gcloud sql instances create quickstart-instance \
--database-version=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 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 padrão do App Engine

Crie a aplicação do App Engine

Crie a aplicação do App Engine no seu Google Cloud projeto. Isto ativa o serviço do App Engine, cria uma aplicação do App Engine predefinida e cria uma conta de serviço do App Engine que vai ser usada para estabelecer ligação ao Cloud SQL.

Nota: só tem de realizar este passo uma vez por Google Cloud projeto.

Consola

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

   Aceder ao App Engine

2. Clique no botão Criar aplicação.
3. Selecione us-central no menu pendente Selecionar uma região.
4. Clicar em Seguinte.
5. Clique no link Faço isto mais tarde assim que aparecer na página Começar.

gcloud

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

gcloud app create

2. Quando lhe for pedido que escolha a região onde quer que a sua aplicação 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 com autorizações para se ligar ao Cloud SQL.

Consola

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

   Aceder 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 é project-name@.
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 do Cloud SQL

Com uma instância, uma base de dados e uma conta de serviço do Cloud SQL com autorizações de cliente, já pode configurar e implementar uma aplicação de exemplo para estabelecer ligação à sua instância do Cloud SQL.

IP público

O ambiente padrão do App Engine suporta a ligação ao Cloud SQL para SQL Server através de IP público com os conetores Go, Java e Python.

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, navegue para o ficheiro golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no ficheiro app.standard.yaml pelos seguintes valores:
• <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_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.
7. Na linha de comandos do Cloud Shell, no diretório golang-samples/cloudsql/sqlserver/database-sql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy cmd/app/app.standard.yaml

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, 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 padrão 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, navegue para o ficheiro java-docs-samples/cloud-sql/sqlserver/servlet/src/main/webapp/WEB-INF/appengine-web.xml e abra-o.
6. 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 Crie um utilizador.
• my_db com quickstart-db.
7. Na linha de comandos do Cloud Shell, no diretório java-docs-samples/cloud-sql/sqlserver/servlet, execute o seguinte comando Apache Maven mvn clean package para implementar a app de exemplo no ambiente padrão do App Engine.

mvn clean package appengine:deploy -DskipTests

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, 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 padrão 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, navegue para o ficheiro python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no ficheiro app.standard.yaml pelos seguintes valores:
• <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_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.
7. Na linha de comandos do Cloud Shell, no diretório python-docs-samples/cloud-sql/sql-server/sqlalchemy, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, 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 padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

IP privado

Para caminhos de IP privado, a sua aplicação liga-se diretamente à instância através do acesso a VPC sem servidor. Este método usa um socket TCP para se ligar 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 Associações.
4. Na secção Segurança, clique em Transferir certificados para transferir o certificado do servidor SSL.

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede.
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede.
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IPs.
6. Clique em Criar.

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, navegue para o ficheiro golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml e abra-o.
7. Copie e cole o seguinte código no ficheiro, substituindo o conteúdo do ficheiro existente:

runtime: go116

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

8. 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.
9. Na linha de comandos do Cloud Shell, no diretório golang-samples/cloudsql/sqlserver/database-sql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy cmd/app/app.standard.yaml

10. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Quando o comando de implementação estiver concluído, 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 padrão do App Engine. Este ambiente está ligado ao Cloud SQL.

Node.js

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IP
6. Clique em Criar para criar o conetor.

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, navegue para o ficheiro nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.standard.yaml e abra-o.
6. Substitua os marcadores de posição das variáveis de ambiente no ficheiro app.standard.yaml pelos seguintes valores:
• CLOUD_SQL_INSTANCE_IP_ADDRESS com o endereço IP privado 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 quickstart-user que criou em Crie um utilizador.
• MY_DATABASE com quickstart-db.
• <MY-PROJECT> com o ID do seu projeto.
• <CONNECTOR_NAME> com quickstart-connector.
7. Na linha de comandos do Cloud Shell, no diretório nodejs-docs-samples/cloud-sql/sqlserver/mssql, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

8. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
9. Quando lhe for perguntado Quer continuar?, introduza Y.
10. Quando o comando de implementação estiver concluído, 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 padrão 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 Associações.
4. Na secção Segurança, clique em Transferir certificados para transferir o certificado do servidor SSL.

Crie uma ligação VPC sem servidor para ligações à instância através de IP privado

1. Na Google Cloud consola, aceda à página Acesso a VPC sem servidor - Criar conetor.

   Crie um conetor de VPC sem servidor

2. Introduza quickstart-connector para o Nome.
3. Selecione predefinição no menu pendente Rede.
4. Selecione Intervalo de IPs personalizado no menu pendente Sub-rede.
5. Introduza 10.8.0.0 na caixa de introdução de texto Intervalo de IPs.
6. Clique em Criar.

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, navegue para o ficheiro python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml e abra-o.
7. Copie e cole o seguinte código no ficheiro, substituindo o conteúdo do ficheiro existente:

runtime: python37
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

8. 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.
9. Na linha de comandos do Cloud Shell, no diretório python-docs-samples/cloud-sql/sql-server/sqlalchemy, execute o seguinte comando gcloud app deploy para implementar a app de exemplo no ambiente padrão do App Engine.

gcloud app deploy app.standard.yaml

10. Se lhe for pedido que escolha a região para criar a app, introduza a opção numérica para us-central.
11. Quando lhe for perguntado Quer continuar?, introduza Y.
12. Quando o comando de implementação estiver concluído, 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 padrão 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, de 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 Contas de serviço.

   Aceder 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
  • Cloud SQL Admin API
  • 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 outras aplicações do Google Cloud:

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