App Engine app.yaml 參考資料

我們建議您移除 app.yaml 檔案中的 application 元素，改用指令列標記來指定應用程式 ID：

• 如要使用 gcloud app deploy 指令，您必須指定 --project 標記：

  gcloud app deploy --project [YOUR_PROJECT_ID]

如要進一步瞭解如何使用這些指令，請參閱部署應用程式的相關說明。

應用程式 ID 是您在 Google Cloud console中建立應用程式時指定的 Google Cloud 控制台專案 ID。

必要元素。應用程式使用的特定執行階段環境中的 API 版本。

這個欄位已在較新的 App Engine 執行階段淘汰。

當 Google 宣布要支援執行階段環境中 API 的新版本時，已部署的應用程式還是會繼續使用已編寫在設定檔中的 API 版本。如要將應用程式升級來使用新的 API 版本，請變更這個值，然後將應用程式重新部署至 App Engine。如果您將這個值指定為 1，每當您部署該應用程式時，系統就會使用受支援的最新執行階段環境 (目前為 )。

目前 App Engine 有一個版本的 python27 執行階段環境：1

default

預設值。會使用分散的自動 ID；這些 ID 是分布均勻的大型整數，且整數小到足以由 64 位元浮點數表示。

legacy

舊版選項會在日後推出的版本中遭到淘汰，最終會遭到移除。詳情請參閱宣布該變更的網誌文章。

選用元素。Python 2 SDK 包含了幾個用於一般應用程式函式的內建處理常式。而 builtins 指令可讓您在 app.yaml 中納入特定的處理常式。

這個欄位已在 Python 3 執行階段淘汰。

以下是您可以使用的內建處理常式：

appstats

啟用位於 /_ah/stats/ 的 Appstats，可用於測量應用程式的效能。但您必須要安裝事件記錄器，才能夠使用 Appstats。

deferred

啟用位於 /_ah/queue/deferred 的延遲處理常式。這內建項目可讓開發人員使用 deferred.defer() 來簡化工作佇列的工作建立作業。

remote_api

啟用位於 /_ah/remote_api/ 的 remote_api 內建項目。這個內建項目可讓擁有適當憑證的遠端應用程式從遠端存取資料儲存庫。

builtins:
- deferred: on
- appstats: on

builtins 指令是 includes 指令的特殊執行個體。在 Python 中，每個 builtin 指令都等同於擁有擴充路徑的 includes 指令。舉例來說：

builtins:
- name: on

等同於：

includes:
- $PYTHON_LIB/google/appengine/ext/builtins/name/

當您在 app.yaml 檔案中使用 builtins 時，於內建的 include.yaml 檔案中定義的任何處理常式都將取代您在 app.yaml 檔案中所定義的任何處理常式。然而，如果您納入會使用 builtins 或 includes 的檔案，系統就會依照 includes 階層的順序來新增處理常式。換句話說，系統會先新增「父項」includes 的處理常式，然後才是「子項」includes 的內建項目，以此類推。

舉例來說，假設下列 app.yaml 使用內建的 appstats 處理常式：

handlers:
- url: /.*
  script: main.app
builtins:
- appstats: on

處理常式的結果清單為：

[/_ah/stats, /.*]

如果 app.yaml 使用 includes 指令：

includes:
- included.yaml

且 included.yaml 檔案使用 builtins：

handlers:
- url: /.*
  script: main.app
builtins:
- appstats: on

處理常式的結果清單現在會是：

[/.*, /_ah/stats]

builtins 子句在 .yaml 檔案中的位置順序並不會改變這個行為。

(非必要) 會針對應用程式的所有靜態檔案處理常式，設定全域的預設快取有效期限。您也可以設定特定靜態檔案處理常式的快取效期。這個值是由數字和單位 (以空格分隔) 組成的字串，其中單位可為 d (天數)、h (小時數)、m (分鐘數) 和 s (秒數)。舉例來說，"4d 5h" 會將快取有效期限設定為檔案首次收到要求後的 4 天又 5 小時。如果您省略這個值，實際工作環境伺服器會把有效期限設定為 10 分鐘。

runtime: python27
api_version: 1
threadsafe: true

default_expiration: "4d 5h"

handlers:
# ...

詳情請參閱「快取效期」。

選用元素。您可以在 app.yaml 檔案中定義環境變數，以供應用程式使用。請確認環境變數中的鍵值符合運算式「[a-zA-Z_][a-zA-Z0-9_]*」(開頭為英文字母或「_」，後面接任何英數字元或「_」)。

