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