.TH "GCLOUD_BUILDS_WORKER\-POOLS_CREATE" 1



.SH "NAME"
.HP
gcloud builds worker\-pools create \- create a worker pool for use by Google Cloud Build



.SH "SYNOPSIS"
.HP
\f5gcloud builds worker\-pools create\fR \fIWORKER_POOL\fR [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-config\-from\-file\fR=\fICONFIG_FROM_FILE\fR\ |\ \fB\-\-worker\-disk\-size\fR=\fIWORKER_DISK_SIZE\fR\ \fB\-\-worker\-machine\-type\fR=\fIWORKER_MACHINE_TYPE\fR\ \fB\-\-peered\-network\fR=\fIPEERED_NETWORK\fR\ \fB\-\-peered\-network\-ip\-range\fR=\fIPEERED_NETWORK_IP_RANGE\fR\ \fB\-\-no\-public\-egress\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a worker pool for use by Google Cloud Build.



.SH "EXAMPLES"

To create a worker pool named \f5wp1\fR in region \f5us\-central1\fR, run:

.RS 2m
$ gcloud builds worker\-pools create wp1 \-\-region=us\-central1
.RE

To create a worker pool in project \f5p1\fR in region \f5us\-central1\fR where
workers are of machine type \f5e2\-standard\-2\fR and are peered to the VPC
network \f5projects/123/global/networks/default\fR within the IP range
\f5192.168.0.0/28\fR and have a disk size of 64GB, run:

.RS 2m
$ gcloud builds worker\-pools create wp1 \-\-project=p1 \e
    \-\-region=us\-central1 \e
    \-\-peered\-network=projects/123/global/networks/default \e
    \-\-peered\-network\-ip\-range=192.168.0.0/28 \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 create. This value should be 1\-63
characters, and valid characters are [a\-z][0\-9]\-


.RE
.sp

.SH "FLAGS"

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

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

.TP 2m

At most one of these can be specified:


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

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.

.TP 2m

Command\-line flags to configure the private pool:


.RS 2m
.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
.sp
.TP 2m

Network configuration for Service Networking:


.RS 2m
.TP 2m
\fB\-\-peered\-network\fR=\fIPEERED_NETWORK\fR

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.

.TP 2m
\fB\-\-peered\-network\-ip\-range\fR=\fIPEERED_NETWORK_IP_RANGE\fR

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 \f5/29\fR.

Your subnet prefix size must be between 1 and 29. Optional: you can specify an
IP address before the subnet prefix value \- for example \f5192.168.0.0/24\fR.

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 \f5/24\fR as the
default network IP range.

.TP 2m
\fB\-\-no\-public\-egress\fR

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.


.RE
.RE
.RE
.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 create
.RE

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