開頭為 GAE 的環境變數已保留給系統使用，無法用於 app.yaml 檔案中。

env_variables:
  DJANGO_SETTINGS_MODULE: "myapp.settings"

選用元素。用來設定自訂的錯誤頁面，讓系統能針對不同的錯誤類型傳回。

這個元素可包含下列元素：

error_code

選用元素。error_code 可以是下列其中一個：

over_quota

表示應用程式已 超出資源配額上限。

timeout

如果應用程式沒有在到期之前回應，系統就會提供這個元素。

error_code 為選用元素；如果您沒有指定，則指定檔案就會是應用程式的預設錯誤回應。

file

每個檔案項目都代表一個要取代一般錯誤回應的靜態檔案。如果您指定的 file元素沒有對應的 error_code 元素，靜態檔案就會成為應用程式的預設錯誤頁面 自訂的錯誤資料必須小於 10 KB。

error_handlers:
  - file: default_error.html

  - error_code: over_quota
    file: over_quota.html

必要元素。會列出網址模式，以及這些網址模式的處理方式說明。App Engine 處理網址的方式有兩種，一種是執行應用程式的程式碼，另一種則是提供隨程式碼上傳的靜態檔案，例如圖片、CSS 或 JavaScript。

請參閱處理常式和子元素語法

選用元素。includes 指令可讓您在應用程式的任何地方納入任何程式庫或服務的設定檔。舉例來說，您可以納入使用者管理程式庫，如下所示：

includes:
- lib/user_admin.yaml

App Engine 會依照下列順序解析已納入的路徑：

• 工作目錄的絕對或相對路徑。指定路徑會解析為檔案。
• 與應用程式的目錄 (又稱為「basepath」) 相對的路徑。basepath 和路徑都會解析為檔案。
• 與包含目前檔案的檔案相對的路徑。參考檔案的位置和 include 路徑都會解析為已納入檔案。

如果 include 指令指定了某目錄，App Engine 就會查看該目錄來尋找名為 include.yaml 的檔案如果 include 指令是檔案，系統就會納入這個特定的檔案。使用 includes 只會從目的地檔案中擷取以下類型的指令 (如果有的話)：

• builtins
• includes
• handlers
• skip_files

已納入的 skip_files 模式會新增到所納入 app.yaml 中的模式，或是新增到預設清單中，但前提是 app.yaml 中沒有明確的清單。請注意，skip_files 會比較絕對路徑。

選用元素。應用程式必須先啟用這些服務，才能讓這些服務接收內送要求。您可以啟用 Python 2 應用程式的服務，方法是在 app.yaml 檔案中加入 inbound_services 區段。

可用的內送服務如下：

mail

可讓應用程式接收郵件。

warmup

啟用暖機要求。請參閱設定暖機要求。

inbound_services:
  - mail
  - warmup

選用元素。該服務的執行個體類別。

視您服務的資源調度方式而定，可用的值如下：

自動調整資源配置

F1、F2、F4、F4_1G

預設值： F1

您可以選擇使用 automatic_scaling 元素，變更自動調度資源的預設設定，例如執行個體數目的下限與上限、延遲時間和並行連線數。

注意：如果 instance_class 設為 F2 以上的值，您可以將 max_concurrent_requests 設為大於預設值 10 的值，藉此對執行個體進行最佳化。如要找出最適合的值，請逐步提高該值，並監控應用程式的效能。

基本與手動資源調度

B1、B2、B4、B4_1G、B8

預設值： B2

基本和手動執行個體類別需要您指定 basic_scaling 元素或 manual_scaling 元素。

選用元素。Python 2.7 執行階段包含幾個第三方程式庫。在這些程式庫中，有些程式庫是預設可使用的，但有些則需要經過設定才能使用。您可以藉由指定 name 和 version 值，來指定要使用的版本。

這個欄位已在 Python 3 執行階段淘汰。

libraries:
- name: PIL
  version: "1.1.7"
- name: webob
  version: "latest"
        

如需已納入的第三方程式庫清單，請參閱第三方程式庫。如要使用其他只採用 Python 的第三方程式庫，請將該程式庫安裝到本機目錄。

如果您正在使用彈性環境，請參閱在彈性環境中使用 Python 程式庫。

注意：「模組」現在稱為「服務」。

