Definizione delle impostazioni di runtime

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

Informazioni sui file app.yaml

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

Se non crei un file app.yaml, il comando gcloud app deploy può crearne uno quando esegui il deployment della 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, tra cui la classe di istanze F1, che determina le risorse di memoria e CPU disponibili per l'app, e il ridimensionamento automatico, che controlla come e quando vengono create nuove istanze dell'app.

Se devi sostituire le impostazioni predefinite, crea un file app.yaml e specifica le impostazioni necessarie. Per ulteriori informazioni, consulta il riferimento del file app.yaml.

Puoi specificare un nome univoco per i file app.yaml, ma devi anche specificare il nome del file con il comando di deployment. Ad esempio, se assegni al file app.yaml il nome 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, consulta la sezione 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 elementi JAR e questo file app.yaml, pronti per il deployment.

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

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 vuoi specificare un punto di contatto personalizzato, devi farlo 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.