定義執行階段設定

App Engine 應用程式是使用 app.yaml 檔案進行設定，當中包含執行階段、處理常式、資源調度，以及包含環境變數在內的其他一般設定。

app.yaml 檔案簡介

您可以在 app.yaml 檔案中指定 Java 應用程式的執行階段設定，包括版本和網址。這個檔案可做為特定服務版本的部署描述元。

如果您沒有建立 app.yaml 檔案，gcloud app deploy 指令可以在部署應用程式時建立檔案。App Engine 建立的 app.yaml 檔案只包含執行應用程式所需的設定。

一般來說，app.yaml 檔案只需要 runtime 元素，即可在標準環境中執行簡易的 Java 應用程式，例如：

runtime: java21

App Engine 會為所有其他設定提供預設值，包括用於決定應用程式可用的記憶體和 CPU 資源的 F1 執行個體類別，以及用於控制建立應用程式新執行個體的方式和時機的自動調整。

如果您需要覆寫預設設定，請建立 app.yaml 檔案並指定所需設定。詳情請參閱 app.yaml 檔案參考資料。

您可以為 app.yaml 檔案指定不重複的名稱，但稍後必須一併使用部署指令指定檔案名稱。舉例來說，如果您將 app.yaml 檔案命名為 service-name-app.yaml 或 app.standard.yaml，就必須使用下列其中一種方式來部署應用程式：

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

如要進一步瞭解如何在應用程式中建構多個服務和 app.yaml 檔案，請參閱「建構網路服務」一文。

對於 Maven 專案，app.yaml 檔案的標準位置位於 src/main/appengine 目錄下方。App Engine Maven 外掛程式會建立正確的 target/appengine-staging 目錄，其中包含 JAR 構件和這個 app.yaml 檔案，可供部署。

以下是 Maven 專案結構範例：

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

如果專案目錄中有一個以上的 JAR 檔案，或是您想指定自訂進入點，則必須在 app.yaml 檔案的 entrypoint 元素中指定該項目。

所有設定元素

如需這個設定檔中所有支援元素的完整清單，請參閱 app.yaml 參考資料。