gcloud container bare-metal node-pools create

NAME
gcloud container bare-metal node-pools create - create a node pool in an Anthos cluster on bare metal
SYNOPSIS
gcloud container bare-metal node-pools create(NODE_POOL :--cluster=CLUSTER--location=LOCATION)(--node-configs=[labels=LABELS],[node-ip=NODE-IP] :--node-labels=[KEY=VALUE,…]--node-taints=[KEY=VALUE:EFFECT,…]--disable-serialize-image-pulls--registry-burst=REGISTRY_BURST--registry-pull-qps=REGISTRY_PULL_QPS)[--annotations=[KEY=VALUE,…]][--async][--display-name=DISPLAY_NAME][--validate-only][GCLOUD_WIDE_FLAG]
DESCRIPTION
Create a node pool in an Anthos cluster on bare metal.
EXAMPLES
To create a node pool namedmy-node-pool ina cluster namedmy-cluster managed inlocationus-west1, run:
gcloudcontainerbare-metalnode-poolscreatemy-node-pool--cluster=my-cluster--location=us-west1
POSITIONAL ARGUMENTS
Node pool resource - node pool to create The arguments in this group can be usedto specify the attributes of this resource. (NOTE) Some attributes are not givenarguments 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 thenode_pool 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;
  • set the propertycontainer_bare_metal/location.
REQUIRED FLAGS
Anthos on bare metal node pool configuration.

This must be specified.

Populate Bare Metal Node Pool node config.

Exactly one of these must be specified:

--node-configs=[labels=LABELS],[node-ip=NODE-IP]
Bare Metal Node Pool node configuration.
--node-labels=[KEY=VALUE,…]
Labels assigned to nodes of a node pool.
--node-taints=[KEY=VALUE:EFFECT,…]
Node taint applied to every Kubernetes node in a node pool.
Modifiable kubelet configurations for bare metal machines.
--disable-serialize-image-pulls
If set, prevent the Kubelet from pulling multiple images at a time.
--registry-burst=REGISTRY_BURST
Maximum size of bursty pulls, temporarily allow pulls to burst to this number,while still not exceeding registry_pull_qps.
--registry-pull-qps=REGISTRY_PULL_QPS
Limit of registry pulls per second.
OPTIONAL FLAGS
--annotations=[KEY=VALUE,…]
Annotations on the node pool.
--async
Return immediately, without waiting for the operation in progress to complete.
--display-name=DISPLAY_NAME
Display name for the resource.
--validate-only
If set, only validate the request, but do not actually perform the operation.
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
These variants are also available:
gcloudalphacontainerbare-metalnode-poolscreate
gcloudbetacontainerbare-metalnode-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 2026-01-21 UTC.