Definizione delle impostazioni di runtime

Un'app di App Engine viene configurata utilizzando un file app.yaml, contenente il runtime, i gestori, la scalabilità e altre impostazioni generali, tra cui le variabili di ambiente.

Circa app.yaml file

Puoi specificare la configurazione di runtime per la tua app Java, inclusi versioni e URL, nel file app.yaml. Questo file funge da descrittore di deployment di una specifica versione di servizio.

Se non crei un file app.yaml, il comando gcloud app deploy può crearne uno quando esegui il deployment della tua applicazione. Il file app.yaml creato da App Engine contiene solo le impostazioni necessarie per eseguire l'applicazione.

In genere, il file app.yaml richiede solo l'elemento runtime per una semplice app Java nell'ambiente standard, ad esempio:

runtime: java21

App Engine fornisce valori predefiniti per tutte le altre impostazioni, inclusa la classe dell'istanza F1, che determina le risorse di memoria e CPU disponibili per la tua app, e la scalabilità automatica, che controlla come e quando vengono create nuove istanze dell'app.

Se devi eseguire l'override delle impostazioni predefinite, crea un file app.yaml e specifica le impostazioni necessarie. Per maggiori informazioni, vedi Riferimento ai file di app.yaml.

Puoi specificare un nome univoco per i tuoi file app.yaml, ma devi specificare anche il nome del file con il comando deployment. Ad esempio, se il nome del file app.yaml è service-name-app.yaml o app.standard.yaml, devi eseguire il deployment dell'app utilizzando:

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

Per scoprire di più sulla strutturazione di più servizi e file app.yaml nella tua app, vedi Strutturare i servizi web.

Per un progetto Maven, la posizione standard del file app.yaml si trova nella directory src/main/appengine. Il plug-in Maven di App Engine creerà una directory target/appengine-staging corretta contenente gli artefatti JAR e questo file app.yaml, pronto per il deployment.

Di seguito è riportata una struttura di esempio di un progetto Maven:

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

Se nella directory del progetto sono presenti più file JAR o se vuoi specificare un entry point personalizzato, devi specificarlo nell'elemento entrypoint del file app.yaml.

Tutti gli elementi di configurazione

Per un elenco completo di tutti gli elementi supportati in questo file di configurazione, consulta la documentazione di riferimento di app.yaml.