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.

É possível executar todas as tarefas administrativas na Google Cloud CLI e na API App Engine Admin, incluindo as tarefas comuns abordadas neste tópico.

Normalmente, antes de implantar os aplicativos no ambiente padrão do App Engine, você precisa criar ou configurar:

  1. Um projeto do 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. O App Engine exige que todos os projetos ativem o faturamento, mas você só será cobrado se um projeto exceder a cota gratuita.

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

  1. Execute o comando a seguir para criar um projeto do Cloud:

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

    gcloud app create
  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 Cloud e um aplicativo do App Engine de forma programática, use a API Resource Manager e a API Admin do App Engine:

  1. Para criar um projeto do 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 Cloud e um aplicativo do App Engine com o faturamento ativado:

  1. Acesse a página do App Engine:

    Acessar a página do App Engine

  2. Selecione ou crie um projeto do Cloud.

  3. Na página Seu primeiro aplicativo com Go 1.12+, selecione a regiã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 ou crie uma conta de faturamento para ativá-lo no projeto.

Depois que o aplicativo do App Engine for criado no projeto, a página Painel será aberta.

Como ativar o 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 Cloud, o faturamento dele será ativado automaticamente.

Para ativar o faturamento de um projeto do Cloud:

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

    Acessar a página "Faturamento"

  2. Selecione ou crie um projeto do Cloud.

  3. Se existir uma conta de faturamento ou se o projeto do 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 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 Cloud selecionado.

    • Se já houver uma conta de faturamento, você será solicitado a ativar o faturamento se o projeto do 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 imite para as cobranças. Para ter mais controle sobre os custos do aplicativo, crie um orçamento e defina alertas.

Como alterar ou remover um limite de gastos

O limite de gastos permite especificar um valor máximo diário aproximado a ser cobrado pelo uso diário de recursos do App Engine no ambiente padrão.

Como alterar um limite de gastos

Para alterar um limite de gastos:

  1. Faça login no console do Google Cloud usando uma conta que tenha pelo menos um papel do IAM de cada um destes grupos:

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

    Acessar a página "Configurações do aplicativo"

  3. Clique em Editar e especifique um novo limite de gastos. Quando o limite de gastos diário é aumentado, ele entra em vigor imediatamente.

  4. Clique em Salvar para definir o limite de gastos para este projeto do Cloud. Se você tiver mais de um projeto do Cloud, defina os limites de gastos individualmente em cada projeto.

O limite de gastos se aplica apenas ao consumo de recursos do App Engine. Ele não se destina a outros recursos do Google Cloud, e você será cobrado por usá-los. Além disso, talvez os limites de gastos sejam ligeiramente ultrapassados antes que o aplicativo seja desativado automaticamente.

Como remover um limite de gastos

Depois que o limite de gastos for removido de um projeto, não será mais possível criar limites de gastos nesse projeto.

Para remover um limite de gastos, entre em contato com o suporte:

  1. Faça login no console do Google Cloud usando uma conta que tenha pelo menos um papel do IAM de cada um destes grupos:

  2. No console do Google Cloud, abra a página de suporte.

    Suporte

  3. Use o método que você preferir para entrar em contato com o suporte.

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 a página "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 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 Cloud:

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

    Acessar a página "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 projeto do 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 Cloud, defina os orçamentos e os alertas individualmente em cada um deles.

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

    Acessar a página "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 Cloud, encerre esse projeto.

gcloud

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

gcloud projects delete

API

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

Console

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

  1. Acesse a página "Projetos":

    Acessar a página "Projetos"

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

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