gcloud container bare-metal node-pools create Stay organized with collections Save and categorize content based on your preferences.
- 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 named
ina cluster namedmy-node-poolmanaged inlocationmy-cluster, run:us-west1gcloudcontainerbare-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 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
node_poolattribute:- 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; - set the property
container_bare_metal/location.
- provide the argument
- provide the argument
- 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.
- 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.
- Populate Bare Metal Node Pool node config.
- Anthos on bare metal node pool configuration.
- 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 helpfor details. - NOTES
- These variants are also available:
gcloudalphacontainerbare-metalnode-poolscreategcloudbetacontainerbare-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.