.TH "GCLOUD_ALPHA_BUILDS_WORKER\-POOLS_UPDATE" 1



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



.SH "SYNOPSIS"
.HP
\f5gcloud alpha 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\-\-generation\fR=\fIGENERATION\fR;\ default=1] [\fB\-\-region\fR=\fIREGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update a private 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 alpha 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 worker pool to be created.

Private pool options:

.RS 2m
https://cloud.google.com/build/docs/private\-pools/worker\-pool\-config\-file\-schema
.RE

.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\-\-generation\fR=\fIGENERATION\fR; default=1

Generation of the worker pool.

.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"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

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

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