本文列出 Cloud Build 適用的配額和系統限制。
- 配額會指定您可使用的可計數共用資源數量。配額是由 Cloud Build 等 Google Cloud 服務定義。
- 系統限制是固定值，無法變更。
Google Cloud 會使用配額來確保公平性，並減少資源使用量和可用性突然暴增的情況。配額會限制專案可使用的Google Cloud 資源 Google Cloud 數量。配額適用於各種資源類型，包括硬體、軟體和網路元件。舉例來說，配額可以限制對服務發出的 API 呼叫數、專案並行使用的負載平衡器數量，或是可建立的專案數量。配額可以預防服務過載，進而保障Google Cloud 使用者社群的權益。配額也能協助您管理自己的 Google Cloud 資源。
Cloud Quotas 系統會執行下列操作：
在大多數情況下，如果您嘗試使用的資源超過配額，系統會封鎖資源存取權，導致您嘗試執行的工作失敗。
配額通常是在 Google Cloud 專案 層級套用。在一個專案中使用資源，不會影響另一個專案的可用配額。在 Google Cloud 專案中，所有應用程式和 IP 位址會共用配額。
詳情請參閱 Cloud Quotas 總覽。如要調整大部分配額，請使用 Google Cloud 控制台。詳情請參閱「要求調整配額」。
Cloud Build 資源也有系統限制。 系統限制無法變更。
配額
基於各種原因，Cloud Build 會對執行中的建構作業實施配額限制。舉例來說，限制配額可以預防用量突然暴增的情況，進而保障 Google Cloud使用者社群的權益。 Google Cloud 也提供免費試用配額，讓使用者能透過專案免費試用部分 Google Cloud 功能。
根據預設，每項Google Cloud 專案皆適用以下 Cloud Build 配額。不過，專案配額取決於用量，且可能會隨時間而異。
| 資源 | 說明 | 預設限制 | 是否可增加 | 範圍 |
|---|---|---|---|---|
| C3 CPU | 在區域私人集區中執行的並行 C3 CPU 數量 | 0* - 300 | 可以。在專案達到配額上限之後，系統會將其他 CPU 要求排入佇列，並依序處理。 | 每個地區 |
| CPU | 在區域私人集區中執行的並行 E2 CPU 數量 | 0* - 2400 | 可以。在專案達到配額上限之後，系統會將其他 CPU 要求排入佇列，並依序處理。 | 每個地區 |
| N2D CPU | 在區域私人集區中執行的並行 N2D CPU 數量 | 0* - 2400 | 可以。在專案達到配額上限之後，系統會將其他 CPU 要求排入佇列，並依序處理。 | 每個地區 |
| CPU (預設) | 在區域預設集區中執行的並行 CPU 數量 | 5 到 100 | 不行。如需超過 100 個並行 CPU，請使用私人集區。 | 每個地區 |
| 建構 | 在全球預設集區中執行的並行建構數量 | 10 - 30 | 否。如要執行超過 30 項並行建構作業，請使用私人集區。 | 全球 |
*視專案和用量而定，您可能沒有使用私人集區的配額。 如果是這種情況，您可以使用預設集區。
API 頻率限制
API 頻率限制會影響您呼叫 Cloud Build API 的頻率。如要查看及編輯 API 使用頻率限制，請前往「配額」頁面。
資源限制
Cloud Build 會對資源強制實行以下限制：
| 限制 | |
|---|---|
args 值 (每個建構步驟) |
100 |
| 每個建構作業的建構步驟 | 300 |
| 每個建構作業的建構映像檔 | 700 |
env 值 (每個建構步驟) |
100 |
arg 值的長度 |
10,000 個字元 |
| 建構步驟 name 的長度 | 1000 個半形字元 |
dir 值的長度 |
1000 個半形字元 |
env 值的長度 |
65536 個半形字元 |
| 每個建構版本的標記清單長度 | 64 |
| 每個建構作業的構件路徑數量 | 100 |
| 自動建構觸發條件數量 | 600 |
| 替代的參數數量 | 200 |
secret 的大小 |
65536 個半形字元 |
每個建構版本的專屬 secretEnv 值 |
100 |
提高配額
開啟「Cloud Build Quotas」(Cloud Build 配額) 頁面。
選取要修改的配額，然後按一下「編輯配額」。
為所選配額輸入新的配額上限。
按一下 [提交要求]。