queue.yaml 參考資料

(非必要) 工作佇列會使用憑證區塊演算法控制工作執行的速率。每個已命名的佇列都有一個存放憑證的憑證區塊，其上限由 bucket_size 值指定。每次應用程式執行一項工作時，系統就會從區塊中移除一個憑證。您會繼續處理佇列中的工作，直到佇列的區塊中再也沒有憑證為止。App Engine 會依據您為佇列指定的速率，持續在區塊中補充新的憑證。

當佇列中有多個工作且處理速率相當高時，區塊大小會限制佇列的處理速度。區塊大小的最大值為 500，這可讓您享有高速率，能讓工作在排入佇列後立即開始處理，但短時間內若有許多工作排入佇列，也足以限制資源的使用量。

如果您未針對佇列指定 bucket_size，預設值為 5。建議您調高區塊大小值，因為預設值對許多用途而言可能過小。舉例來說，您可以根據處理速率決定值區大小。

如要進一步瞭解這項元素，請參閱 max_burst_size 的比較說明

選用元素。設定可從指定佇列同步執行的工作數量上限。此元素的值為整數。根據預設，每個佇列的上限是 1000 個工作。根據預設，每個佇列的建議上限是 5000 個工作。請注意，首次建立佇列或是將佇列閒置一段時間後，佇列數量可能會慢慢增加。

限制並行工作的數量可讓您進一步控制佇列的執行速率，避免一次執行過多工作。除此之外，也可以防止資料儲存庫發生爭用狀況，讓其他佇列或線上處理作業都可使用相關資源。

如要進一步瞭解這項元素，請參閱 Cloud Tasks API 參考資料中 max_concurrent_dises 的比較說明。

選用元素。用於識別佇列模式。這項設定的預設值為 push，也就是將佇列視為發送佇列。如果您想使用提取佇列，請將模式設為 pull。

必要元素。佇列的名稱。這是您在呼叫 QueueFactory.getQueue() 時指定的名稱。

佇列名稱可包含大寫和小寫字母、數字和連字號，長度上限為 100 個字元。

所有應用程式都有名稱為「default」的發送佇列。這個佇列的預設速率為每秒 5 個工作。請注意，這個預設佇列必須先使用或設定一次， Google Cloud console 才會顯示在 Google Cloud console 中。您可以在 queue.yaml 檔案中定義名為 `default` 的佇列，藉此設定預設佇列，包括變更預設速率。

必要元素。這個佇列處理工作的頻率。此值為後接斜線和時間單位的數字，其中單位是 s (秒)、m (分鐘)、h (小時) 或 d (天)。例如，5/m 這個值代表工作的處理速率為每分鐘 5 次。rate 的最大值是 500/s。

如果數字是 0 (例如 0/s)，佇列會被視為「已暫停」，且不會處理任何工作。

如要進一步瞭解這項元素，請參閱 Cloud Tasks API 參考資料中 max_dises_per_second 的比較說明。

選用元素。設定發送佇列中失敗工作的重試次數。新增這項元素可讓您指定在特定佇列中重試失敗工作的次數上限。您也可以設定重試的時間限制，以及控制每次重試的時間間隔。

重試參數可包含下列子元素：

task_retry_limit

重試次數。舉例來說，如果指定的數值為 0 且工作「失敗」，那麼系統完全不會「重試」工作。如果指定的數值為 1 且工作「失敗」，則系統會重試一次工作。如果未指定這項參數，系統會一直不斷重試這項工作。如果同時指定了 task_retry_limit 與 task_age_limit，系統則會一直重試這項工作，直到達到這兩個上限為止。

task_age_limit (發送佇列)

重試失敗工作的時間限制，從工作首次執行時開始算起。此值為後接時間單位的數字，其中單位是 s (秒)、m (分鐘)、h (小時) 或 d (天)。舉例來說，5d 這個值指定的限制為首次嘗試執行工作後的五天。如果未指定這項參數，系統會無限期重試工作。如果同時指定了 task_retry_limit，App Engine 會重試工作，直到達到這兩項上限為止。

min_backoff_seconds (發送佇列)

工作失敗後，等待重試的秒數下限。預設值為 0.1。

max_backoff_seconds (發送佇列)

工作失敗後等待重試的時間上限 (以秒為單位)。預設值為 3600。

max_doublings (發送佇列)

失敗工作重試間隔時間加倍遞增到常數之前，要將間隔時間加倍的次數上限。常數為：2**max_doublings * min_backoff_seconds。預設值為 16。

選用元素。針對執行排入此佇列的工作所用的服務/版本、前端版本或後端，指定這些服務或版本名稱的字串。預設值為空字串。

在建構工作的 HTTP 要求時，系統會在應用程式的網域名稱前面加上這個字串。舉例來說，如果應用程式 ID 為 my-app，而且您將目標設為 my-version-dot-my-service，網址主機名稱就會設為 my-version-dot-my-service-dot-my-app.REGION_ID.r.appspot.com。

如果未指定目標，則系統會在工作排入佇列所在的應用程式版本中叫用工作。因此，如果您將預設應用程式版本的工作排入佇列，但不指定佇列上的目標，則會在預設應用程式版本中叫用該工作。請注意，在工作排入佇列的時間與執行工作的時間之間，如果您變更預設應用程式版本，工作將會在新的預設版本中執行。

如果您將服務與分派檔案搭配使用，工作的 HTTP 要求可能會遭到攔截並重新轉送至其他服務。

選用元素。覆寫工作佇列儲存空間預設配額上限 (100 M) 的字串。例如：

total_storage_limit: 1.2G
queue:
  - name: fooqueue

這個配額包含在應用程式的總儲存空間配額中 (包括資料儲存庫和 Blobstore 配額)。

如未指定前置字串，系統會將您指定的數字解讀為位元組。支援的前置字串如下：

• B (位元組)
• K (KB)
• M (MB)
• G (GB)
• T (TB)

如果 total_storage_limit 超過應用程式可用的總磁碟儲存空間，則上限值即為可用的儲存空間。