如要透過 gcloud CLI 管理應用程式，請改用 service 元素。

這是必要旗標，應用程式使用的執行階段環境名稱。例如，如要指定 Python 2.7，請使用：

runtime: python27

「服務」先前稱為「模組」。

僅由 gcloud CLI 或以 gcloud CLI 為基礎的外掛程式提供支援，例如：gcloud app deploy 。

如要建立服務，這就是必要元素。如要使用 default 服務，這就是選用元素。每個服務和每個版本都必須要有名稱。名稱可包含數字、字母和連字號，VERSION-dot-SERVICE-dot-PROJECT_ID 的總長度不得超過 63 個字元，且開頭或結尾不得使用連字號。其中 VERSION 是版本名稱、SERVICE 是服務名稱，而 PROJECT_ID 是專案 ID。請為各項服務和每個版本選擇不重複的名稱，不要以相同名稱為服務和版本命名。

service: service-name

module: service-name

(非必要) service_account 元素可讓您指定使用者自行管理的服務帳戶做為版本的身分。系統會在存取其他 Google Cloud 服務和執行工作時使用指定的服務帳戶。

service_account: [SERVICE_ACCOUNT_NAME]@[PROJECT_ID].iam.gserviceaccount.com

選用元素。skip_files 元素會指定應用程式目錄中哪些檔案不要上傳到 App Engine。這個元素的值可以是單一規則運算式，或是規則運算式清單。當您上傳應用程式時，系統會忽略檔案清單中與任一規則運算式相符的所有檔案名稱。檔案名稱採用相對於專案目錄的形式。

skip_files 有下列的預設值：

skip_files:
- ^(.*/)?#.*#$
- ^(.*/)?.*~$
- ^(.*/)?.*\.py[co]$
- ^(.*/)?.*/RCS/.*$
- ^(.*/)?\..*$

預設模式會排除下列檔案：名稱格式為 #...# 和 ...~ 的 Emacs 備份檔案、.pyc 和 .pyo 檔案、在 RCS 修訂控制目錄中的檔案，以及名稱開頭為點號 (.) 的 Unix 隱藏檔案。

如要擴充上述規則運算式清單，請複製上述清單並貼到 app.yaml 中，然後新增您自己的規則運算式。舉例來說，如果您除了預設模式之外，還要略過名稱結尾是 .bak 的檔案，請在 skip_files 區段新增如下的項目：

skip_files:
- ^(.*/)?#.*#$
- ^(.*/)?.*~$
- ^(.*/)?.*\.py[co]$
- ^(.*/)?.*/RCS/.*$
- ^(.*/)?\..*$
- ^(.*/)?.*\.bak$

如要略過整個目錄，請將該目錄名稱新增到清單中。舉例來說，如要略過名為 logs 的目錄，請將下列這行指令新增到前述指令中：

skip_files:
- logs/

必要元素。可設定讓應用程式使用並行要求。如果您使用 Python 的執行緒程式庫，系統會在每次處理要求之後清除由 threading.local() 傳回的執行緒本機資料。

這個欄位已在 Python 3 執行階段淘汰。

threadsafe: [true | false]

注意：Python 2.7 應用程式必須要使用 threadsafe 指令。threadsafe: true 要求所有指令碼處理常式都必須是 WSGI 處理常式。也就是說，每個指令碼都必須在 script: 指令中指定，且必須使用以點號分隔套件名稱的 Python 模組路徑。使用 Python 模組路徑的 script: 指令的最後一個部分，就是 service: 中某個全域變數的名稱，而該變數必須是 WSGI 應用程式 (依照慣例通常稱為 app)。

我們建議您移除 app.yaml 檔案中的 version 元素，並改用指令列標記來指定版本 ID：

• 如要使用 gcloud app deploy 指令，您必須指定 -v 標記：

  gcloud app deploy -v [YOUR_VERSION_ID]

如要進一步瞭解如何使用這個指令，請參閱「 部署應用程式」。

您部署到 App Engine 的應用程式程式碼的版本 ID。

版本 ID 可包含小寫字母、數字和連字號，但開頭不能是 ah-，且不能使用保留名稱 default 和 latest。

注意：請在版本名稱的開頭使用字母，以便與永遠都以數字指定的執行個體有所區別。這樣一來，123-dot-my-service.uc.r.appspot.com 之類的網址就不會產生歧異；這個網址有兩種解讀方式：如果版本「123」確實存在，目標就會是指定服務的「123」版本。如果該版本不存在，則目標會是服務預設版本的第 123 號執行個體。

