yc managed-kubernetes node-group create
Written by
Updated at October 3, 2024
Create a node group.
Command Usage
Syntax:
yc managed-kubernetes node-group create <NODE-GROUP-NAME> [Flags...] [Global Flags...]
Flags
Flag | Description |
---|---|
--name |
string Name of the node group. |
--description |
string New description for the node group. |
--labels |
key=value[,key=value...] List of node group labels as key-value pairs. |
--cluster-id |
string ID of the Kubernetes cluster. |
--cluster-name |
string Name of the Kubernetes cluster. |
--platform |
string Specifies platform for instances in the node group. |
--metadata |
key=value[,key=value...] Metadata for instances in the node group. |
--metadata-from-file |
key=value[,key=value...] Same as --metadata except that the value for the entry will be read from a local file. |
--template-labels |
key=value[,key=value...] List of platform (not Kubernetes) labels for Compute Cloud instances in the node group as key-value pairs. No more than 32 per resource. The maximum string length in characters for each value is 128. The string length in characters for each key must be 1-63. Each key must match the regular expression '[a-z][-_./\@0-9a-z]*'. |
--template-labels-from-file |
key=value[,key=value...] Same as --template-labels except that the list of key-value pairs for the entry will be read from a local file. |
--public-ip |
Set when node group needs external public IP. |
--memory |
byteSize Specifies how much memory instances should have. |
--cores |
int Specifies how many CPU cores instances should have. |
--core-fraction |
int Specifies baseline performance for a core in percent. |
--gpus |
int Specifies how many GPUs instances should have. |
--preemptible |
Specifies if created nodes will be preemptible. |
--gpu-cluster-id |
string Specifies if created nodes will be part of the GPU cluster. |
--gpu-environment |
string Specifies GPU environment for created nodes. Values: 'runc-drivers-cuda', 'runc' |
--disk-type |
string Specifies boot disk type for instances, valid values: network-ssd|network-hdd |
--disk-size |
byteSize Specifies boot disk size for instances. |
--fixed-size |
int Specifies fixed scale policy size. |
--auto-scale |
PROPERTY=VALUE[,PROPERTY=VALUE...] Auto scale policy for Node Group. Possible property names:
|
--location |
PROPERTY=VALUE[,PROPERTY=VALUE...] List of node group locations. Possible property names:
|
--version |
string Node Kubernetes components version. Default depends on Cluster release channel. See available in 'yc managed-kubernetes list-versions'. |
--allowed-unsafe-sysctls |
value[,value] List of strings containing allowed unsafe sysctls for use on nodes. |
--node-labels |
key=value[,key=value...] Kubernetes labels that are assigned to the nodes of the node group. |
--node-taints |
value[,value] Kubernetes taints that are applied to the nodes of the node group. |
--auto-upgrade |
Sets auto upgrade maintenance policy. 'true' by default. Policy defines if Node Group can be upgraded to newer version revision in specified maintenance window. Auto upgrade is 'graceful': new nodes are created, while old nodes drained by one. Please setup Pod Disruption Budget, for graceful pods drain. For details about PDB see https://kubernetes.io/docs/tasks/run-application/configure-pdb/ New revision contains can contain bug and security fixes, so it's recommended to leave this policy enabled. Node Group never upgraded to another major version automatically, even with this policy set to true. Examples: '--auto-upgrade=false', '--auto-upgrade' |
--auto-repair |
Sets auto repair maintenance policy. 'true' by default. Policy defines if nodes seems to be broken can be recreated automatically. Examples: '--auto-repair=false', '--auto-repair' |
--anytime-maintenance-window |
Allow maintenance anytime. This is default maintenance window. |
--daily-maintenance-window |
PROPERTY=VALUE[,PROPERTY=VALUE...] Allow maintenance everyday specified days of week in the specified time window. Flag can be used multiple times, to define different time windows for different days of week. Examples: --daily-maintenance-window 'start=22:00,duration=10h --daily-maintenance-window 'start=03:00,duration=8h30m Possible property names:
|
--weekly-maintenance-window |
PROPERTY=VALUE[,PROPERTY=VALUE...] Allow maintenance on specified days of week in the specified time window. Flag can be used multiple times, to define different time windows for different days of week. Examples: --weekly-maintenance-window 'days=[monday,tuesday],start=22:00,duration=10h --weekly-maintenance-window 'days=weekend,start=03:00,duration=8h30m Possible property names:
|
--max-expansion |
int Number of extra nodes to be created on each upgrade of the node group. Must be used in conjunction with --max-unavailable flag. |
--max-unavailable |
int Number of nodes that can be unavailable at the same time on each upgrade of the node group. Must be used in conjunction with --max-expansion flag. |
--network-interface |
PROPERTY=VALUE[,PROPERTY=VALUE...] Adds a network interface to the node group. Possible property names:
|
--placement-group |
string Placement policy group for the node group. Can be either name or ID. |
--network-acceleration-type |
string Type of a network acceleration for nodes. Values: 'standard', 'software-accelerated' |
--container-runtime |
string Type of a container runtime for nodes. Values: 'docker', 'containerd' |
--node-name |
string Name of the node. In order to be unique it must contain at least one of the instance unique placeholders like {instance_group.id}, {instance.short_id}, {instance.index}. See Compute service Instance-group metadata doc for full list. Example: --node-name=prod-node- |
--container-network-settings |
PROPERTY=VALUE[,PROPERTY=VALUE...] Container network settings for nodes. Possible property names:
|
--async |
Display information about the operation in progress, without waiting for the operation to complete. |
Global Flags
Flag | Description |
---|---|
--profile |
string Set the custom configuration file. |
--debug |
Debug logging. |
--debug-grpc |
Debug gRPC logging. Very verbose, used for debugging connection problems. |
--no-user-output |
Disable printing user intended output to stderr. |
--retry |
int Enable gRPC retries. By default, retries are enabled with maximum 5 attempts. Pass 0 to disable retries. Pass any negative value for infinite retries. Even infinite retries are capped with 2 minutes timeout. |
--cloud-id |
string Set the ID of the cloud to use. |
--folder-id |
string Set the ID of the folder to use. |
--folder-name |
string Set the name of the folder to use (will be resolved to id). |
--endpoint |
string Set the Cloud API endpoint (host:port). |
--token |
string Set the OAuth token to use. |
--impersonate-service-account-id |
string Set the ID of the service account to impersonate. |
--no-browser |
Disable opening browser for authentication. |
--format |
string Set the output format: text (default), yaml, json, json-rest. |
--jq |
string Query to select values from the response using jq syntax |
-h ,--help |
Display help for the command. |