- NAME
-
- gcloud alpha builds worker-pools update - update a private pool used by Cloud Build
- SYNOPSIS
-
-
gcloud alpha builds worker-pools update
WORKER_POOL
(--config-from-file
=CONFIG_FROM_FILE
|--[no-]public-egress
--worker-disk-size
=WORKER_DISK_SIZE
--worker-machine-type
=WORKER_MACHINE_TYPE
) [--generation
=GENERATION
; default=1] [--region
=REGION
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
Update a private pool used by Cloud Build. - EXAMPLES
-
To change the machine type and disk size of workers in a worker pool named wp1,
run:
gcloud alpha builds worker-pools update wp1 --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-63 characters, 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 worker pool to be created.
Private pool options:
https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema
-
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 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
--public-egress
to enable and--no-public-egress
to 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 not given, Cloud Build will use 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.
-
Exactly one of these must be specified:
- OPTIONAL FLAGS
-
--generation
=GENERATION
; default=1- Generation of the worker pool.
--region
=REGION
- Cloud region where the worker pool is updated. See https://cloud.google.com/build/docs/locations for 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
-
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:
gcloud builds worker-pools update
gcloud beta builds worker-pools update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-16 UTC.