doctl kubernetes cluster node-pool create

Go to Navigation

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.
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:
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--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