App Engine app.yaml 參考資料

區域 ID

REGION_ID 是 Google 根據您在建立應用程式時選取的地區所指派的簡寫代碼。雖然某些區域 ID 可能看起來與常用的國家/地區代碼相似，但此代碼並非對應國家/地區或省份。如果是 2020 年 2 月後建立的應用程式，App Engine 網址會包含 REGION_ID.r。如果是在此日期之前建立的現有應用程式，網址中則可選擇加入地區 ID。

進一步瞭解區域 ID。

您可以在 app.yaml 檔案中設定 App Engine 應用程式的設定。這個檔案是用來指定網址路徑對應到要求處理常式和靜態檔案的方式。app.yaml 檔案也包含應用程式程式碼的資訊，例如執行階段和最新的版本 ID。

應用程式中的每個服務都有自己的 app.yaml 檔案，做為該服務的部署作業描述元。您必須先為應用程式中的 default 服務建立 app.yaml 檔案，才能為其他的服務建立並部署 app.yaml 檔案。

目錄結構

如要進一步瞭解如何在應用程式中建構多項服務，請參閱在 App Engine 中建構網路服務一文。

範例

以下是 PHP 5 應用程式的 app.yaml 檔案範例：

runtime: php55
api_version: 1

handlers:
# Serve images as static resources.
- url: /(.+\.(gif|png|jpg))$
  static_files: \1
  upload: .+\.(gif|png|jpg)$
  application_readable: true

# Serve php scripts.
- url: /(.+\.php)$
  script: \1

上述範例會提供副檔名為 gif、png 或 jpg 的檔案做為靜態資源。應用程式碼可在執行階段讀取這些經過設定的檔案。

這個範例還會提供所有 PHP 指令碼。您可以使用 url: /([^/]+\.php) 運算式，讓指令碼處理常式只處理根層級的指令碼。針對現有應用程式，建議模擬 Apache mod_rewrite $_GET['q'] 轉送。

以下列出更詳盡的 app.yaml 設定範例：

runtime: php55
api_version: 1

handlers:
- url: /
  script: home.php

- url: /index\.html
  script: home.php

- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: admin.php
  login: admin

- url: /.*
  script: not_found.php

語法

app.yaml 的語法採用 YAML 格式。

