Saiba como implantar um app de exemplo no ambiente padrão do App Engine
conectado a uma instância do SQL Server usando o console do Google Cloud e um aplicativo
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
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.
Clique no botão a seguir para abrir o Cloud Shell, que fornece
acesso de linha de comando aos recursos do Google Cloud diretamente no navegador.
O Cloud Shell pode ser usado para executar os comandos gcloud apresentados neste guia de início rápido.
O ambiente padrão do App Engine não é compatível com a conexão com o
Cloud SQL para SQL Server por meio de IPs públicos que usam soquetes Unix, mas
as conexões são possíveis usando os conectores Go, Java e Python.
Console
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
No campo ID da instância, insira
quickstart-instance.
No campo Senha, insira uma senha para
o usuário sqlserver. Salve essa senha para uso futuro.
Na seção Escolher disponibilidade de região e zona,
selecione Única zona.
Clique no menu Mostrar opções de configuração.
Na lista suspensa Tipo de máquina, selecione Leve.
Clique em Criar instância e aguarde até que
a instância seja inicializada.
gcloud
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
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.
gcloud compute addresses create google-managed-services-default \
--global --purpose=VPC_PEERING --prefix-length=16 \
--description="peering range for Google" --network=default
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.
Criar uma instância com SSL e endereço IP privado ativados
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.
Implantar um aplicativo de exemplo no ambiente padrão do App Engine
Criar o aplicativo do App Engine
Crie o aplicativo do App Engine no projeto do Google Cloud. Isso
ativa o serviço do App Engine, cria um aplicativo padrão do App Engine
e cria uma conta de serviço do App Engine que será usada para se conectar ao Cloud SQL.
Console
No console do Google Cloud, acesse a página do App Engine.
Configurar e implantar um aplicativo de exemplo do Cloud SQL
Agora é possível configurar e implantar um aplicativo de exemplo para se conectar à
instância do Cloud SQL usando uma instância, um banco de dados e uma conta de serviço do Cloud SQL
com permissões de cliente.
IP público
O ambiente padrão do App Engine aceita a conexão com o Cloud SQL para
SQL Server por IP público usando os
conectores Go, Java e Python.
Go
No editor do Cloud Shell, abra o código-fonte do app de amostra.
Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para
fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:
gcloud config set project YOUR-PROJECT-ID
Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml
e abra-o.
Substitua os marcadores de posição das variáveis de ambiente no arquivo
app.standard.yaml pelos seguintes valores:
<PROJECT-ID> pelo ID do projeto.
<INSTANCE-REGION> por us-central1.
<INSTANCE-NAME> pelo ID da instância que
aparece na página
Instâncias do Cloud SQL no console do Google Cloud.
<YOUR_DB_USER_NAME> por sqlserver.
<YOUR_DB_PASSWORD> pela senha de quickstart-user
que você criou em Criar um
usuário.
<YOUR_DB_NAME> por quickstart-db.
No prompt de comando do Cloud Shell, no
diretório golang-samples/cloudsql/sqlserver/database-sql, execute o seguinte
comando gcloud app deploy
para implantar o aplicativo de exemplo no ambiente padrão do App Engine.
gcloud app deploy cmd/app/app.standard.yaml
Se for necessário escolher a região para criar o aplicativo,
insira a escolha numérica de us-central.
Quando a mensagem Você quer continuar? aparecer, digite Y.
Quando o comando de implantação for concluído, execute o
comando
gcloud app browse:
gcloud app browse
Clique no link gerado para ver o aplicativo de exemplo em execução no
ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.
Java
No editor do Cloud Shell, abra o código-fonte do app de amostra.
Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para
fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:
gcloud config set project YOUR-PROJECT-ID
Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo java-docs-samples/cloud-sql/sqlserver/servlet/src/main/webapp/WEB-INF/appengine-web.xml
e abra-o.
Substitua os marcadores de posição das variáveis de ambiente no arquivo
appengine-web.xml pelos seguintes valores:
project-name:region-name:instance-name pelo Nome de conexão
da instância que aparece na página Instâncias do Cloud SQL
no console do Google Cloud.
my-db-user por quickstart-user.
my-db-password pela senha de
sqlserver que você criou em
Criar um usuário.
my_db por quickstart-db.
No prompt de comando do Cloud Shell, no diretório
java-docs-samples/cloud-sql/sqlserver/servlet, execute o seguinte
comando do Apache Mavenmvn clean package para implantar o aplicativo de exemplo
no ambiente padrão do App Engine.
mvn clean package appengine:deploy -DskipTests
Se for necessário escolher a região para criar o aplicativo,
insira a escolha numérica de us-central.
Quando a mensagem Você quer continuar? aparecer, digite Y.
Quando o comando de implantação for concluído, execute o
comando
gcloud app browse:
gcloud app browse
Clique no link gerado para ver o aplicativo de exemplo em execução no
ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.
Python
No editor do Cloud Shell, abra o código-fonte do aplicativo de amostra.
Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para
fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:
gcloud config set project YOUR-PROJECT-ID
Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml
e abra-o.
Substitua os marcadores de posição das variáveis de ambiente no arquivo
app.standard.yaml pelos seguintes valores:
<PROJECT-ID> pelo ID do projeto.
<INSTANCE-REGION> por us-central1.
<INSTANCE-NAME> pelo ID da instância que
aparece na página
Instâncias do Cloud SQL no console do Google Cloud.
<YOUR_DB_USER_NAME> por sqlserver.
<YOUR_DB_PASSWORD> pela senha de quickstart-user
que você criou em Criar um
usuário.
<YOUR_DB_NAME> por quickstart-db.
No prompt de comando do Cloud Shell, no
diretório python-docs-samples/cloud-sql/sql-server/sqlalchemy, execute o seguinte
comando gcloud app deploy
para implantar o aplicativo de exemplo no ambiente padrão do App Engine.
gcloud app deploy app.standard.yaml
Se for necessário escolher a região para criar o aplicativo,
insira a escolha numérica de us-central.
Quando a mensagem Você quer continuar? aparecer, digite Y.
Quando o comando de implantação for concluído, execute o
comando
gcloud app browse:
gcloud app browse
Clique no link gerado para ver o aplicativo de exemplo em execução no
ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.
IP particular
Para caminhos de IP privados, o aplicativo se conecta diretamente à
instância por meio do acesso VPC sem servidor. Esse método usa um soquete TCP para
se conectar diretamente à instância do Cloud SQL sem usar o proxy do Cloud SQL Auth.
Go
Criar e fazer o download do certificado do servidor SSL
No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.
Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para
fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:
gcloud config set project YOUR-PROJECT-ID
Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
Faça upload do arquivo do certificado do servidor SSL para a pasta certs.
No menu de navegação do Explorer do Cloud Shell Editor, navegue até a pasta
golang-samples/cloudsql/sqlserver/database-sql/certs.
Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
Selecione o arquivo a seguir na máquina local: server-ca.pem.
Com o arquivo de certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de upload do arquivo no editor do Cloud Shell.
No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml
e abra-o.
Copie e cole o seguinte código no arquivo, substituindo o conteúdo nele:
INSTANCE-NAME pelo ID da instância
que aparece na página Instâncias do Cloud SQL
no console do Google Cloud.
YOUR_DB_PASSWORD pela senha de
quickstart-user que você criou em
Criar um usuário.
INSTANCE_HOST pelo endereço IP particular
da instância que aparece na página Instâncias do Cloud SQL
no console do Google Cloud.
No prompt de comando do Cloud Shell, no
diretório golang-samples/cloudsql/sqlserver/database-sql, execute o seguinte
comando gcloud app deploy
para implantar o aplicativo de exemplo no ambiente padrão do App Engine.
gcloud app deploy cmd/app/app.standard.yaml
Se for necessário escolher a região para criar o aplicativo,
insira a escolha numérica de us-central.
Quando a mensagem Você quer continuar? aparecer, digite Y.
Quando o comando de implantação for concluído, execute o
comando
gcloud app browse:
gcloud app browse
Clique no link gerado para ver o aplicativo de exemplo em execução no
ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.
Node.js
Criar uma conexão VPC sem servidor para conexões com a instância via IP particular
No Console do Google Cloud, acesse a página Acesso VPC sem servidor - Criar conector.
Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para
fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:
gcloud config set project YOUR-PROJECT-ID
Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.standard.yaml
e abra-o.
Substitua os marcadores de posição das variáveis de ambiente no arquivo
app.standard.yaml pelos seguintes valores:
CLOUD_SQL_INSTANCE_IP_ADDRESS pelo endereço IP particular
da instância que aparece na página Instâncias do Cloud SQL
no console do Google Cloud.
MY_DB_USER por quickstart-user.
MY_DB_PASSWORD pela senha de
quickstart-user que você criou em
Criar um usuário.
MY_DATABASE por quickstart-db.
<MY-PROJECT> pelo ID do projeto.
<CONNECTOR_NAME> por quickstart-connector.
No prompt de comando do Cloud Shell, no
diretório nodejs-docs-samples/cloud-sql/sqlserver/mssql, execute o seguinte
comando gcloud app deploy
para implantar o aplicativo de exemplo no ambiente padrão do App Engine.
gcloud app deploy app.standard.yaml
Se for necessário escolher a região para criar o aplicativo,
insira a escolha numérica de us-central.
Quando a mensagem Você quer continuar? aparecer, digite Y.
Quando o comando de implantação for concluído, execute o
comando
gcloud app browse:
gcloud app browse
Clique no link gerado para ver o aplicativo de exemplo em execução no
ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.
Python
Criar e fazer o download do certificado do servidor SSL
No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.
Na caixa de diálogo Abrir no Cloud Shell, clique em Confirmar para
fazer o download do código do app de exemplo e abrir o diretório do app de exemplo no editor do Cloud Shell.
No prompt de comando do Cloud Shell, execute o seguinte comando para ativar o projeto:
gcloud config set project YOUR-PROJECT-ID
Se a caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
Faça upload do arquivo de certificado do servidor SSL para a pasta certs.
No menu de navegação do Explorer do Cloud Shell Editor, navegue até a pasta
python-docs-samples/cloud-sql/sql-server/sqlalchemy/certs.
Clique com o botão direito do mouse na pasta certs no editor do Cloud Shell e selecione Upload Files.
Selecione o arquivo a seguir na máquina local: server-ca.pem.
Com o arquivo de certificado do servidor SSL selecionado, clique em Abrir para concluir o processo de upload do arquivo no editor do Cloud Shell.
No menu de navegação do Explorer no Cloud Shell Editor, navegue até o arquivo python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml
e abra-o.
Copie e cole o seguinte código no arquivo, substituindo o
conteúdo dele:
YOUR_DB_PASSWORD pela senha de
quickstart-user que você criou em
Criar um usuário.
INSTANCE_HOST pelo endereço IP particular
da instância que aparece na página Instâncias do Cloud SQL
no console do Google Cloud.
PROJECT_ID pelo ID do projeto.
No prompt de comando do Cloud Shell, no
diretório python-docs-samples/cloud-sql/sql-server/sqlalchemy, execute o seguinte
comando gcloud app deploy
para implantar o aplicativo de exemplo no ambiente padrão do App Engine.
gcloud app deploy app.standard.yaml
Se for necessário escolher a região para criar o aplicativo,
insira a escolha numérica de us-central.
Quando a mensagem Você quer continuar? aparecer, digite Y.
Quando o comando de implantação for concluído, execute o
comando
gcloud app browse:
gcloud app browse
Clique no link gerado para ver o aplicativo de exemplo em execução no
ambiente padrão do App Engine. Esse ambiente está conectado ao Cloud SQL.
Limpar
Para evitar cobranças na conta do Google Cloud pelos
recursos usados nesta página, siga estas etapas.
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
Selecione a instância quickstart-instance para abrir a página Detalhes da instância.
Na barra de ícones na parte superior da página, clique em Excluir.
Na caixa de diálogo Excluir instância, digite quickstart-instance e clique em Excluir para excluir a instância.
Desativar o app impedirá que ele execute instâncias e atenda a solicitações.
Se o aplicativo estiver processando uma solicitação, ele a concluirá antes de ser
desativado.
Para desativar um aplicativo do App Engine e manter os dados dele, faça o
seguinte:
No console do Google Cloud, acesse a página Configurações:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-11-21 UTC."],[],[]]