- NAME
-
- gcloud alpha edge-cloud container clusters node-pools create - create an Edge Container node pool
- SYNOPSIS
-
-
gcloud alpha 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
-
(ALPHA)
Create an Edge Container node pool. - EXAMPLES
-
To create a node pool called
my-nodePool
, containing 3 nodes in regionus-central1
, run:gcloud alpha edge-cloud container clusters node-pools create my-nodePool --cluster=<my-cluster> --location=us-central1 --node-location=<my-node-location> --node-count=3
To create a node pool called
my-nodePool
, containing 3 nodes in regionus-central1
, using only machine names matching a specific pattern, run:gcloud alpha edge-cloud container clusters node-pools create my-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 in regionus-central1
, using only machine names NOT matching a specific pattern, run:gcloud alpha edge-cloud container clusters node-pools create my-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 this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
To set the
project
attribute:-
provide the argument
node_pool
on the command line with a fully specified name; -
provide the argument
--project
on 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
nodePool
attribute:-
provide the argument
node_pool
on the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--cluster
=CLUSTER
-
Cluster of the node pool.
To set the
cluster
attribute:-
provide the argument
node_pool
on the command line with a fully specified name; -
provide the argument
--cluster
on the command line.
-
provide the argument
--location
=LOCATION
-
Google Cloud location for the node pool.
To set the
location
attribute:-
provide the argument
node_pool
on the command line with a fully specified name; -
provide the argument
--location
on the command line.
-
provide the argument
-
provide the argument
-
Node pool resource - Edge Container node pool to create. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes 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, and numbers. 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 this
node pool. The Edge Container service account for this project must have
roles/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. The filtering language accepts strings like "name=<name>", and is documented in more detail at https://google.aip.dev/160.
--node-labels
=[KEY
=VALUE
,…]- Comma-delimited list of key-value pairs that comprise labels for the individual nodes in the node pool.
--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/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/edge-cloud
- 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. This variant is also available:
gcloud edge-cloud container clusters node-pools create
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-10-08 UTC.