aws::eks-nodegroup

Creates an eks nodegroup.

Example

aws::eks-nodegroup eks-nodegroup-example
    name: "example-eks-nodegroup"
    cluster: $(aws::eks-cluster ex)
    node-role: "arn:aws:iam::242040583208:role/EKS_NODEGROUP_ROLE"

    subnets: [
        $(aws::subnet "subnet-example-us-east-1a"),
        $(aws::subnet "subnet-example-us-east-1b")
    ]

    labels: {
        "example-label-key": "example-label-value"
    }
end

Attributes

Attribute Description
name The name of the nodegroup. (Required)
cluster The name of the cluster for which to manage the nodegroup. (Required)
version The Kubernetes version to use for your managed nodes. Defaults to 1.15.
release-version The AMI version of the Amazon EKS-optimized AMI to use with your node group. Defaults to 1.15.10-20200228.
scaling-config subresource

The scaling configuration details for the Auto Scaling group that is created for your node group.

desired-size
The current number of worker nodes that the managed node group should maintain. Defaults to 2. Can be between 1 to 100. Valid values are between 1 to 100.
max-size
The maximum number of worker nodes that the managed node group can scale in to. Defaults to 2. Can be between 1 to 100. Valid values are between 1 to 100.
min-size
The minimum number of worker nodes that the managed node group can scale in to. Defaults to 1. Can be between 1 to 100. Valid values are between 1 to 100.
instance-types list The instance types to use for your node group. Defaults to t3.medium.
subnets list The subnets to use for the Auto Scaling group that is created for your node group. (Required)
remote-access subresource

The remote access (SSH) configuration for the node group.

ec2-ssh-key
The SSH key that provides access for communication with the worker nodes in the managed node group. (Required)
source-security-groups list
The security groups that are allowed SSH access to the worker nodes.
ami-type The Ami type of the node group. Valid values are AL2_x86_64, AL2_x86_64_GPU, AL2_ARM_64, BOTTLEROCKET_ARM_64, BOTTLEROCKET_x86_64 or CUSTOM.
node-role The IAM role to use for the nodegroup. (Required)
labels map The Kubernetes labels to be applied to the nodes in the node group when they are created.
disk-size The root device disk size in GiB for the node group instances. Defaults to 20.
tags map The tags to attach to the nodegroup.
launch-template-specification The launch template specification.
capacity-type Which capacity type to use for this nodegroup.

Outputs

Attribute Description
arn The Amazon Resource Number (ARN) of the nodegroup.