Karpenter nodeclass

icon

Configure a Karpenter EC2NodeClass for EKS node provisioning. The install name becomes the EC2NodeClass resource name — use this name as the nodeclass_ref when installing karpenter-nodepool. Install once per logical node class (most clusters need only one). Requires Karpenter to already be installed in the cluster (e.g. via eksctl's karpenter addon).

plugins/karpenter-nodeclass/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
resource_id: karpenter-nodeclass
name: Karpenter EC2NodeClass
icon: https://github.com/juno-fx/Terra-Official-Plugins/blob/main/plugins/karpenter-nodeclass/assets/logo.png?raw=true
description: |
  Configure a Karpenter EC2NodeClass for EKS node provisioning. The install name becomes the
  EC2NodeClass resource name — use this name as the nodeclass_ref when installing
  karpenter-nodepool. Install once per logical node class (most clusters need only one).
  Requires Karpenter to already be installed in the cluster (e.g. via eksctl's karpenter addon).
category: Compute
compatibility: genesis-deployment>=3.0.2,orion-deployment>=3.1.0
editable: true
tags:
  - karpenter
  - autoscaling
  - ec2
  - aws
  - cluster-level
fields:
  - name: cluster_name
    description: >-
      Your EKS cluster name. Used as the karpenter.sh/discovery tag value for subnet and
      security group auto-discovery. Must match the tag applied to your cluster's subnets
      and security groups.
    required: true
    type: string
  - name: role
    description: >-
      IAM role name for Karpenter-provisioned nodes. Find it with:
      aws iam list-roles --query "Roles[?contains(RoleName, 'KarpenterNodeRole')].RoleName" --output text
    required: true
    type: string
  - name: volume_size
    description: 'Root EBS volume size for provisioned nodes (e.g. 100Gi).'
    required: true
    type: string
    default: 100Gi
  - name: volume_type
    description: Root EBS volume type.
    required: true
    type: select
    default: gp3
    options:
      - gp3
      - gp2
      - io1
      - io2
  - name: ami_alias
    description: >-
      AMI selector alias. Controls which Amazon Machine Image nodes are provisioned with.
      Use al2023@latest for the latest Amazon Linux 2023, or pin to a specific version.
    required: true
    type: string
    default: al2023@latest