gcloud builds worker-pools create

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 namedwp1 in regionus-central1, run:
gcloudbuildsworker-poolscreatewp1--region=us-central1

To create a worker pool in projectp1 in regionus-central1 where workers are of machine typee2-standard-2 and are peered to the VPC networkprojects/123/global/networks/default within the IP range192.168.0.0/28 and have a disk size of 64GB, run:

gcloudbuildsworker-poolscreatewp1--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-63characters, and valid characters are [a-z][0-9]-
FLAGS
--region=REGION
Cloud region where the worker pool is created. Seehttps://cloud.google.com/build/docs/locationsfor 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. Seehttps://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schemafor 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 inresource 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 ClasslessInter-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 anIP address before the subnet prefix value - for example192.168.0.0/24.

If no IP address is specified, your VPC automatically determines the starting IPfor the range. If no IP range is specified, Cloud Build uses/24 asthe 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 help for details.

NOTES
These variants are also available:
gcloudalphabuildsworker-poolscreate
gcloudbetabuildsworker-poolscreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-21 UTC.