本頁說明如何建立和自訂發送佇列,以及如何檢查佇列內容。
使用佇列設定檔建立佇列
如要處理工作,您必須將其新增至發送佇列。App Engine 提供名為 default 的預設發送佇列,已設定完畢,可直接使用預設設定。您可以視需要將所有工作新增至預設佇列,不需建立及設定其他佇列。
如要新增佇列或變更預設設定,請編輯您上傳至 App Engine 的應用程式佇列設定檔。最多可建立 100 個佇列。無法以動態方式建立佇列。
這個佇列設定檔定義兩種佇列:
queue:
- name: queue-blue
target: v2.task-module
rate: 5/s
- name: queue-red
rate: 1/s
如要上傳檔案:
gcloud app deploy queue.yaml
所有新增至 queue-blue 的工作都會傳送至目標模組 v2.task-module。queue-red 的重新整理頻率已從每秒 5 次變更為每秒 1 次。工作將會從佇列中移除,並以每秒 1 項工作的速率傳送至其目標。
如果您刪除某個佇列,必須等待 7 天左右才能再建立名稱相同的新佇列。
您還可以將許多其他參數新增至設定檔,以自訂發送佇列的行為。詳情請參閱佇列設定檔參考資料。
定義發送佇列處理速率
您可以定義其他指令,例如 rate、bucket_size 和 max_concurrent_requests,控制各個佇列處理工作的速率。
工作佇列會使用權杖 bucket 控制工作執行速率。每個具名佇列都有一個權杖 bucket,用於存放權杖,最多可達 bucket_size 指定的上限,如果未指定 bucket 大小,則最多可存放 5 個權杖。
應用程式每次執行工作時,系統就會從值區中移除一個權杖。應用程式會繼續處理佇列中的工作,直到佇列的 bucket 權杖用盡為止。App Engine 會根據您為佇列指定的 rate,持續在值區中填入新的權杖。
如果佇列包含要處理的工作,且佇列的 bucket 包含權杖,App Engine 會同時處理與權杖數量相同的工作。這可能會導致處理作業突然增加,消耗系統資源,並與使用者服務要求競爭。
如要避免一次執行太多工作,或避免資料儲存庫爭用,請使用 max_concurrent_requests。
以下範例說明如何設定 max_concurrent_requests 來限制工作,以及如何根據應用程式的需求和可用資源調整 bucket 大小和速率:
queue:
- name: queue-blue
rate: 20/s
bucket_size: 40
max_concurrent_requests: 10
設定所有佇列的儲存空間限制
您可以使用佇列設定檔來定義工作資料在所有佇列中能夠佔用的總儲存空間量。如要定義總儲存空間上限,請在頂層加入名為 total_storage_limit 的元素:
# Set the total storage limit for all queues to 120MB
total_storage_limit: 120M
queue:
- name: queue-blue
rate: 35/s
這個值是數字加上單位:B 代表位元組,K 代表 KB,M 代表 MB,G 代表 GB,T 代表 TB。例如,100K 指定的限制為 100 KB。如果新增工作會導致佇列超出其儲存空間限制,則新增工作的呼叫將會失敗。免費應用程式的預設限制為 500M (500 MB)。除非您明確設定,否則付費應用程式沒有限制。您可以使用這項限制,防止應用程式發生fork bomb程式設計錯誤,即每項工作在執行期間新增多項其他工作。
如果應用程式在新增工作時收到配額不足的錯誤訊息,提高總儲存空間限制可能會有所幫助。如果您使用這項功能,強烈建議您根據執行數天工作所需的儲存空間來設定限制。如此可以暫時備份佇列,並在處理待處理作業時繼續接受新工作,同時仍然可以防止發生 fork 炸彈程式設計錯誤。
在 Google Cloud 控制台監控佇列
前往 Google Cloud 控制台的「Cloud Tasks」頁面。
請注意,如果前往 App Engine 的「Task queue」(工作佇列) 頁面,系統會引導您前往 Cloud Tasks 頁面。 Google Cloud 控制台的這項更新不會影響工作佇列的運作方式。
啟用 Cloud Tasks API。
進入 Cloud Tasks 頁面後,您會看到應用程式中所有佇列的清單。按一下佇列名稱,即可開啟「Queue Details」(佇列詳細資料) 頁面,其中會顯示所選佇列中的所有工作。
後續步驟
瞭解如何建立工作。