每個應用程式版本都會保留自己的 app.yaml 副本。當您上傳應用程式時，在上傳的 app.yaml 檔案中提及的版本，就是因上傳作業而建立或取代的版本。管理員可以使用 Google Cloud console變更提供流量的應用程式版本，也可以在將其他版本設為接收流量前先測試這些版本。

選用元素。將您的應用程式設定為使用無伺服器的虛擬私人雲端存取連接器，讓該應用程式能夠將要求傳送至虛擬私人雲端網路中的內部資源。詳情請參閱「連線至虛擬私有雲網路」。

name

字串常值。請在引號中指定無伺服器虛擬私有雲存取連接器的完整名稱：

"projects/PROJECT_ID/locations/REGION/connectors/CONNECTOR_NAME"

egress_setting

選用。預設值為 private-ranges-only。egress_setting 可以是下列任一值：

private-ranges-only

預設值。傳送至內部 IP 位址的要求會透過無伺服器虛擬私人雲端存取連接器傳送至已連結的 VPC 網路。傳送至外部 IP 位址的要求會傳送至公開網際網路。

all-traffic

所有要求都會透過 Serverless VPC Access 連接器傳送至已連結的虛擬私有雲網路。

vpc_access_connector:
  name: "projects/PROJECT_ID/locations/REGION/connectors/CONNECTOR_NAME"
  egress_setting: all-traffic

這個欄位已在較新的 App Engine 執行階段淘汰。

(非必要) 您可以針對靜態檔案或目錄處理常式的回應設定 HTTP 標頭。如果您需要在 script 處理常式中設定 HTTP 標頭，請改為在應用程式的程式碼中進行設定。如要進一步瞭解哪些回應標頭會影響快取，請參閱「快取靜態內容」。

handlers:
- url: /images
  static_dir: static/images
  http_headers:
    X-Foo-Header: foo
    X-Bar-Header: bar value
    vary: Accept-Encoding
  # ...

CORS 支援

這個功能的重要用途之一，就是支援跨來源資源共享 (CORS)，例如存取另一個 App Engine 應用程式託管的檔案。

舉例來說，假設您有個遊戲應用程式 mygame.uc.r.appspot.com 會存取由 myassets.uc.r.appspot.com 代管的資產。不過，如果 mygame 嘗試向 myassets 提出 JavaScript XMLHttpRequest，這是不會成功的，除非 myassets 的處理常式傳回包含 http://mygame.uc.r.appspot.com 值的 Access-Control-Allow-Origin: 回應標頭。

如要讓靜態檔案處理常式傳回所需的回應標頭值，請使用以下指令：

handlers:
- url: /images
  static_dir: static/images
  http_headers:
    Access-Control-Allow-Origin: https://mygame.uc.r.appspot.com
  # ...

附註：如要讓每個人都能存取您的資產，請使用萬用字元 '*'，而不是 https://mygame.uc.r.appspot.com。

(非必要) 如有指定，這個處理常式將使用指定的 MIME 類型提供所有的檔案。如未指定，則檔案的 MIME 類型將衍生自檔案名稱的副檔名。如果您把同一個檔案以多個不同的副檔名上傳，則最後產生的副檔名可能會取決於上傳的順序。

如要進一步瞭解可用的 MIME 媒體類型，請瀏覽 IANA MIME 媒體類型網站

(非必要) redirect_http_response_code 必須與 secure 設定搭配使用，以便設定在執行由 secure 設定的設定方式所發出的重新導向要求時傳回的 HTTP 回應碼。以下是 redirect_http_response_code 元素可用的值：

301

「已永久移動」回應碼。

302

「已找到」回應碼。

303

「查看其他」回應碼。

307

「暫時重新導向」回應碼。

handlers:
- url: /youraccount/.*
  script: accounts.app
  login: required
  secure: always
  redirect_http_response_code: 301

當使用者的要求遭到重新導向時，系統會將 HTTP 狀態碼設定為 redirect_http_response_code 參數的值。如果這個參數不存在，系統會傳回 302。

選用。 指定從應用程式根目錄到指令碼的路徑：

handlers:
# The root URL (/) is handled by the WSGI application named
# "app" in home.py. No other URLs match this pattern.
- url: /
  script: home.app

