.TH "GCLOUD_BUILDS_WORKER\-POOLS_UPDATE" 1



.SH "NAME"
.HP
gcloud builds worker\-pools update \- update a worker pool used by Cloud Build



.SH "SYNOPSIS"
.HP
\f5gcloud builds worker\-pools update\fR \fIWORKER_POOL\fR (\fB\-\-config\-from\-file\fR=\fICONFIG_FROM_FILE\fR\ |\ \fB\-\-[no\-]public\-egress\fR\ \fB\-\-worker\-disk\-size\fR=\fIWORKER_DISK_SIZE\fR\ \fB\-\-worker\-machine\-type\fR=\fIWORKER_MACHINE_TYPE\fR) [\fB\-\-region\fR=\fIREGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update a worker pool used by Cloud Build.



.SH "EXAMPLES"

To change the machine type and disk size of workers in a worker pool named wp1,
run:

.RS 2m
$ gcloud builds worker\-pools update wp1 \-\-region=us\-central1 \e
    \-\-worker\-machine\-type=e2\-standard\-2 \-\-worker\-disk\-size=64GB
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIWORKER_POOL\fR

Unique identifier for the worker pool to update. This value should be 1\-63
characters, and valid characters are [a\-z][0\-9]\-


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-config\-from\-file\fR=\fICONFIG_FROM_FILE\fR

File that contains updates to the configuration for the worker pool. See
https://cloud.google.com/build/docs/private\-pools/worker\-pool\-config\-file\-schema
for options.

.TP 2m

Command\-line flags to configure the private pool:


.RS 2m
.TP 2m
\fB\-\-[no\-]public\-egress\fR

If set to true, workers in the worker pool are created with an external IP
address.

If set to false, 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.

Use \fB\-\-public\-egress\fR to enable and \fB\-\-no\-public\-egress\fR to
disable.

.TP 2m

Configuration to be used for creating workers in the worker pool:


.RS 2m
.TP 2m
\fB\-\-worker\-disk\-size\fR=\fIWORKER_DISK_SIZE\fR

Size of the disk attached to the worker.

If unspecified, Cloud Build uses a standard disk size.

.TP 2m
\fB\-\-worker\-machine\-type\fR=\fIWORKER_MACHINE_TYPE\fR

Compute Engine machine type for a worker pool.

If unspecified, Cloud Build uses a standard machine type.


.RE
.RE
.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Cloud region where the worker pool is updated. See
https://cloud.google.com/build/docs/locations for available locations.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha builds worker\-pools update
.RE

.RS 2m
$ gcloud beta builds worker\-pools update
.RE