Conectar-se ao Cloud SQL para MySQL pelo ambiente padrão do App Engine

Saiba como implantar um aplicativo de exemplo no ambiente padrão do App Engine conectado a uma instância do MySQL 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

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  6. Ative as APIs do Cloud necessárias para executar um aplicativo de exemplo do Cloud SQL no ambiente padrão do App Engine.

    Console

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

    Ative as APIs

    Isso permite as seguintes APIs:

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

    gcloud

    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.

    Abra o Cloud Shell

    Execute o comando gcloud a seguir usando o Cloud Shell:

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

    Esse comando ativa as seguintes APIs:

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

Configurar o Cloud SQL

crie uma instância do Cloud SQL

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. No menu de navegação SQL, selecione Bancos de dados.
  4. Clique em Criar banco de dados.
    1. No campo Nome do banco de dados da caixa de diálogo Criar um banco de dados, insira quickstart-db. Deixe os valores do conjunto de caracteres e da ordenação.
    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. No menu de navegação SQL, selecione Usuários.
  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:
    1. No campo Nome de usuário, digite quickstart-user.
    2. 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 Adicionar.

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 do Cloud SQL e do MySQL no local. O limite é de 32 caracteres no MySQL 8.0 e 16 caracteres nas versões anteriores.

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

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

    Acessar o App Engine

  2. Clique no botão Criar aplicativo.
  3. Escolha us-central no menu suspenso Selecionar uma região.
  4. Clique em Next.
  5. Clique no link Fazer isso mais tarde quando ele aparecer na página Primeiros passos.

gcloud

  1. Execute este comando gcloud app create para criar um aplicativo do App Engine:
  2. gcloud app create
  3. Quando for solicitado que você escolha a região em que o aplicativo do App Engine estará localizado, digite a escolha numérica de us-central.

Configurar a conta de serviço do App Engine

Configure a conta de serviço usada pelo App Engine para que ela tenha o papel Cliente do Cloud SQL com permissões para se conectar ao Cloud SQL.

Console

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

    Acessar IAM

  2. Na conta de serviço denominada Conta de serviço padrão do App Engine, clique no ícone de lápis.
  3. Clique em Adicionar outro papel.
  4. Adicione o Papel chamado Cliente do Cloud SQL.
  5. Clique em Save.

gcloud

  1. Execute o seguinte comando gcloud para ver uma lista de contas de serviço do seu projeto:
    gcloud iam service-accounts list
  2. Copie o E-MAIL da conta de serviço do App Engine.
  3. Execute o seguinte comando para adicionar o papel Cliente do Cloud SQL à conta de serviço do Compute Engine:
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
      --role="roles/cloudsql.client"

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.

Limpar

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

  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. 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:

  1. No console do Google Cloud, acesse a página Configurações:

    Acesse configurações

  2. Na guia Configurações do aplicativo, clique em Desativar aplicativo.

  3. No campo ID do app, insira o ID do aplicativo que você quer desativar e clique em Desativar.

Etapas de limpeza opcionais

Se você não estiver usando o papel Cliente do Cloud SQL que foi atribuído à conta de serviço do Compute Engine, será possível removê-lo.

  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 as APIs que foram ativadas como parte deste guia de início rápido, é possível desativá-las.

  • APIs que foram 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. 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 sobre como criar usuários do MySQL 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 MySQL.

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: