Definir definições de tempo de execução

Uma app do App Engine é configurada através de um ficheiro app.yaml que contém o tempo de execução, os controladores, o dimensionamento e outras definições gerais , incluindo variáveis de ambiente.

Acerca de app.yaml ficheiros

Pode especificar a configuração de tempo de execução da sua app Java, incluindo versões e URLs, no ficheiro app.yaml. Este ficheiro funciona como um descritor de implementação de uma versão específica do serviço.

Se não criar um ficheiro app.yaml, o comando gcloud app deploy pode criar um quando implementar a sua aplicação. O ficheiro app.yaml criado pelo App Engine contém apenas as definições necessárias para executar a sua aplicação.

Geralmente, o seu ficheiro app.yaml requer apenas o elemento runtime para uma app Java simples no ambiente padrão, por exemplo:

runtime: java21

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

Se precisar de substituir as definições predefinidas, crie um ficheiro app.yaml e especifique as definições necessárias. Para mais informações, consulte a app.yaml referência de ficheiros.

Pode especificar um nome exclusivo para os seus ficheiros app.yaml, mas, em seguida, tem de especificar o nome do ficheiro com o comando de implementação também. Por exemplo, se der o nome app.yaml ao ficheiro service-name-app.yaml ou app.standard.yaml, tem de implementar a sua app através de:

gcloud app deploy service-name-app.yaml
gcloud app deploy app.standard.yaml

Para saber como estruturar vários serviços e ficheiros app.yaml na sua app, consulte o artigo Estruturar serviços Web.

Para um projeto Maven, a localização padrão do ficheiro app.yaml encontra-se no diretório src/main/appengine. O plug-in do Maven do App Engine cria um diretório target/appengine-staging correto que contém os seus artefactos JAR e este ficheiro app.yaml, pronto para implementação.

Segue-se um exemplo da estrutura de um projeto Maven:

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

Se tiver mais do que um ficheiro JAR no diretório do projeto ou quiser especificar um ponto de entrada personalizado, tem de o especificar no elemento entrypoint do ficheiro app.yaml.

Todos os elementos de configuração

Para ver uma lista completa de todos os elementos suportados neste ficheiro de configuração, consulte a referência app.yaml.