Como configurar o projeto Google Cloud para o App Engine

Um Google Cloud projeto contém o aplicativo do App Engine e outros Google Cloud recursos.

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

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.

Importante: Cada Google Cloud projeto só pode conter um único aplicativo do App Engine e, após criá-lo, não será possível alterar o local dele.

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.

   Dicas:

   • Se você implantar seus aplicativos com o gcloud app deploy comando, a CLI gcloud fará com que o Google Cloud projeto inclua um aplicativo do App Engine e solicitará que você selecione uma região quando necessário.
   • Para verificar se existe um aplicativo do App Engine no seu Google Cloud projeto, execute o gcloud app describe comando.

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

**Observação**: isso não se aplica ao Python.

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.

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

Locais do App Engine

O App Engine é regional. Isso significa que a infraestrutura que executa os aplicativos está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região.

Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do aplicativo, mas considere os locais em que o App Engine está disponível bem como os locais dos outros Google Cloud produtos e serviços usados pelo app. O uso de serviços em vários locais pode afetar a latência e o preço do aplicativo.

Não é possível alterar a região de um aplicativo depois de defini-la.

**Observação**: dois locais, chamados europe-west e us-central nos comandos do App Engine e no Google Cloud console do Cloud, são chamados europe-west1 e us-central1, respectivamente, em todos os outros lugares da documentação do Google.

Se você já criou um aplicativo do App Engine, será possível ver a região dele com um dos seguintes procedimentos:

• Execute o comando gcloud app describe.

• Abra o Painel do App Engine no Google Cloud console do Cloud. A região aparece perto do topo da página.

OK

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. Noconsole do Cloud, acesse a página "Faturamento": Google Cloud

   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, faça o seguinte:

1. Noconsole do Cloud, acesse a página "Faturamento": Google Cloud

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

Como definir o ID 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, as cobranças de faturamento ainda podem ocorrer para os outros serviços no seu Google Cloud projeto. Por exemplo, você ainda pode incorrer em cobranças de armazenamento para os 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 Google Cloud recursos que estão sendo usados no seu Google Cloud projeto, encerre esse projeto.

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.