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