create

Create a Kubernetes NodePool

Usage

ionosctl compute k8s nodepool create [flags]

Aliases

For nodepool command:

[np]

For create command:

[c]

Description

Use this command to create a Node Pool into an existing Kubernetes Cluster. The Kubernetes Cluster must be in state "ACTIVE" before creating a Node Pool. The worker Nodes within the Node Pools will be deployed into an existing Data Center. Regarding the name for the Kubernetes NodePool, the limit is 63 characters following the rule to begin and end with an alphanumeric character with dashes, underscores, dots, and alphanumerics between. Regarding the Kubernetes Version for the NodePool, if not set via flag, it will be used the default one: ionosctl compute k8s version get.

Use --wait (-w) to wait for the resource to reach AVAILABLE state.

Note: If you want to attach multiple LANs to Node Pool, use --lan-ids=LAN_ID1,LAN_ID2 flag. If you want to also set a Route Network, Route GatewayIp for LAN use ionosctl compute k8s nodepool lan add command for each LAN you want to add.

Required values to run a command (for Public Kubernetes Cluster):

• K8s Cluster Id
• Datacenter Id

Required values to run a command (for Private Kubernetes Cluster):

• K8s Cluster Id
• Datacenter Id

Options

  -A, --annotations stringToString   Annotations to set on a NodePool. It will overwrite the existing annotations, if there are any. Use the following format: --annotations KEY=VALUE,KEY=VALUE (default [])
  -u, --api-url string               Override default host URL. Preferred over the config file override 'cloud' and env var 'IONOS_API_URL' (default "https://api.ionos.com")
  -z, --availability-zone string     The compute Availability Zone in which the Node should exist (default "AUTO")
      --cluster-id string            The unique K8s Cluster Id (required)
      --cols strings                 Set of columns to be printed on output 
                                     Available columns: [NodePoolId Name K8sVersion NodeCount DatacenterId State CpuFamily ServerType StorageType LanIds CoresCount RamSize AvailabilityZone StorageSize MaintenanceWindow AutoScaling PublicIps AvailableUpgradeVersions Annotations Labels ClusterId]
  -c, --config string                Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.yaml")
      --cores int                    The total number of cores for the Node (default 2)
      --cpu-family string            CPU Type. If the flag is not set, the CPU Family will be chosen based on the location of the Datacenter. It will always be the first CPU Family available, as returned by the API
      --datacenter-id string         The unique Data Center Id (required)
  -D, --depth int                    Level of detail for response objects (default 1)
      --dhcp                         Indicates if the Kubernetes Node Pool LANs will reserve an IP using DHCP. E.g.: --dhcp=true, --dhcp=false (default true)
  -F, --filters strings              Limit results to results containing the specified filter:KEY1=VALUE1,KEY2=VALUE2
  -f, --force                        Force command to execute without user input
  -h, --help                         Print usage
      --json-properties string       Path to a JSON file containing the desired properties. Overrides any other properties set.
      --json-properties-example      If set, prints a complete JSON which could be used for --json-properties and exits. Hint: Pipe me to a .json file
      --k8s-version string           The K8s version for the NodePool. If not set, the version of the cluster will be used
  -L, --labels stringToString        Labels to set on a NodePool. It will overwrite the existing labels, if there are any. Use the following format: --labels KEY=VALUE,KEY=VALUE (default [])
      --lan-ids ints                 Collection of LAN Ids of existing LANs to be attached to worker Nodes
      --limit int                    Maximum number of items to return per request (default 50)
  -n, --name string                  The name for the K8s NodePool (default "UnnamedNodePool")
      --no-headers                   Don't print table headers when table output is used
      --node-count int               The number of worker Nodes that the Node Pool should contain. Min 1, Max: Determined by the resource availability (default 1)
      --offset int                   Number of items to skip before starting to collect the results
      --order-by string              Property to order the results by
  -o, --output string                Desired output format [text|json|api-json] (default "text")
      --query string                 JMESPath query string to filter the output
  -q, --quiet                        Quiet output
      --ram string                   RAM size for node, minimum size is 2048MB. Ram size must be set to multiple of 1024MB. e.g. --ram 2048 or --ram 2048MB (default "2048")
      --server-type string           The type of server for the Kubernetes node pool can be either'DedicatedCore' (nodes with dedicated CPU cores) or 'VCPU' (nodes with shared CPU cores).This selection corresponds to the server type for the compute engine.. Can be one of: DedicatedCore, VCPU
      --storage-size string          The size of the Storage in GB. e.g.: --size 10 or --size 10GB. The maximum Volume size is determined by your contract limit (default "10")
      --storage-type string          Storage Type (default "HDD")
  -t, --timeout int                  Timeout in seconds for --wait and other wait operations (default 600)
  -v, --verbose count                Increase verbosity level [-v, -vv, -vvv]
  -w, --wait                         Wait for the resource to reach AVAILABLE state after the command completes. No-op for list commands

Examples

ionosctl compute k8s nodepool create --cluster-id CLUSTER_ID --datacenter-id DATACENTER_ID --name NAME