Como configurar o projeto Google Cloud para o App Engine

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

No Google Cloud console, 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. U Google Cloud mprojeto
  2. Um aplicativo do App Engine
  3. Uma conta de faturamento

Como criar um projeto e um aplicativo

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

Somente o papel Proprietário tem privilégios para criar um aplicativo do App Engine em um Google Cloud projeto 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 do projeto vai poder executar os seguintes gcloud comandos para criar um Google Cloud projeto e um aplicativo do App Engine: Google Cloud

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

    gcloud projects create PROJECT_ID

    Substitua PROJECT_ID pelo Google Cloud ID do projeto.

  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 Google Cloud console do Cloud. Saiba mais em Como ativar o faturamento.

API

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

  1. Para criar um Google Cloud projeto, 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 Google Cloud console do Cloud. Saiba mais em Como ativar o faturamento.

Console

Para criar um Google Cloud projeto 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 Google Cloud projeto do.

  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 sua cota sem custo financeiro. Se o aplicativo precisar de recursos que excedam a cota sem custo financeiro, você será cobrado pelo uso adicional.

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

Para ativar o faturamento em um Google Cloud projeto:

  1. No Google Cloud console, acesse a página Recomendações.

    Acessar "Faturamento"

  2. Selecione ou crie um Google Cloud projeto do.

  3. Uma das opções abaixo será exibida, dependendo da existência de uma conta de faturamento ou se o projeto selecionado Google Cloud está associado a uma conta:

    • Caso o faturamento já esteja ativado para o projeto escolhido Google Cloud , os detalhes sobre a conta de faturamento vão aparecer.

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

    • Se já houver uma conta de faturamento, você será solicitado a ativar o faturamento se o projeto 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 Google Cloud console do 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 Google Cloud cobranças em um só lugar, crie um orçamento para o Google Cloud projeto. 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 Google Cloud projeto:

  1. No Google Cloud console, acesse a página Recomendações.

    Acessar "Faturamento"

  2. Clique na conta de faturamento em que 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 Google Cloud projeto.

  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 os alertas para o seu Google Cloud projeto. Se você tiver vários Google Cloud projetos, será necessário definir orçamentos e alertas individualmente em cada um deles.

Como definir o ID do projeto

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

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, ainda poderão ocorrer cobranças de outros serviços no Google Cloud projeto, como no caso do armazenamento de dados.

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

É possível desativar o faturamento e liberar todos os Google Cloud recursos que estão sendo usados no seu Google Cloud projeto encerrando-o.

gcloud

Depois de instalar a Google Cloud CLI, execute o gcloudcomando Google Cloud a seguir para desligar um projeto:

gcloud projects delete PROJECT_ID

Substitua PROJECT_ID pelo Google Cloud ID do projeto.

API

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

Console

Para desligar um Google Cloud projeto usando o Google Cloud console:

  1. Acesse a página "Projetos":

    Acessar Projetos

  2. Selecione o Google Cloud projeto que você quer desligar e, em seguida, clique em .

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