YAML 格式支援註解功能，因此系統會忽略以井字 (#) 字元開頭的行：

# This is a comment.

網址和檔案路徑模式會使用 POSIX 擴充規則運算式語法，但不包括對照元素和對照類別。系統支援對分組相符項目 (例如 \1) 的反向參照，也支援下列擴充項目：\w \W \s \S \d \D。

執行階段和應用程式元素

元素 說明
application

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

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

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

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

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

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

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

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

default_expiration

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

範例： 
runtime: php55
api_version: 1

default_expiration: "4d 5h"

handlers:
  # ...

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

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

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

示例： 
env_variables:
  MY_VAR: "my value"
 其中 MY_VAR 和 my value 是您要定義的環境變數名稱和值，且各個環境變數項目位在 env_variables 元素下方並縮排兩個空格。未指派值的環境變數預設為 "None"。

接著，您可以使用 getenv() 或 $_SERVER 擷取這些變數的值，但不得使用 $_ENV。下列指令可輸出環境變數 MY_VAR 的值：

echo getenv('MY_VAR');
 or 
echo $_SERVER['MY_VAR'];
error_handlers

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

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

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
handlers

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

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

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

可用的內送服務如下：

mail
可讓應用程式接收郵件。
warmup
啟用暖機要求。請參閱設定暖機要求。
示例： 
inbound_services:
  - mail
  - warmup
instance_class

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

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

自動調整資源配置
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 元素。
module

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

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

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

runtime: php55
service

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

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

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

範例：
service: service-name

附註：gcloud app deploy 指令有回溯相容性，且支援包含已宣告為模組之服務的 app.yaml 檔案，例如：

module: service-name
service_account

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

範例：
service_account: [SERVICE_ACCOUNT_NAME]@[PROJECT_ID].iam.gserviceaccount.com
skip_files

選用元素。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/
version

我們建議您移除 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變更提供流量的應用程式版本，也可以在將其他版本設為接收流量前先測試這些版本。

處理常式元素

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

系統會依照模式在 app.yaml 檔案中的出現順序，從上到下來評估模式。而第一個符合網址的對應模式，就會用來處理要求。

下列表格列出 handlers 元素的子元素，而這些子元素可控制指令碼、靜態檔案、靜態目錄和其他設定的行為。

元素 說明
application_readable (非必要) 布林值。根據預設，在靜態檔案處理常式中宣告的檔案會上傳做為靜態資料，且只會提供給使用者，無法讓應用程式讀取。如果將這個欄位設為 true，該檔案也會上傳成程式碼資料，因此就能讓應用程式讀取。這兩種上傳資料都會計入您的程式碼和靜態資料儲存空間資源配額。

這個欄位已在較新的 App Engine 執行階段淘汰。
expiration 選用。應該要讓該處理常式所提供的靜態檔案保留在網路 Proxy 和瀏覽器快取中的時間長度。這個值是由數字和單位 (以空格分隔) 組成的字串，其中單位可為 d (天數)、h (小時數)、m (分鐘數) 和 s (秒數)。舉例來說，"4d 5h" 會將快取到期時間設定為檔案首次收到要求後的 4 天又 5 小時。如果您省略這個值，系統會使用應用程序的 default_expiration。詳情請參閱「快取效期」。
http_headers

(非必要) 您可以針對靜態檔案或目錄處理常式的回應設定 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_type

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

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

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

301
「已永久移動」回應碼。
302
「已找到」回應碼。
303
「查看其他」回應碼。
307
「暫時重新導向」回應碼。
範例 
handlers:
- url: /youraccount/.*
  script: accounts.php
  secure: always
  redirect_http_response_code: 301

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

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

...
handlers:
- url: /profile/(.*)/(.*)
  script: /employee/\2/\1.php  # specify a script

在較新的 App Engine 執行階段中，這個欄位的行為已有所變更。
secure (非必要) 所有網址處理常式都可以使用 secure 設定，包括指令碼處理常式和靜態檔案處理常式。以下是 secure 可用的值：
optional
只要 HTTP 或 HTTPS 要求的網址符合處理常式，就能夠在不重新導向的情況下順利執行。應用程式可檢查要求來決定要使用哪個通訊協定，並依此做出回應。當您沒有提供 secure 給處理常式時，這就會是預設值。
never
如果要求的網址符合這個處理常式，且該要求使用 HTTPS，系統就會自動將該要求重新導向至對等的 HTTP 網址。當使用者的 HTTPS 要求遭到重新導向為 HTTP 要求時，要求中的查詢參數會遭到移除。這能避免讓使用者不小心透過不安全的連線提交應該要透過安全連線傳送的查詢資料。
always
如果要求的網址符合這個處理常式，且該要求沒有使用 HTTPS，系統就會自動將該要求重新導向至相同路徑的 HTTPS 網址。而系統會保留查詢參數，以便在重新導向時使用。
範例 
handlers:
- url: /youraccount/.*
  script: accounts.php
  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 帳戶的登入和登出作業永遠都是使用安全連線來進行，與應用程式的網址設定方式無關。
static_dir

(非必要) 從應用程式根目錄到靜態檔案所屬目錄的路徑。相符的 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_files

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

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

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

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

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

static_dir
會使用網址前置字串。當規則運算式模式與 static_dir 元素搭配使用時，不應該包含分組。以這個前置字串開頭的所有網址都會由這個處理常式處理，該處理常式會把網址中位於前置字串之後的部分當做檔案路徑的一部分。
static_files
靜態檔案模式處理常式會建立網址模式與隨應用程式上傳的靜態檔案路徑之間的關聯。網址模式規則運算式可定義規則運算式的分組，以用來建構檔案路徑。您可以在不用對應整個目錄的情況下使用這個方法，而不是使用 static_dir 對應到目錄結構中的特定檔案。

資源調度元素

下表中的元素會設定應用程式的資源調度方式。如要進一步瞭解 App Engine 應用程式的資源調度方式，請參閱「資源調度類型」。

元素 說明
automatic_scaling

(非必要) 僅適用於使用 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

(非必要) 在排程器產生新的執行個體前，自動調整資源配置的執行個體可接受的並行要求數量 (預設值為 5，最大值為 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
basic_scaling

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

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

max_instances
必要元素。指定 App Engine 為這個服務版本建立的執行個體數量上限，適合用來限制服務的成本。
idle_timeout
選用元素。指定執行個體收到最後要求後經過多久時間會關閉。預設值為 5 分鐘 (5m)。
範例 
basic_scaling:
  max_instances: 11
  idle_timeout: 10m
manual_scaling

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

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

instances
一開始指派給服務的執行個體數量。
示例 
manual_scaling:
  instances: 5