Subcommands
Legal

K8sNodepoolUpdate

Update a Kubernetes NodePool

Usage

ionosctl k8s nodepool update [flags]

Aliases

For nodepool command:

[np]

For update command:

[u up]

Description

Use this command to update the number of worker Nodes, the minimum and maximum number of worker Nodes, the add labels, annotations, to update the maintenance day and time, to attach private LANs to a Node Pool within an existing Kubernetes Cluster. You can also add reserved public IP addresses to be used by the Nodes. IPs must be from same location as the Data Center used for the Node Pool. The array must contain one extra IP than maximum number of Nodes could be. (nodeCount+1 if fixed node amount or maxNodeCount+1 if auto scaling is used) The extra provided IP Will be used during rebuilding of Nodes.

You can wait for the Node Pool to be in "ACTIVE" state using --wait-for-state flag together with --timeout option.

Required values to run command:

  • K8s Cluster Id

  • K8s NodePool Id

Options

--annotation-key string Annotation key. Must be set together with --annotation-value
--annotation-value string Annotation value. Must be set together with --annotation-key
-u, --api-url string Override default host url (default "https://api.ionos.com")
--cluster-id string The unique K8s Cluster Id (required)
--cols strings Set of columns to be printed on output
Available columns: [NodePoolId Name K8sVersion DatacenterId NodeCount CpuFamily StorageType State LanIds CoresCount RamSize AvailabilityZone StorageSize MaintenanceWindow AutoScaling PublicIps PublicIps AvailableUpgradeVersions] (default [NodePoolId,Name,K8sVersion,NodeCount,DatacenterId,State])
-c, --config string Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.json")
-f, --force Force command to execute without user input
-h, --help Print usage
--k8s-version string The K8s version for the NodePool. K8s version downgrade is not supported
--label-key string Label key. Must be set together with --label-value
--label-value string Label value. Must be set together with --label-key
--lan-ids ints The unique LAN Ids of existing LANs to be attached to worker Nodes. It will be attached to the existing ones
--maintenance-day string The day of the week for Maintenance Window has the English day format as following: Monday or Saturday
--maintenance-time string The time for Maintenance Window has the HH:mm:ss format as following: 08:00:00
--max-node-count int The maximum number of worker Nodes that the managed NodePool can scale out. Should be set together with --min-node-count (default 1)
--min-node-count int The minimum number of worker Nodes that the managed NodePool can scale in. Should be set together with --max-node-count (default 1)
--node-count int The number of worker Nodes that the NodePool should contain (default 1)
-i, --nodepool-id string The unique K8s Node Pool Id (required)
-o, --output string Desired output format [text|json] (default "text")
--public-ips strings Reserved public IP address to be used by the Nodes. IPs must be from same location as the Data Center used for the Node Pool. Usage: --public-ips IP1,IP2
-q, --quiet Quiet output
-t, --timeout int Timeout option for waiting for NodePool to be in ACTIVE state [seconds] (default 600)
-v, --verbose Print step-by-step process when running command
-W, --wait-for-state Wait for the new NodePool to be in ACTIVE state

Examples

ionosctl k8s nodepool update --cluster-id CLUSTER_ID --nodepool-id NODEPOOL_ID --node-count NODE_COUNT