Define la configuración del entorno de ejecución

Una app de App Engine se configura mediante un archivo app.yaml, que contiene el entorno de ejecución, los controladores, el escalamiento y otras configuraciones generales, incluidas las variables de entorno.

Acerca de los archivos app.yaml

Puedes especificar la configuración del entorno de ejecución para tu app de Java, incluidas las versiones y las URL, en el archivo app.yaml. Este actúa como un descriptor de implementación de una versión específica del servicio.

Si no creas un archivo app.yaml, el comando gcloud app deploy podrá crear uno cuando implementes la aplicación. El archivo app.yaml que App Engine crea contiene solo la configuración necesaria para ejecutar la aplicación.

Por lo general, el archivo app.yaml solo requiere el elemento runtime para una app simple de Java en el entorno estándar, por ejemplo:

runtime: java21

App Engine proporciona valores predeterminados para todas las demás opciones de configuración, incluida la clase de instancia F1, que determina la memoria y los recursos de CPU disponibles para tu app, y el ajuste de escala automático, que controla cómo y cuándo se crean las instancias nuevas de tu app.

Si necesitas anular la configuración predeterminada, crea un archivo app.yaml y especifica la configuración que necesitas. Para obtener más información, consulta la referencia del archivo app.yaml.

Puedes especificar un nombre único para tus archivos app.yaml, pero también debes especificar el nombre del archivo con el comando de implementación. Por ejemplo, si al archivo app.yaml lo nombras service-name-app.yaml o app.standard.yaml, debes implementar la aplicación mediante una de las siguientes opciones:

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

Para obtener más información sobre cómo estructurar varios servicios y archivos app.yaml en tu aplicación, consulta Estructura servicios web.

Para un proyecto de Maven, la ubicación estándar del archivo app.yaml se encuentra en el directorio src/main/appengine. El complemento de Maven de App Engine creará un directorio target/appengine-staging correcto con tus artefactos JAR y este archivo app.yaml, listo para la implementación.

A continuación, se muestra una estructura del proyecto de Maven de muestra:

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

Si tienes más de un archivo JAR en el directorio de tu proyecto o quieres especificar un punto de entrada personalizado, debes especificarlo en el elemento entrypoint de tu archivo app.yaml.

Todos los elementos de configuración

Para obtener una lista completa de todos los elementos compatibles con este archivo de configuración, consulta la referencia de app.yaml.