- NAME
-
- gcloud builds worker-pools create - create a worker pool for use by Google Cloud Build
- SYNOPSIS
-
-
gcloud builds worker-pools createWORKER_POOL[--region=REGION] [--config-from-file=CONFIG_FROM_FILE|--worker-disk-size=WORKER_DISK_SIZE--worker-machine-type=WORKER_MACHINE_TYPE--peered-network=PEERED_NETWORK--peered-network-ip-range=PEERED_NETWORK_IP_RANGE--no-public-egress] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Create a worker pool for use by Google Cloud Build.
- EXAMPLES
- To create a worker pool named
wp1in regionus-central1, run:gcloud builds worker-pools create wp1 --region = us-central1To create a worker pool in project
p1in regionus-central1where workers are of machine typee2-standard-2and are peered to the VPC networkprojects/123/global/networks/defaultwithin the IP range192.168.0.0/28and have a disk size of 64GB, run:gcloud builds worker-pools create wp1 --project = p1 --region = us-central1 --peered-network = projects/123/global/networks/default --peered-network-ip-range = 192 .168.0.0/28 --worker-machine-type = e2-standard-2 --worker-disk-size = 64GB - POSITIONAL ARGUMENTS
-
-
WORKER_POOL - Unique identifier for the worker pool to create. This value should be 1-63 characters, and valid characters are [a-z][0-9]-
-
- FLAGS
-
-
--region=REGION - Cloud region where the worker pool is created. See https://cloud.google.com/build/docs/locations for available locations.
- At most one of these can be specified:
-
--config-from-file=CONFIG_FROM_FILE - File that contains the configuration for the worker pool to be created. See https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema for options.
- Or at least one of these can be specified:
- Command-line flags to configure the private pool:
- Configuration to be used for creating workers in the worker pool:
-
--worker-disk-size=WORKER_DISK_SIZE - Size of the disk attached to the worker.
If unspecified, Cloud Build uses a standard disk size.
-
--worker-machine-type=WORKER_MACHINE_TYPE - Compute Engine machine type for a worker pool.
If unspecified, Cloud Build uses a standard machine type.
- Network configuration for Service Networking:
-
--peered-network=PEERED_NETWORK - Existing network to which workers are peered. The network is specified in
resource URL format projects/{network_project}/global/networks/{network_name}.
If not specified, the workers are not peered to any network.
-
--peered-network-ip-range=PEERED_NETWORK_IP_RANGE - An IP range for your peered network. Specify the IP range using Classless
Inter-Domain Routing (CIDR) notation with a slash and the subnet prefix size,
such as
/29.Your subnet prefix size must be between 1 and 29. Optional: you can specify an IP address before the subnet prefix value - for example
192.168.0.0/24.If no IP address is specified, your VPC automatically determines the starting IP for the range. If no IP range is specified, Cloud Build uses
/24as the default network IP range. -
--no-public-egress - If set, workers in the worker pool are created without an external IP address.
If the worker pool is within a VPC Service Control perimeter, use this flag.
-
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
- These variants are also available:
gcloud alpha builds worker-pools creategcloud beta builds worker-pools create
gcloud builds worker-pools create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

