gcloud-help/gcloud/alpha/edge-cloud/container/clusters/node-pools/create

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 region
    us-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 region
    us-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 region
    us-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.

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

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

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. 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/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