This document lists the quotas and limits that apply to Cloud Build.
A quota restricts how much of a particular shared Google Cloud resource your Google Cloud project can use, including hardware, software, and network components.
Quotas are part of a system that does the following:
- Monitors your use or consumption of Google Cloud products and services.
- Restricts your consumption of those resources for reasons including ensuring fairness and reducing spikes in usage.
- Maintains configurations that automatically enforce prescribed restrictions.
- Provides a means to make or request changes to the quota.
When a quota is exceeded, in most cases, the system immediately blocks access to the relevant Google resource, and the task that you're trying to perform fails. In most cases, quotas apply to each Google Cloud project and are shared across all applications and IP addresses that use that Google Cloud project.
To increase or decrease most quotas, use the Google Cloud console. For more information, see Request a higher quota limit.
There are also limits on Cloud Build resources. These limits are unrelated to the quota system. Limits cannot be changed unless otherwise stated.
Quotas
Cloud Build enforces quotas on running builds for various reasons. For example, quotas help to protect the community of Google Cloud users by preventing unforeseen spikes in usage. Google Cloud also offers free trial quotas that provide limited access for projects to help you explore Google Cloud on a free trial basis.
By default, the following Cloud Build quotas apply to each Google Cloud project. However, per-project quotas depend on usage and may vary over time.
| Resource | Description | Default limit | Can be increased | Scope |
|---|---|---|---|---|
| Private pool | Number of private pools | 2 - 10 | Yes | Per region |
| CPU | Number of concurrent CPUs
run in a regional private pool |
0 * - 2400 | Yes. When this quota is filled, requests for additional CPUs are queued and processed serially. | Per region |
| CPU | Number of concurrent CPUs
run in a regional default pool |
5 - 100 | No. If you require more than 100 concurrent CPUs, use private pools. | Per region |
| Request | Number of concurrent builds run in a global default pool |
10 - 30 | No. If you want to run more than 30 concurrent builds, consider using private pools. |
Global |
* Depending on your project and usage, you may not have quotas to use private pools. If this is the case, you can use default pools.
Region restrictions for some projects
Depending on the usage, certain projects may be restricted to only use Cloud Build in certain regions. For more information see Locations.
API rate limits
API rate limits affect the rate at which you can call the Cloud Build API. You can view and edit the API rate limits by going to the Quotas page.
Resource limits
Cloud Build enforces the following limits on resources:
| Limits | |
|---|---|
| Build steps per build | 300 |
| Length of the build step name | 1000 characters |
env values per build step |
100 |
Length of the env value |
65536 characters |
args values per build step |
100 |
Length of the arg value |
10000 characters |
Length of the dir value |
1000 characters |
| Built images per build | 200 |
Unique secretEnv values per build |
100 |
Size of a secret |
65536 characters |
| Number of build triggers | 300 |
| Number of artifacts paths per build | 100 |
| Length of the list of tags per build | 64 |
Increasing quota
Open the Cloud Build Quotas page.
Select the quota(s) you want to modify and click Edit quotas.
Enter the new quota limit for the quota you selected.
Click Submit request.