# The URL /index.html is also handled by the home.py script.
- url: /index\.html
  script: home.app

# A regular expression can map parts of the URL to the
# path of the script.
- url: /browse/(books|videos|tools)
  script: \1.catalog.app

# All other URLs use the WSGI application named in "app"
# in not_found.py.
- url: /.*
  script: not_found.app

script: 指令必須為 Python 匯入路徑，例如指向 WSGI 應用程式的 package.module.app。使用 Python 模組路徑的 script: 指令的最後一個部分，就是 module: 中某個全域變數的名稱，而該變數必須是 WSGI 應用程式 (依照慣例通常稱為 app)。

附註：就跟 Python import 陳述式的情況一樣，如果子目錄是套件，就必須包含名為 __init__.py 的檔案。

在較新的 App Engine 執行階段中，這個欄位的行為已有所變更。

optional

只要 HTTP 或 HTTPS 要求的網址符合處理常式，就能夠在不重新導向的情況下順利執行。應用程式可檢查要求來決定要使用哪個通訊協定，並依此做出回應。當您沒有提供 secure 給處理常式時，這就會是預設值。

never

如果要求的網址符合這個處理常式，且該要求使用 HTTPS，系統就會自動將該要求重新導向至對等的 HTTP 網址。當使用者的 HTTPS 要求遭到重新導向為 HTTP 要求時，要求中的查詢參數會遭到移除。這能避免讓使用者不小心透過不安全的連線提交應該要透過安全連線傳送的查詢資料。

always

如果要求的網址符合這個處理常式，且該要求沒有使用 HTTPS，系統就會自動將該要求重新導向至相同路徑的 HTTPS 網址。而系統會保留查詢參數，以便在重新導向時使用。

handlers:
- url: /youraccount/.*
  script: accounts.app
  login: required
  secure: always

開發網路伺服器並不支援 HTTPS 連線，它會忽略 secure 參數，因此您可以利用連到開發網路伺服器的一般 HTTP 連線，來測試預計要搭配 HTTPS 使用的路徑。

如要使用 REGION_ID.r.appspot.com 網域 指定特定應用程式版本，請將通常用於分隔網址子網域部分的句點替換成「-dot-」字串，例如：
https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com

如要搭配 HTTPS 使用自訂網域，您必須先啟用並設定該網域的安全資料傳輸層 (SSL) 憑證。

Google 帳戶的登入和登出作業永遠都是使用安全連線來進行，與應用程式的網址設定方式無關。

(非必要) 從應用程式根目錄到靜態檔案所屬目錄的路徑。相符的 url 模式結尾後的所有內容都會附加到 static_dir 後方，以便形成所要求檔案的完整路徑。

靜態目錄中的每個檔案，都是使用與該檔案的副檔名對應的 MIME 類型來提供，除非該類型遭到目錄的 mime_type 設定覆寫。指定目錄中的所有檔案都會上傳成靜態檔案，無法當做指令碼來執行。

這個目錄中的所有檔案，都會隨著應用程式上傳成靜態檔案。App Engine 會將靜態檔案和應用程式的檔案分開儲存及提供。根據預設，靜態檔案不會出現在應用程式的檔案系統中，但您可以將 application_readable 選項設定為 true 來變更這個設定。

handlers:
# All URLs beginning with /stylesheets are treated as paths to
# static files in the stylesheets/ directory.
- url: /stylesheets
  static_dir: stylesheets
  # ...

(非必要) 靜態檔案模式處理常式會建立網址模式與隨應用程式上傳的靜態檔案路徑之間的關聯。網址模式規則運算式可定義規則運算式的分組，以用來建構檔案路徑。您可以在不用對應整個目錄的情況下使用這個方法，而不是使用 static_dir 對應到目錄結構中的特定檔案。

handlers:
# All URLs ending in .gif .png or .jpg are treated as paths to
# static files in the static/ directory. The URL pattern is a
# regular expression, with a grouping that is inserted into the
# path to the file.
- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$
  # ...

App Engine 會將靜態檔案和應用程式的檔案分開儲存及提供。根據預設，靜態檔案不會出現在應用程式的檔案系統中，但您可以將 application_readable 選項設定為 true 來變更這個設定。

靜態檔案不能與應用程式的程式碼檔案相同。如果靜態檔案路徑與動態處理常式所用的指令碼路徑相符，動態處理常式將無法使用該指令碼。

