Como configurar seu projeto do Google Cloud para o App Engine

Um projeto do Google Cloud inclui o aplicativo do App Engine e outros recursos do Google Cloud.

No console do Google Cloud, na Google Cloud CLI e na API App Engine Admin, é possível realizar todas as tarefas administrativas, incluindo as tarefas comuns abordadas neste tópico.

Normalmente, antes de implantar apps no ambiente flexível do App Engine, é necessário criar ou configurar o seguinte:

  1. Um projeto do Google Cloud.
  2. Um aplicativo do App Engine
  3. Uma conta de faturamento

Como criar um projeto e um aplicativo

Selecione ou crie um novo projeto do Google Cloud e um aplicativo do App Engine para criar e gerenciar uma coleção de configurações, credenciais e metadados do app.

Somente o papel Proprietário tem privilégios para criar um aplicativo do App Engine em um projeto do Google Cloud e esse aplicativo precisa existir antes de qualquer outra conta executar tarefas nele. Por exemplo, o aplicativo do App Engine precisa ser criado para que uma conta com o papel Implantador do App Engine possa implantar um aplicativo usando uma conta de serviço.

gcloud

Depois de instalar a Google Cloud CLI, uma conta com o papel Proprietário de projeto do Google Cloud vai poder executar os seguintes comandos gcloud para criar um projeto do Google Cloud e um aplicativo do App Engine:

  1. Execute o seguinte comando para criar um projeto do Google Cloud:

    gcloud projects create PROJECT_ID

    Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

  2. Execute o comando abaixo para selecionar uma região e criar um aplicativo do App Engine:

    gcloud app create

    Saiba mais sobre locais do App Engine

  3. Ative o faturamento na página "Faturamento" do console do Google Cloud. Veja mais detalhes em Como ativar o faturamento.

API

Para criar um projeto do Google Cloud e um aplicativo do App Engine de maneira programática, use a API Cloud Resource Manager e a API Admin do App Engine:

  1. Para criar um projeto do Google Cloud, consulte Como criar um novo projeto.

  2. Para criar um aplicativo do App Engine, consulte Como criar aplicativos do App Engine.

  3. Ative o faturamento na página "Faturamento" do console do Google Cloud. Veja mais detalhes em Como ativar o faturamento.

Console

Para criar um projeto do Google Cloud e um aplicativo do App Engine com o faturamento ativado:

  1. Acesse a página do App Engine:

    Acessar o App Engine

  2. Selecione ou crie um projeto do Google Cloud.

  3. Na página Criar aplicativo, selecione uma região e uma conta de serviço e ative o faturamento:

    1. Selecione uma região para especificar onde armazenar o aplicativo do App Engine.
      Saiba mais sobre locais do App Engine
    2. Selecione uma conta de serviço para seu aplicativo em Identidade e acesso à API.
    3. Selecione ou crie uma conta de faturamento para ativá-lo no projeto.

A página do Painel será exibida após a criação do aplicativo do App Engine e a ativação do faturamento.

Ativando faturamento

Para implantar seus aplicativos, ative o faturamento. Sua conta não será cobrada se você permanecer na cota gratuita. Se o aplicativo precisar de recursos que excedam a cota gratuita, você será cobrado pelo uso adicional.

Se você tiver uma conta de faturamento ao criar um projeto do Google Cloud, o faturamento dele será ativado automaticamente.

Para ativar o faturamento de um projeto do Google Cloud:

  1. No console do Google Cloud, abra a página de faturamento:

    Acessar "Faturamento"

  2. Selecione ou crie um projeto do Google Cloud.

  3. Se existir uma conta de faturamento ou se o projeto do Google Cloud selecionado estiver associado a uma conta, a página "Faturamento" exibirá uma destas opções:

    • Caso o faturamento já esteja ativado para o projeto do Google Cloud selecionado, os detalhes sobre a conta de faturamento serão listados.

    • Se não houver uma conta de faturamento, você será solicitado a criar uma e associá-la ao projeto do Google Cloud selecionado.

    • Se já houver uma conta de faturamento, você será solicitado a ativar o faturamento se o projeto do Google Cloud selecionado ainda não estiver associado a uma conta de faturamento. Se preferir, clique em Cancelar e depois em Criar conta para criar e associar uma nova conta de faturamento.

Após a ativação do faturamento, não haverá um valor limite para as cobranças. Para ter mais controle sobre os custos do aplicativo, crie um orçamento e defina alertas.

Como gerenciar o faturamento

