建立提取佇列

Go Java PHP Python

本頁說明如何建立提取佇列。您必須先建立佇列才能將工作新增到佇列中。本頁也會說明如何暫停或刪除佇列。

透過 queue.yaml 定義佇列

您可以使用應用程式的 queue.yaml 檔案定義提取佇列。這個程序跟建立具名發送佇列相同，只不過您必須在檔案中新增專屬指令 mode: pull。

queue:
- name: my-queue-name
  mode: pull

使用 gcloud CLI gcloud 指令上傳檔案。

gcloud app deploy queue.yaml

注意： 如果您使用服務帳戶管理驗證，以部署佇列設定檔，該帳戶必須具備 serviceusage.services.list 權限。您可以透過 serviceusage.serviceUsageViewer 角色新增這項權限，也可以建立具有這項權限的自訂角色。

注意： 您也可以使用 Cloud Tasks API 直接提供的佇列管理方法，管理 Task Queue 服務的佇列建立作業，但混合使用 queue.yaml 上傳方法和佇列管理方法可能會產生非預期的結果，因此我們不建議您採取這樣的做法。詳情請參閱佇列管理和 queue.yaml 總覽。另請注意，透過 gcloud CLI 上傳 queue.yaml 檔案時，如果使用的版本低於 332.0.0，系統會使用已淘汰的服務介面。自 2022-09-20起，嘗試使用上傳方法可能會失敗並出現伺服器錯誤。如要解決這個問題，請確認專案已啟用 Cloud Tasks API，且 gcloud CLI 已更新至至少 332.0.0 版。

停用佇列

如要停用或暫停佇列，請從佇列設定檔中移除其定義，然後上傳更新後的檔案。

上傳更新檔案後，佇列會設為「已停用」且費率會設為 0。系統不會處理佇列中的任何工作或新增至佇列的新工作。您可以上傳已定義佇列的新佇列檔案來重新啟用已停用的佇列。

您也可以透過 Google Cloud 控制台中的「Cloud Tasks」頁面暫停佇列。

刪除佇列

如要刪除佇列，您必須先停用該佇列：

1. 從佇列設定檔中移除佇列定義。

2. 上傳已變更的檔案。

   gcloud app deploy queue.yaml
   

停用佇列後，請使用 Google Cloud 控制台刪除該佇列。

1. 在 Google Cloud 控制台選取佇列。

   前往 Cloud Tasks

2. 按一下 [Delete queue] (刪除佇列)。

從 Google Cloud 控制台刪除佇列後，您必須等待 7 天，才能重新建立相同名稱的佇列。

重要事項： 本機開發伺服器 (dev_appserver) 不支援提取佇列。如要測試提取佇列，並確保設定檔內的詳細資料正確無誤，您必須將佇列設定檔推送到 App Engine 的測試環境。

後續步驟

瞭解如何建立工作。