NodeClass is the Schema for the NodeClass API
Unchanged since Karpenter v0.30.0
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
NodeClassSpec is the top level specification for the AWS Karpenter Provider. This will contain configuration necessary to launch instances in AWS.
AMIFamily is the AMI family that instances use.
AMISelectorTerms is a list of or ami selector terms. The terms are ORed.
ID is the ami id in EC2
Name is the ami name in EC2. This value is the name field, which is different from the name tag.
Owner is the owner for the ami. You can specify a combination of AWS account IDs, "self", "amazon", and "aws-marketplace"
SSM is the ssm alias for an ami.
Tags is a map of key/value tags used to select subnets Specifying '*' for a value selects all values for a given tag key.
BlockDeviceMappings to be applied to provisioned nodes.
The device name (for example, /dev/sdh or xvdh).
EBS contains parameters used to automatically set up EBS volumes when an instance is launched.
DeleteOnTermination indicates whether the EBS volume is deleted on instance termination.
Encrypted indicates whether the EBS volume is encrypted. Encrypted volumes can only be attached to instances that support Amazon EBS encryption. If you are creating a volume from a snapshot, you can't specify an encryption value.
IOPS is the number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. The following are the supported values for each volume type: * gp3: 3,000-16,000 IOPS * io1: 100-64,000 IOPS * io2: 100-64,000 IOPS For io1 and io2 volumes, we guarantee 64,000 IOPS only for Instances built on the Nitro System (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances). Other instance families guarantee performance up to 32,000 IOPS. This parameter is supported for io1, io2, and gp3 volumes only. This parameter is not supported for gp2, st1, sc1, or standard volumes.
KMSKeyID (ARN) of the symmetric Key Management Service (KMS) CMK used for encryption.
SnapshotID is the ID of an EBS snapshot
Throughput to provision for a gp3 volume, with a maximum of 1,000 MiB/s. Valid Range: Minimum value of 125. Maximum value of 1000.
VolumeSize in GiBs. You must specify either a snapshot ID or a volume size. The following are the supported volumes sizes for each volume type: * gp2 and gp3: 1-16,384 * io1 and io2: 4-16,384 * st1 and sc1: 125-16,384 * standard: 1-1,024
VolumeType of the block device. For more information, see Amazon EBS volume types (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) in the Amazon Elastic Compute Cloud User Guide.
Context is a Reserved field in EC2 APIs https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html
DetailedMonitoring controls if detailed monitoring is enabled for instances that are launched
MetadataOptions for the generated launch template of provisioned nodes. This specifies the exposure of the Instance Metadata Service to provisioned EC2 nodes. For more information, see Instance Metadata and User Data (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) in the Amazon Elastic Compute Cloud User Guide. Refer to recommended, security best practices (https://aws.github.io/aws-eks-best-practices/security/docs/iam/#restrict-access-to-the-instance-profile-assigned-to-the-worker-node) for limiting exposure of Instance Metadata and User Data to pods. If omitted, defaults to httpEndpoint enabled, with httpProtocolIPv6 disabled, with httpPutResponseLimit of 2, and with httpTokens required.
HTTPEndpoint enables or disables the HTTP metadata endpoint on provisioned nodes. If metadata options is non-nil, but this parameter is not specified, the default state is "enabled". If you specify a value of "disabled", instance metadata will not be accessible on the node.
HTTPProtocolIPv6 enables or disables the IPv6 endpoint for the instance metadata service on provisioned nodes. If metadata options is non-nil, but this parameter is not specified, the default state is "disabled".
HTTPPutResponseHopLimit is the desired HTTP PUT response hop limit for instance metadata requests. The larger the number, the further instance metadata requests can travel. Possible values are integers from 1 to 64. If metadata options is non-nil, but this parameter is not specified, the default value is 1.
HTTPTokens determines the state of token usage for instance metadata requests. If metadata options is non-nil, but this parameter is not specified, the default state is "optional". If the state is optional, one can choose to retrieve instance metadata with or without a signed token header on the request. If one retrieves the IAM role credentials without a token, the version 1.0 role credentials are returned. If one retrieves the IAM role credentials using a valid signed token, the version 2.0 role credentials are returned. If the state is "required", one must send a signed token header with any instance metadata retrieval requests. In this state, retrieving the IAM role credentials always returns the version 2.0 credentials; the version 1.0 credentials are not available.
Role is the AWS identity that nodes use.
SecurityGroupSelectorTerms is a list of or security group selector terms. The terms are ORed.
ID is the security group id in EC2
Name is the security group name in EC2. This value is the name field, which is different from the name tag.
Tags is a map of key/value tags used to select subnets Specifying '*' for a value selects all values for a given tag key.
SubnetSelectorTerms is a list of or subnet selector terms. The terms are ORed.
ID is the subnet id in EC2
Tags is a map of key/value tags used to select subnets Specifying '*' for a value selects all values for a given tag key.
Tags to be applied on ec2 resources like instances and launch templates.
UserData to be applied to the provisioned nodes. It must be in the appropriate format based on the AMIFamily in use. Karpenter will merge certain fields into this UserData to ensure nodes are being provisioned with the correct configuration.
NodeClassStatus contains the resolved state of the NodeClass
AMI contains the current AMI values that are available to the cluster under the AMI selectors.
ID of the AMI
Name of the AMI
Requirements of the AMI to be utilized on an instance type
The label key that the selector applies to.
Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.
An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.
SecurityGroups contains the current Security Groups values that are available to the cluster under the SecurityGroups selectors.
ID of the security group
Name of the security group
Subnets contains the current Subnet values that are available to the cluster under the subnet selectors.
ID of the subnet
The associated availability zone
Source: compute.k8s.aws_nodeclasses.yaml
Changes to NodeClass (compute.k8s.aws/v1beta1) in each Karpenter version, compared to the version before it.
NodeClass was first seen on this version of Karpenter
Released · View NodeClass in v0.30.0
No examples of NodeClass yet. Contribute one on GitHub.
kubespec.dev