Configurar o seu projeto do Google Cloud para o App Engine

Um Google Cloud projeto contém a sua aplicação do App Engine, bem como outros Google Cloud recursos.

Pode realizar todas as tarefas administrativas a partir da CLI Google Cloud e da API App Engine Admin, incluindo as tarefas comuns abordadas neste tópico.

Antes de poder implementar as suas apps no ambiente padrão do App Engine, normalmente, tem de criar ou configurar o seguinte:

  1. A Google Cloud projeto
  2. Uma aplicação do App Engine
  3. Uma conta de faturação

Criar um projeto e uma aplicação

Pode selecionar ou criar um novo Google Cloud projeto e uma aplicação do App Engine para criar e gerir uma coleção de definições, credenciais e os metadados da sua app. O App Engine requer que todos os projetos ativem a faturação, mas só lhe é cobrado um valor se um projeto exceder a respetiva quota gratuita.

Apenas a função de proprietário tem privilégios para criar uma aplicação do App Engine num Google Cloud projeto e essa aplicação tem de existir antes de qualquer outra conta poder realizar tarefas nessa aplicação. Por exemplo, a aplicação do App Engine tem de ser criada antes de uma conta com a função App Engine Deployer poder implementar uma app através de uma conta de serviço.

gcloud

Depois de instalar a CLI do Google Cloud, uma conta com a função de proprietário do projeto pode executar os seguintes comandos gcloud para criar um projeto e uma aplicação do App Engine: Google Cloud Google Cloud

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

    gcloud projects create PROJECT_ID

    Substitua PROJECT_ID pelo Google Cloud ID do projeto.

  2. Execute o seguinte comando para selecionar uma região e criar uma aplicação do App Engine:

    gcloud app create

    Mais informações sobre as localizações do App Engine

  3. Ative a faturação na página Faturação da Google Cloud consola. Consulte o artigo Ativar a faturação para ver detalhes.

API

Para criar programaticamente um Google Cloud projeto e uma aplicação do App Engine, use a API Cloud Resource Manager e a API App Engine Admin:

  1. Para criar um Google Cloud projeto, consulte o artigo Criar um novo projeto.

  2. Para criar uma aplicação do App Engine, consulte o artigo Criar aplicações do App Engine.

  3. Ative a faturação na página Faturação da Google Cloud consola. Consulte o artigo Ativar a faturação para ver detalhes.

Consola

Para criar um Google Cloud projeto e uma aplicação do App Engine com a faturação ativada:

  1. Aceda à página do App Engine:

    Aceder ao App Engine

  2. Selecione ou crie um Google Cloud projeto.

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

    1. Selecione uma região para especificar onde quer que a sua aplicação do App Engine esteja localizada.
      Mais informações sobre as localizações do App Engine
    2. Selecione uma conta de serviço para a sua app em Identidade e acesso à API.
    3. Selecione ou crie uma conta de faturação para ativar a faturação no seu projeto.

Depois de criar a aplicação App Engine no seu projeto, é aberta a página Painel de controlo.

Ativar faturação

Para implementar as suas apps, tem de ativar a faturação. Não é feita nenhuma cobrança na sua conta se permanecer dentro da quota gratuita. Se a sua aplicação precisar de recursos que excedam a quota gratuita, ser-lhe-á cobrado o custo da utilização adicional.

Se tiver uma conta de faturação quando criar um Google Cloud projeto, a faturação é ativada automaticamente nesse projeto.

Para ativar a faturação num Google Cloud projeto:

  1. Na Google Cloud consola, aceda à página Faturação:

    Aceder a Faturação

  2. Selecione ou crie um Google Cloud projeto.

  3. Consoante exista uma conta de faturação ou oGoogle Cloud projeto selecionado esteja associado a uma conta, a página Faturação apresenta uma das seguintes opções:

    • Se a faturação já estiver ativada para o Google Cloud projeto selecionado, são apresentados os detalhes sobre a conta de faturação.

    • Se não existir nenhuma conta de faturação, é-lhe pedido que crie uma e a associe ao Google Cloud projeto selecionado.

    • Se existir uma conta de faturação, é-lhe pedido que ative a faturação se o projeto selecionado Google Cloud ainda não estiver associado a uma conta de faturação. Também pode clicar em Cancelar e, de seguida, em Criar conta para criar e associar uma nova conta de faturação.

Depois de ativar a faturação, não existe um limite para o valor que lhe pode ser cobrado. Para ter mais controlo sobre os custos da sua aplicação, pode criar um orçamento e definir alertas.

Gerir faturação