(非必要) 與這個處理常式將會參照的所有檔案之路徑相符的規則運算式。這是必要的，因為處理常式無法判斷應用程式目錄中的哪些檔案會與指定的 url 和 static_files 模式相對應。系統會將靜態檔案和應用程式檔案分開上傳及處理。上述範例可能會使用下列的 upload 模式：archives/(.*)/items/(.*)

handlers 下方的必要元素。做為規則運算式的網址模式。運算式可包含分組，且這些分組可透過規則運算式反向參照的方式，做為指令碼檔案路徑中的參照目標。舉例來說，/profile/(.*)/(.*) 會符合網址 /profile/edit/manager，且會把 edit 和 manager 當做第一個和第二個分組。

當網址模式與下列元素搭配使用時，該網址模式的行為會稍有不同：

static_dir

會使用網址前置字串。當規則運算式模式與 static_dir 元素搭配使用時，不應該包含分組。以這個前置字串開頭的所有網址都會由這個處理常式處理，該處理常式會把網址中位於前置字串之後的部分當做檔案路徑的一部分。

static_files

靜態檔案模式處理常式會建立網址模式與隨應用程式上傳的靜態檔案路徑之間的關聯。網址模式規則運算式可定義規則運算式的分組，以用來建構檔案路徑。您可以在不用對應整個目錄的情況下使用這個方法，而不是使用 static_dir 對應到目錄結構中的特定檔案。

(非必要) 僅適用於使用 F1 以上例項類別的應用程式。

指定這個元素，即可變更自動資源調度的預設設定，例如設定執行個體數量、延遲時間和服務並行連線的最低與最高層級。

這個元素可包含下列元素：

max_instances

選用元素。請指定介於 0 到 2147483647 之間的值；如果指定為 0，就會停用這個設定。

這項參數可指定 App Engine 為這個模組版本建立的執行個體數量上限，因此很適合用來限制模組的成本。

min_instances

選用。指定 App Engine 為這個模組版本建立的執行個體數量下限。這些執行個體會在收到要求時提供流量，且在系統已視需要啟動其他執行個體以處理流量之後，還是會繼續提供流量。

請指定介於 0 到 1000 之間的值。您可以將這項參數的值設為 0，允許系統進行資源調度時將執行個體數調整為 0，這麼一來，在沒有任何處理中的要求時，就能降低成本。請注意，系統是依指定的執行個體數量收費，與執行個體是否收到流量無關。

max_idle_instances

(非必要) App Engine 應為這個版本維持的閒置執行個體數量上限。請指定介於 1 到 1000 之間的值。如未指定，則預設值為 automatic，表示 App Engine 會管理閒置執行個體的數量。請注意以下幾點：

• 如果上限較高，當負載在暴增之後回到正常水準時，閒置執行個體數量的減少速率就會降低。這可協助應用程式在要求負載變動時維持穩定的效能，但也會在這種負載較重的時期提高閒置執行個體的數量 (進而提高執行成本)。
• 如果上限較低，就能降低執行成本，但在負載不穩定時，效能就可能會降低。

注意：在負載暴增結束並回到正常程度時，閒置執行個體的數量可能會暫時超出您指定的上限。不過，系統不會針對超出您指定數量上限的執行個體收費。

min_idle_instances

選用：這個版本要維持運作且可提供流量的額外執行個體數量。

App Engine 會根據 target_cpu_utilization 和 target_throughput_utilization 等調整設定，計算處理目前應用程式流量所需的執行個體數量。設定 min_idle_instances 時，除了計算出的數字外，還會指定要執行的執行個體數量。舉例來說，如果 App Engine 計算出需要 5 個執行個體才能處理流量，且 min_idle_instances 設為 2，App Engine 就會執行 7 個執行個體 (5 個，根據流量計算，再加上每個 min_idle_instances 額外增加 2 個)。

請注意，系統是依指定的執行個體數量收費，與執行個體是否收到流量無關。請注意以下幾點：

• 如果下限較低，閒置期間的執行成本就會降低，但這也代表在發生負載突然暴增的情況時，可立刻做出回應的執行個體數量會較少。

• 如果下限較高，應用程式就能應付要求負載暴增的情況。App Engine 會讓最低數量的執行個體保持運作，以處理傳入的要求。系統是依指定的執行個體數量收費，與執行個體是否在處理要求無關。

  如果您設定了閒置執行個體的數量下限，則等待延遲時間對應用程式效能造成的影響會比較小。

