doctl kubernetes cluster node-pool create
Generated on 9 Apr 2025
from doctl
version
v1.124.0
Usage
doctl kubernetes cluster node-pool create <cluster-id|cluster-name> [flags]
Aliases
c
Description
Creates a new node pool for the specified cluster. The command requires values for the --name
, --size
, and --count
flags to create a node pool. You can also specify that you’d like to enable autoscaling and set minimum and maximum node poll sizes.
Example
The following example creates a node pool named example-pool
in a cluster named example-cluster
:
doctl kubernetes cluster node-pool create example-cluster --name example-pool --size s-1vcpu-2gb --count 3 --taint "key1=value1:NoSchedule" --taint "key2:NoExecute"
Flags
Option | Description |
---|---|
--auto-scale |
Enables auto-scaling on the node pool Default: false |
--count |
The number of nodes in the node pool (required) Default: 0 |
--help , -h |
Help for this command |
--label |
A label in key=value notation to apply to the node pool. Repeat this flag to specify additional labels. An existing label is removed from the node pool if it is not specified by any flag. |
--max-nodes |
The maximum number of nodes in the node pool when autoscaling is enabled Default: 0 |
--min-nodes |
The minimum number of nodes in the node pool when autoscaling (auto_scale) is enabled. If auto_scale is set to false, the default value will be 0. Scale-to-zero is not supported. Default: 0 |
--name |
The name of the node pool (required) |
--size |
The size of the nodes in the node pool. Use the doctl kubernetes options sizes command for a list of possible values. (required) |
--tag |
A tag to apply to the node pool. Repeat this flag to specify additional tags. An existing tag is removed from the node pool if it is not specified by any flag. |
--taint |
Taint in key=value:effect notation to apply to the node pool. Repeat this flag to specify additional taints. Set to an empty string ("") to clear all taints. An existing taint is removed from the node pool if it is not specified by any flag. |
Related Commands
Command | Description |
---|---|
doctl kubernetes cluster node-pool | Display commands for managing node pools |
Global Flags
Option | Description |
---|---|
--access-token , -t |
API V2 access token |
--api-url , -u |
Override default API endpoint |
--config , -c |
Specify a custom config file Default: |
--context |
Specify a custom authentication context name |
--http-retry-max |
Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5 |
--http-retry-wait-max |
Set the minimum number of seconds to wait before retrying a failed request
Default: 30 |
--http-retry-wait-min |
Set the maximum number of seconds to wait before retrying a failed request
Default: 1 |
--interactive |
Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false |
--output , -o |
Desired output format [text|json] Default: text |
--trace |
Show a log of network activity while performing a command Default: false |
--verbose , -v |
Enable verbose output Default: false |