gcloud builds worker-pools update

NAME
gcloud builds worker-pools update - update a worker pool used by Cloud Build
SYNOPSIS
gcloud builds worker-pools updateWORKER_POOL(--config-from-file=CONFIG_FROM_FILE    |--[no-]public-egress--worker-disk-size=WORKER_DISK_SIZE--worker-machine-type=WORKER_MACHINE_TYPE)[--region=REGION][GCLOUD_WIDE_FLAG …]
DESCRIPTION
Update a worker pool used by Cloud Build.
EXAMPLES
To change the machine type and disk size of workers in a worker pool named wp1,run:
gcloudbuildsworker-poolsupdatewp1--region=us-central1--worker-machine-type=e2-standard-2--worker-disk-size=64GB
POSITIONAL ARGUMENTS
WORKER_POOL
Unique identifier for the worker pool to update. This value should be 1-63characters, and valid characters are [a-z][0-9]-
REQUIRED FLAGS
Exactly one of these must be specified:
--config-from-file=CONFIG_FROM_FILE
File that contains updates to the configuration for the worker pool. 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:
--[no-]public-egress
If set to true, workers in the worker pool are created with an external IPaddress.

If set to false, workers in the worker pool are created without an external IPaddress. If the worker pool is within a VPC Service Control perimeter, use thisflag.

Use--public-egress to enable and--no-public-egressto disable.

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.

OPTIONAL FLAGS
--region=REGION
Cloud region where the worker pool is updated. Seehttps://cloud.google.com/build/docs/locationsfor available locations.
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-poolsupdate
gcloudbetabuildsworker-poolsupdate

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.