target_cpu_utilization

選用元素。請指定介於 0.5 到 0.95 之間的值，預設值為 0.6。

這項參數是用來指定 CPU 用量的臨界值，讓系統在該用量達到臨界值時啟動新的執行個體來處理流量，進而讓您可在效能和成本之間取得平衡。如果您把該值調低，效能和成本就會提高；如果您把這個值調高，效能和成本都會下降。舉例來說，如果值為 0.7，則代表系統會在 CPU 用量達到 70% 時啟動新的執行個體。

target_throughput_utilization

選用元素。請指定介於 0.5 到 0.95 之間的值，預設值為 0.6。

如果與 max_concurrent_requests搭配使用，可指定為因應並行要求而啟動新執行個體的時機。如果並行要求的數量達到 max_concurrent_requests 乘以 target_throughput_utilization 的值，排程器就會嘗試啟動新的執行個體。

max_concurrent_requests

(非必要) 在排程器產生新的執行個體前，自動調整資源配置的執行個體可接受的並行要求數量 (預設值為 10，最大值為 1000)。

如果與 target_throughput_utilization 搭配使用，可指定為因應並行要求而啟動新執行個體的時機。如果並行要求的數量達到 max_concurrent_requests 乘以 target_throughput_utilization 的值，排程器就會嘗試啟動新的執行個體。

除非您需要單執行緒，否則建議您不要將 max_concurrent_requests 設為小於 10。如果值小於 10，可能會導致建立的執行個體數量超過執行緒安全應用程式所需的數量，進而產生不必要的費用。

如果這項設定的值過高，API 的延遲時間可能會增加。請注意，排程器可能會在要求數量達到實際的上限之前，就產生新的執行個體。

max_pending_latency

指定 App Engine 在啟動額外的執行個體來處理要求以降低等待延遲時間前，最多應讓要求在待處理佇列中等候多久的時間。如果達到這個門檻，系統就會擴充資源，進而提高執行個體的數量。如未指定，則採用預設值 automatic。也就是說，系統會在觸發新執行個體之前，讓要求最多在 待處理的要求時間限制 (最多 10 秒) 內留在待處理佇列中。

如果上限較低，表示 App Engine 會較早啟動新的執行個體來解決待處理的要求；這可改善效能，但會提高執行成本。

如果上限較高，表示系統可能需要較久的時間才會處理使用者的要求 (如果有待處理的要求且沒有閒置的執行個體可處理要求時)，但應用程式的執行成本較低。

min_pending_latency

您可以設定這個選用元素，指定 App Engine 在啟動新的執行個體來處理要求前，應讓要求在待處理佇列中等候的最短時間。指定值可降低執行成本，但使用者必須等待較久的時間才能讓要求得到處理。

免費應用程式的預設值為 500ms。付費應用程式的預設值為 0。

這個元素會與 max_pending_latency 元素搭配運作，用於決定 App Engine 建立新例項的時間。如果待處理的要求在佇列中：

• 如果小於您指定的 min_pending_latency，App Engine 就不會建立新的例項。
• 超過 max_pending_latency 時，App Engine 會嘗試建立新的執行個體。
• 在 min_pending_latency 和 max_pending_latency 指定的時間之間，App Engine 會嘗試重複使用現有的執行個體。如果沒有任何執行個體能夠在 max_pending_latency 之前處理要求，App Engine 會建立新的執行個體。

automatic_scaling:
  target_cpu_utilization: 0.65
  min_instances: 5
  max_instances: 100
  min_pending_latency: 30ms
  max_pending_latency: automatic
  max_concurrent_requests: 50

使用 B1 以上版本例項類別的應用程式必須指定這個元素或 manual_scaling。

這個元素可啟用執行個體類別 B1 以上的基本縮放功能，可包含下列元素：

max_instances

必要元素。指定 App Engine 為這個服務版本建立的執行個體數量上限，適合用來限制服務的成本。

idle_timeout

選用元素。指定執行個體收到最後要求後經過多久時間會關閉。預設值為 5 分鐘 (5m)。

basic_scaling:
  max_instances: 11
  idle_timeout: 10m

使用 B1 以上版本例項類別的應用程式必須指定這個元素或 basic_scaling。

這個元素可啟用執行個體類別 B1 以上版本的手動資源調度功能，並可包含下列元素：

instances

一開始指派給服務的執行個體數量。

manual_scaling:
  instances: 5