Use a página "Faturamento" para gerenciar suas contas de faturamento:

  1. Acesse a página "Faturamento" no console do Google Cloud:

    Acessar Faturamento

  2. Selecione a conta que você quer gerenciar e acesse a página correspondente para executar as tarefas de gerenciamento a seguir:

    • Ter uma visão geral da conta de faturamento, fazer pagamentos e adicionar administradores de conta de faturamento na página Visão geral.
    • Criar orçamentos e alertas na página Orçamentos e alertas.
    • Ver seu histórico de transações e fazer o download das faturas na página Transações.
    • Exportar seus dados de faturamento para um conjunto de dados do BigQuery na página Exportação de faturamento.
    • Configurar sua conta para pagamentos e seus contatos na página Configurações de pagamento.
    • Definir a forma de pagamento na página Forma de pagamento.

Para mais informações sobre faturamento, consulte a página Preços.

Como criar orçamentos e definir alertas

Para evitar surpresas em sua fatura e monitorar todas as cobranças do Google Cloud em um só lugar, crie um orçamento para o projeto do Google Cloud. Com um orçamento, é possível alertas para enviar e-mails aos administradores de faturamento quando as cobranças excederem um determinado valor.

Para criar um orçamento e definir alertas em um projeto do Google Cloud:

  1. No console do Google Cloud, abra a página de faturamento:

    Acessar Faturamento

  2. Clique na conta de faturamento para a qual você quer criar um orçamento.

  3. Clique em Orçamentos e alertas e em Criar orçamento para começar a criar um orçamento para o projeto do Google Cloud.

  4. Defina o orçamento na seção Configurar orçamento e especifique as porcentagens que acionarão o envio dos alertas por e-mail na seção Definir alertas de orçamento.

  5. Clique em Salvar para definir o orçamento e ativar alertas para seu projeto do Google Cloud. Se você tiver vários projetos do Google Cloud, defina os orçamentos e os alertas individualmente em cada um deles.

Como definir o ID de um projeto

Em alguns ambientes de execução do ambiente padrão do App Engine, é possível especificar o ID do projeto do Google Cloud (às vezes chamado de "ID do app") no arquivo app.yaml do projeto.

É possível especificar o ID do projeto de algumas maneiras diferentes:

  • Usando gcloud init ao instalar a Google Cloud. Para ver o ID do projeto padrão da CLI gcloud, execute gcloud config list.
  • Usando o comando gcloud config set project [YOUR_PROJECT_ID] para definir o ID do projeto padrão da CLI gcloud.
  • Usando a sinalização --project ao implantar o app, por exemplo: gcloud app deploy --project [YOUR_PROJECT_ID]

Se você usar o ambiente de execução do Java, poderá especificar o ID do projeto durante a implantação usando o plug-in do Google Cloud para IntelliJ ou o plug-in do Google Cloud para Eclipse

Como desativar um aplicativo

Desative o aplicativo do App Engine para impedir que seu app execute instâncias e exiba solicitações. Não ocorrerá nenhuma perda de dados nem alteração das configurações ao desativar o aplicativo. Para reiniciar as instâncias e continuar exibindo o tráfego para seu app, basta reativar o aplicativo do App Engine.

Após a desativação, os recursos do app, tanto no ambiente padrão quanto no ambiente flexível, serão desativados. Portanto, não haverá cobranças. No entanto, outros serviços no projeto do Google Cloud ainda poderão ser cobrados. Por exemplo, você ainda poderá receber cobranças pelos dados armazenados.

Se o app estiver processando ativamente uma solicitação, essa tarefa será concluída antes do app ser totalmente desativado. Isso poderá levar até uma hora.

Para desativar um aplicativo do App Engine:

  1. Acesse a página "Configurações do aplicativo":

    Acesse as configurações do aplicativo

  2. Clique em Desativar aplicativo e siga as instruções.

Se quiser que o aplicativo continue exibindo solicitações, ative o aplicativo do App Engine. Para isso, retorne à mesma página Configurações do aplicativo e clique em Ativar aplicativo.

Desativar o aplicativo interromperá todas as solicitações exibidas, mas os dados e o estado serão mantidos. Você ainda será cobrado pelos encargos aplicáveis já incorridos ou pelos encargos de outros serviços em execução no seu projeto, como o Cloud SQL. Para liberar todos os recursos usados no projeto, encerre-o.

Como encerrar um projeto

Para desativar o faturamento e liberar todos os recursos do Google Cloud que estão sendo usados no projeto do Google Cloud, encerre esse projeto.

gcloud

Depois de instalar a Google Cloud CLI, execute o comando gcloud a seguir para encerrar um projeto do Google Cloud:

gcloud projects delete PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

API

Para encerrar o projeto do Google Cloud de maneira programática, veja Como encerrar um projeto na API Cloud Resource Manager.

Console

Para encerrar um projeto do Google Cloud usando o console do Google Cloud:

  1. Acesse a página "Projetos":

    Acessar Projetos

  2. Selecione o projeto do Google Cloud que você quer encerrar e clique em .

Saiba mais sobre como gerenciar os projetos do Google Cloud em Cloud Resource Manager: como criar, encerrar e restaurar projetos.