Como definir configurações do ambiente de execução

Um aplicativo do App Engine é configurado usando um arquivo app.yaml , que contém o ambiente de execução, gerenciadores, escalonamento e outras configurações gerais, incluindo variáveis de ambiente.

Sobre arquivos app.yaml

É possível especificar a configuração de ambiente de execução do aplicativo Java, incluindo versões e URLs, no arquivo app.yaml. Esse arquivo atua como um descritor de implantação de uma versão de serviço específica.

Se você não criar um arquivo app.yaml, o comando gcloud app deploy poderá criar um quando implantar o aplicativo. O arquivo app.yaml que o App Engine cria contém apenas as configurações necessárias para executar seu aplicativo.

Geralmente, o arquivo app.yaml requer apenas o elemento runtime para um aplicativo simples do Java no ambiente padrão, por exemplo:

runtime: java21

O App Engine fornece valores padrão para todas as outras configurações, incluindo a classe de instância F1, que determina os recursos de memória e CPU disponíveis para o app, e o escalonamento automático, que controla como e quando novas instâncias do app são criadas.

Se você precisar modificar as configurações padrão, crie um arquivo app.yaml e especifique as configurações necessárias. Para mais informações, consulte a referência do arquivo app.yaml.

É possível especificar um nome único para os arquivos app.yaml, mas será necessário especificar o nome do arquivo com o comando de implantação também. Por exemplo, ao nomear seu arquivo app.yaml, service-name-app.yaml ou app.standard.yaml, será preciso implantar o aplicativo usando:

gcloud app deploy service-name-app.yaml
gcloud app deploy app.standard.yaml
Para saber mais sobre como estruturar vários serviços e arquivos app.yaml no app, consulte Como estruturar serviços da Web.

Para um projeto do Maven, o local padrão do arquivo app.yaml está no diretório src/main/appengine. O plug-in Maven do App Engine criará um diretório target/appengine-staging correto contendo seus artefatos JAR e esse arquivo app.yaml, pronto para implantação.

Veja a seguir um exemplo de estrutura de projeto do Maven:

MyDir/
  pom.xml
  [index.yaml]
  [cron.yaml]
  [dispatch.yaml]
  src/main/
    appengine/
      app.yaml
    java/com.example.mycode/
      MyCode.java

Se você tiver mais de um arquivo JAR no diretório do seu projeto ou quiser especificar um ponto de entrada personalizado, precisará especificá-lo no elemento entrypoint do seu arquivo app.yaml.

Todos os elementos de configuração

Para uma lista completa de todos os elementos compatíveis com esse arquivo de configuração, consulte a referência do app.yaml.