gcloud edge-cloud container clusters node-pools create Stay organized with collections Save and categorize content based on your preferences.
- 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 called
my-nodePool, containing 3 nodes inregionus-central1, run:gcloudedge-cloudcontainerclustersnode-poolscreatemy-nodePool--cluster=<my-cluster>--location=us-central1--node-location=<my-node-location>--node-count=3To create a node pool called
my-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 called
my-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 the
projectattribute:- provide the argument
node_poolon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
NODE_POOL- ID of the node pool or fully qualified identifier for the node pool.
To set the
nodePoolattribute:- provide the argument
node_poolon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--cluster=CLUSTER- Cluster of the node pool.
To set the
clusterattribute:- provide the argument
node_poolon the command line with a fullyspecified name; - provide the argument
--clusteron the command line.
- provide the argument
--location=LOCATION- Google Cloud location for the node pool.
To set the
locationattribute:- provide the argument
node_poolon the command line with a fullyspecified name; - provide the argument
--locationon the command line.
- provide the argument
- provide the argument
- 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.
- 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 have
roles/cloudkms.cryptoKeyEncrypterDecrypteron 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
--labelswhich 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 helpfor 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.