這份文件列出 Cloud Build 適用的配額和系統限制。
- 「配額」有預設值，但通常可以申請調整。
- 「系統限制」是固定值，無法變更。
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 配額) 頁面。
選取要修改的配額，然後按一下「編輯配額」。
為所選配額輸入新的配額上限。
按一下 [提交要求]。