Use a página Faturação para gerir as suas contas de faturação:

  1. Aceda à página Faturação na Google Cloud consola:

    Aceder a Faturação

  2. Selecione a conta que quer gerir e, de seguida, navegue para a página correspondente para realizar as seguintes tarefas de gestão:

    • Veja uma vista geral da sua conta de faturação, faça pagamentos e adicione administradores da conta de faturação na página Vista geral.
    • Crie orçamentos e alertas na página Orçamentos e alertas.
    • Veja o seu histórico de transações e transfira faturas na página Transações.
    • Exporte os seus dados de faturação para um conjunto de dados do BigQuery a partir da página Exportação de faturação.
    • Configure a sua conta de pagamentos e contactos na página Definições de pagamento.
    • Defina o método de pagamento na página Método de pagamento.

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

Criar orçamentos e definir alertas

Pode criar um orçamento para um Google Cloud projeto para evitar surpresas na sua fatura e monitorizar todas as Google Cloud cobranças a partir de um único local. Com um orçamento, pode criar alertas que enviam emails aos seus administradores de faturação quando os encargos excedem um determinado valor.

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

  1. Na Google Cloud consola, aceda à página Faturação:

    Aceder a Faturação

  2. Clique na conta de faturação para a qual quer criar um orçamento.

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

  4. Defina o seu orçamento na secção Definir orçamento e, em seguida, especifique as percentagens para as quais quer receber alertas por email na secção Definir alertas de orçamento.

  5. Clique em Guardar para definir o orçamento e ativar os alertas para o seu Google Cloud projeto. Se tiver vários Google Cloud projetos, tem de definir individualmente orçamentos e alertas em cada projeto.

Definir o ID do projeto para um projeto

Pode especificar o ID do projeto de várias formas:

  • Usando gcloud init quando instala a Google Cloud CLI. Para ver o ID do projeto predefinido da CLI gcloud, execute gcloud config list.
  • Usando o comando gcloud config set project [YOUR_PROJECT_ID] para definir o ID do projeto predefinido da CLI gcloud.
  • Ao usar a flag --project quando implementa a sua app, por exemplo: gcloud app deploy --project [YOUR_PROJECT_ID]

Se usar o tempo de execução Java, pode especificar o ID do projeto durante a implementação através do plug-in do Google Cloud para IntelliJ ou do plug-in do Google Cloud para Eclipse.

Desativar uma aplicação

Desative uma aplicação do App Engine para impedir que a sua app execute instâncias e publique pedidos. Não ocorre perda de dados quando desativa a app, nem são alteradas as definições de configuração. Basta reativar a aplicação do App Engine para iniciar instâncias e continuar a publicar o tráfego para a sua app.

Os recursos da sua app no ambiente padrão e flexível estão desativados e, por isso, não vão gerar custos. No entanto, podem continuar a ocorrer cobranças de faturação pelos outros serviços no seu projeto do Google Cloud . Por exemplo, pode continuar a incorrer em cobranças de armazenamento pelos seus dados armazenados.

Se a sua app estiver a processar ativamente um pedido, vai continuar a concluir essa tarefa e pode demorar até uma hora antes de a app ser completamente desativada.

Para desativar uma aplicação do App Engine:

  1. Aceda à página de definições da aplicação:

    Aceda às Definições de aplicações

  2. Clique em Desativar aplicação e, de seguida, siga as instruções.

Quando quiser que a sua app continue a publicar pedidos, ative a aplicação do App Engine regressando à mesma página de Definições da aplicação e, de seguida, clicando em Ativar aplicação.

A desativação da aplicação interrompe todos os pedidos de publicação, mas os dados e o estado são mantidos. Continua a receber faturas relativas a encargos aplicáveis já incorridos ou encargos relativos a outros serviços em execução no seu projeto, como o Cloud SQL. Para libertar todos os recursos usados no projeto, encerre-o.

Encerrar um projeto

Pode desativar a faturação e libertar todos os Google Cloud recursos que estão a ser usados no seu Google Cloud projeto encerrando esse projeto.

gcloud

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

gcloud projects delete PROJECT_ID

Substitua PROJECT_ID pelo Google Cloud ID do projeto.

API

Para encerrar o seu Google Cloud projeto de forma programática, consulte o artigo Encerrar um projeto na API Cloud Resource Manager.

Consola

Para encerrar um Google Cloud projeto através da Google Cloud consola:

  1. Aceda à página Projetos:

    Aceder a Projetos

  2. Selecione o Google Cloud projeto que quer encerrar e, de seguida, clique em .

Para mais informações sobre a gestão dos seus Google Cloud projetos, consulte o artigo Cloud Resource Manager: criar, encerrar e restaurar projetos.