gcloud edge-cloud container clusters node-pools create

NAME
gcloud edge-cloud container clusters node-pools create - create an Edge Container node pool
SYNOPSIS
gcloud edge-cloud container clusters node-pools create(NODE_POOL :--cluster=CLUSTER--location=LOCATION)--node-count=NODE_COUNT--node-location=NODE_LOCATION[--async][--labels=[KEY=VALUE,…]][--local-disk-kms-key=LOCAL_DISK_KMS_KEY][--lro-timeout=LRO_TIMEOUT][--machine-filter=MACHINE_FILTER][--node-labels=[KEY=VALUE,…]][--node-storage-schema=NODE_STORAGE_SCHEMA][GCLOUD_WIDE_FLAG]
DESCRIPTION
Create an Edge Container node pool.
EXAMPLES
To create a node pool calledmy-nodePool, containing 3 nodes inregionus-central1, run:
gcloudedge-cloudcontainerclustersnode-poolscreatemy-nodePool--cluster=<my-cluster>--location=us-central1--node-location=<my-node-location>--node-count=3

To create a node pool calledmy-nodePool, containing 3 nodes inregionus-central1, using only machine names matching a specificpattern, run:

gcloudedge-cloudcontainerclustersnode-poolscreatemy-nodePool--cluster=<my-cluster>--location=us-central1--node-location=<my-node-location>--node-count=3--machine-filter="name:<name>"

To create a node pool calledmy-nodePool, containing 3 nodes inregionus-central1, using only machine names NOT matching aspecific pattern, run:

gcloudedge-cloudcontainerclustersnode-poolscreatemy-nodePool--cluster=<my-cluster>--location=us-central1--node-location=<my-node-location>--node-count=3--machine-filter="NOT name:<name>"
POSITIONAL ARGUMENTS
Node pool resource - Edge Container node pool to create. The arguments in thisgroup can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentnode_pool on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

NODE_POOL
ID of the node pool or fully qualified identifier for the node pool.

To set thenodePool attribute:

  • provide the argumentnode_pool on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--cluster=CLUSTER
Cluster of the node pool.

To set thecluster attribute:

  • provide the argumentnode_pool on the command line with a fullyspecified name;
  • provide the argument--cluster on the command line.
--location=LOCATION
Google Cloud location for the node pool.

To set thelocation attribute:

  • provide the argumentnode_pool on the command line with a fullyspecified name;
  • provide the argument--location on the command line.
REQUIRED FLAGS
--node-count=NODE_COUNT
Default nodeCount used by this node pool.
--node-location=NODE_LOCATION
Google Edge Cloud zone where nodes in this node pool will be created.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--labels=[KEY=VALUE,…]
List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers. Values must contain only hyphens (-), underscores(_), lowercase characters, and numbers.

--local-disk-kms-key=LOCAL_DISK_KMS_KEY
Google Cloud KMS key that will be used to secure local disks on nodes in thisnode pool. The Edge Container service account for this project must haveroles/cloudkms.cryptoKeyEncrypterDecrypter on the key.

If not provided, a Google-managed key will be used instead.

--lro-timeout=LRO_TIMEOUT
Overwrite the default LRO maximum timeout.
--machine-filter=MACHINE_FILTER
Only machines matching this filter will be allowed to join the node pool. Thefiltering language accepts strings like "name=<name>", and is documentedin more detail athttps://google.aip.dev/160.
--node-labels=[KEY=VALUE,…]
Comma-delimited list of key-value pairs that comprise labels for the individualnodes in the node pool. This flag sets the Kubernetes labels, unlike--labels which sets the cloud resource labels.
--node-storage-schema=NODE_STORAGE_SCHEMA
Name for the storage schema of worker nodes.
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.

API REFERENCE
This command uses the edgecontainer/v1 API. The full documentation for this APIcan be found at:https://cloud.google.com/edge-cloud
NOTES
This variant is also available:
gcloudalphaedge-cloudcontainerclustersnode-poolscreate

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 2025-05-07 UTC.