Définir des paramètres d'exécution

Une application App Engine est configurée à l'aide d'un fichier app.yaml contenant l'environnement d'exécution, les gestionnaires, le scaling et d'autres paramètres généraux, y compris les variables d'environnement.

À propos des fichiers app.yaml

Vous pouvez spécifier la configuration de l'environnement d'exécution de votre application Java, y compris les versions et les URL, dans le fichier app.yaml. Ce fichier sert de descripteur de déploiement pour une version de service spécifique.

Si vous ne créez pas de fichier app.yaml, la commande gcloud app deploy peut en créer un lorsque vous déployez votre application. Le fichier app.yaml créé par App Engine ne contient que les paramètres requis pour exécuter votre application.

Généralement, le fichier app.yaml ne requiert que l'élément runtime pour une application Java simple dans l'environnement standard, par exemple :

runtime: java21

App Engine fournit des valeurs par défaut pour tous les autres paramètres, y compris la classe d'instance F1 qui détermine les ressources de mémoire et de processeur disponibles pour votre application, et le scaling automatique qui contrôle comment et quand les instances de votre application sont créées.

Si vous devez remplacer les paramètres par défaut, créez un fichier app.yaml et spécifiez les paramètres nécessaires. Pour en savoir plus, consultez la documentation de référence du fichier app.yaml.

Vous pouvez spécifier un nom unique pour les fichiers app.yaml. Toutefois, dans ce cas, vous devez également spécifier ce nom de fichier dans la commande de déploiement. Par exemple, si vous nommez votre fichier app.yaml "service-name-app.yaml" ou "app.standard.yaml", vous devez déployer votre application à l'aide de l'une des commandes suivantes :

gcloud app deploy service-name-app.yaml
gcloud app deploy app.standard.yaml
Pour savoir comment structurer plusieurs services et fichiers app.yaml dans votre application, consultez la page Structurer des services Web.

Pour un projet Maven, l'emplacement standard du fichier app.yaml se trouve dans le répertoire src/main/appengine. Le plug-in App Engine Maven crée un répertoire target/appengine-staging approprié contenant vos artefacts JAR et ce fichier app.yaml, prêt à être déployé.

Voici un exemple de structure de projet Maven :

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

Si votre répertoire de projet comporte plusieurs fichiers JAR ou si vous souhaitez spécifier un point d'entrée personnalisé, vous devez le spécifier dans l'élément entrypoint de votre fichier app.yaml.

Liste de tous les éléments de configuration

Pour obtenir la liste complète des éléments acceptés dans ce fichier de configuration, consultez la documentation de référence sur le fichier app.yaml.