aws.eks.NodeGroup
Explore with Pulumi AI
Manages an EKS Node Group, which can provision and optionally update an Auto Scaling Group of Kubernetes worker nodes compatible with EKS. Additional documentation about this functionality can be found in the EKS User Guide.
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Eks.NodeGroup("example", new()
{
ClusterName = aws_eks_cluster.Example.Name,
NodeRoleArn = aws_iam_role.Example.Arn,
SubnetIds = aws_subnet.Example.Select(__item => __item.Id).ToList(),
ScalingConfig = new Aws.Eks.Inputs.NodeGroupScalingConfigArgs
{
DesiredSize = 1,
MaxSize = 2,
MinSize = 1,
},
UpdateConfig = new Aws.Eks.Inputs.NodeGroupUpdateConfigArgs
{
MaxUnavailable = 1,
},
}, new CustomResourceOptions
{
DependsOn = new[]
{
aws_iam_role_policy_attachment.Example_AmazonEKSWorkerNodePolicy,
aws_iam_role_policy_attachment.Example_AmazonEKS_CNI_Policy,
aws_iam_role_policy_attachment.Example_AmazonEC2ContainerRegistryReadOnly,
},
});
});
Coming soon!
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.eks.NodeGroup;
import com.pulumi.aws.eks.NodeGroupArgs;
import com.pulumi.aws.eks.inputs.NodeGroupScalingConfigArgs;
import com.pulumi.aws.eks.inputs.NodeGroupUpdateConfigArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new NodeGroup("example", NodeGroupArgs.builder()
.clusterName(aws_eks_cluster.example().name())
.nodeRoleArn(aws_iam_role.example().arn())
.subnetIds(aws_subnet.example().stream().map(element -> element.id()).collect(toList()))
.scalingConfig(NodeGroupScalingConfigArgs.builder()
.desiredSize(1)
.maxSize(2)
.minSize(1)
.build())
.updateConfig(NodeGroupUpdateConfigArgs.builder()
.maxUnavailable(1)
.build())
.build(), CustomResourceOptions.builder()
.dependsOn(
aws_iam_role_policy_attachment.example-AmazonEKSWorkerNodePolicy(),
aws_iam_role_policy_attachment.example-AmazonEKS_CNI_Policy(),
aws_iam_role_policy_attachment.example-AmazonEC2ContainerRegistryReadOnly())
.build());
}
}
import pulumi
import pulumi_aws as aws
example = aws.eks.NodeGroup("example",
cluster_name=aws_eks_cluster["example"]["name"],
node_role_arn=aws_iam_role["example"]["arn"],
subnet_ids=[__item["id"] for __item in aws_subnet["example"]],
scaling_config=aws.eks.NodeGroupScalingConfigArgs(
desired_size=1,
max_size=2,
min_size=1,
),
update_config=aws.eks.NodeGroupUpdateConfigArgs(
max_unavailable=1,
),
opts=pulumi.ResourceOptions(depends_on=[
aws_iam_role_policy_attachment["example-AmazonEKSWorkerNodePolicy"],
aws_iam_role_policy_attachment["example-AmazonEKS_CNI_Policy"],
aws_iam_role_policy_attachment["example-AmazonEC2ContainerRegistryReadOnly"],
]))
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.eks.NodeGroup("example", {
clusterName: aws_eks_cluster.example.name,
nodeRoleArn: aws_iam_role.example.arn,
subnetIds: aws_subnet.example.map(__item => __item.id),
scalingConfig: {
desiredSize: 1,
maxSize: 2,
minSize: 1,
},
updateConfig: {
maxUnavailable: 1,
},
}, {
dependsOn: [
aws_iam_role_policy_attachment["example-AmazonEKSWorkerNodePolicy"],
aws_iam_role_policy_attachment["example-AmazonEKS_CNI_Policy"],
aws_iam_role_policy_attachment["example-AmazonEC2ContainerRegistryReadOnly"],
],
});
Coming soon!
Ignoring Changes to Desired Size
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
// ... other configurations ...
var example = new Aws.Eks.NodeGroup("example", new()
{
ScalingConfig = new Aws.Eks.Inputs.NodeGroupScalingConfigArgs
{
DesiredSize = 2,
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/eks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := eks.NewNodeGroup(ctx, "example", &eks.NodeGroupArgs{
ScalingConfig: &eks.NodeGroupScalingConfigArgs{
DesiredSize: pulumi.Int(2),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.eks.NodeGroup;
import com.pulumi.aws.eks.NodeGroupArgs;
import com.pulumi.aws.eks.inputs.NodeGroupScalingConfigArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new NodeGroup("example", NodeGroupArgs.builder()
.scalingConfig(NodeGroupScalingConfigArgs.builder()
.desiredSize(2)
.build())
.build());
}
}
import pulumi
import pulumi_aws as aws
# ... other configurations ...
example = aws.eks.NodeGroup("example", scaling_config=aws.eks.NodeGroupScalingConfigArgs(
desired_size=2,
))
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
// ... other configurations ...
const example = new aws.eks.NodeGroup("example", {scalingConfig: {
desiredSize: 2,
}});
resources:
example:
type: aws:eks:NodeGroup
properties:
scalingConfig:
desiredSize: 2
Example IAM Role for EKS Node Group
using System.Collections.Generic;
using System.Linq;
using System.Text.Json;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Iam.Role("example", new()
{
AssumeRolePolicy = JsonSerializer.Serialize(new Dictionary<string, object?>
{
["Statement"] = new[]
{
new Dictionary<string, object?>
{
["Action"] = "sts:AssumeRole",
["Effect"] = "Allow",
["Principal"] = new Dictionary<string, object?>
{
["Service"] = "ec2.amazonaws.com",
},
},
},
["Version"] = "2012-10-17",
}),
});
var example_AmazonEKSWorkerNodePolicy = new Aws.Iam.RolePolicyAttachment("example-AmazonEKSWorkerNodePolicy", new()
{
PolicyArn = "arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy",
Role = example.Name,
});
var example_AmazonEKSCNIPolicy = new Aws.Iam.RolePolicyAttachment("example-AmazonEKSCNIPolicy", new()
{
PolicyArn = "arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy",
Role = example.Name,
});
var example_AmazonEC2ContainerRegistryReadOnly = new Aws.Iam.RolePolicyAttachment("example-AmazonEC2ContainerRegistryReadOnly", new()
{
PolicyArn = "arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly",
Role = example.Name,
});
});
package main
import (
"encoding/json"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/iam"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
tmpJSON0, err := json.Marshal(map[string]interface{}{
"Statement": []map[string]interface{}{
map[string]interface{}{
"Action": "sts:AssumeRole",
"Effect": "Allow",
"Principal": map[string]interface{}{
"Service": "ec2.amazonaws.com",
},
},
},
"Version": "2012-10-17",
})
if err != nil {
return err
}
json0 := string(tmpJSON0)
example, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
AssumeRolePolicy: pulumi.String(json0),
})
if err != nil {
return err
}
_, err = iam.NewRolePolicyAttachment(ctx, "example-AmazonEKSWorkerNodePolicy", &iam.RolePolicyAttachmentArgs{
PolicyArn: pulumi.String("arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy"),
Role: example.Name,
})
if err != nil {
return err
}
_, err = iam.NewRolePolicyAttachment(ctx, "example-AmazonEKSCNIPolicy", &iam.RolePolicyAttachmentArgs{
PolicyArn: pulumi.String("arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy"),
Role: example.Name,
})
if err != nil {
return err
}
_, err = iam.NewRolePolicyAttachment(ctx, "example-AmazonEC2ContainerRegistryReadOnly", &iam.RolePolicyAttachmentArgs{
PolicyArn: pulumi.String("arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly"),
Role: example.Name,
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.iam.Role;
import com.pulumi.aws.iam.RoleArgs;
import com.pulumi.aws.iam.RolePolicyAttachment;
import com.pulumi.aws.iam.RolePolicyAttachmentArgs;
import static com.pulumi.codegen.internal.Serialization.*;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new Role("example", RoleArgs.builder()
.assumeRolePolicy(serializeJson(
jsonObject(
jsonProperty("Statement", jsonArray(jsonObject(
jsonProperty("Action", "sts:AssumeRole"),
jsonProperty("Effect", "Allow"),
jsonProperty("Principal", jsonObject(
jsonProperty("Service", "ec2.amazonaws.com")
))
))),
jsonProperty("Version", "2012-10-17")
)))
.build());
var example_AmazonEKSWorkerNodePolicy = new RolePolicyAttachment("example-AmazonEKSWorkerNodePolicy", RolePolicyAttachmentArgs.builder()
.policyArn("arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy")
.role(example.name())
.build());
var example_AmazonEKSCNIPolicy = new RolePolicyAttachment("example-AmazonEKSCNIPolicy", RolePolicyAttachmentArgs.builder()
.policyArn("arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy")
.role(example.name())
.build());
var example_AmazonEC2ContainerRegistryReadOnly = new RolePolicyAttachment("example-AmazonEC2ContainerRegistryReadOnly", RolePolicyAttachmentArgs.builder()
.policyArn("arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly")
.role(example.name())
.build());
}
}
import pulumi
import json
import pulumi_aws as aws
example = aws.iam.Role("example", assume_role_policy=json.dumps({
"Statement": [{
"Action": "sts:AssumeRole",
"Effect": "Allow",
"Principal": {
"Service": "ec2.amazonaws.com",
},
}],
"Version": "2012-10-17",
}))
example__amazon_eks_worker_node_policy = aws.iam.RolePolicyAttachment("example-AmazonEKSWorkerNodePolicy",
policy_arn="arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy",
role=example.name)
example__amazon_ekscni_policy = aws.iam.RolePolicyAttachment("example-AmazonEKSCNIPolicy",
policy_arn="arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy",
role=example.name)
example__amazon_ec2_container_registry_read_only = aws.iam.RolePolicyAttachment("example-AmazonEC2ContainerRegistryReadOnly",
policy_arn="arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly",
role=example.name)
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.iam.Role("example", {assumeRolePolicy: JSON.stringify({
Statement: [{
Action: "sts:AssumeRole",
Effect: "Allow",
Principal: {
Service: "ec2.amazonaws.com",
},
}],
Version: "2012-10-17",
})});
const example_AmazonEKSWorkerNodePolicy = new aws.iam.RolePolicyAttachment("example-AmazonEKSWorkerNodePolicy", {
policyArn: "arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy",
role: example.name,
});
const example_AmazonEKSCNIPolicy = new aws.iam.RolePolicyAttachment("example-AmazonEKSCNIPolicy", {
policyArn: "arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy",
role: example.name,
});
const example_AmazonEC2ContainerRegistryReadOnly = new aws.iam.RolePolicyAttachment("example-AmazonEC2ContainerRegistryReadOnly", {
policyArn: "arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly",
role: example.name,
});
resources:
example:
type: aws:iam:Role
properties:
assumeRolePolicy:
fn::toJSON:
Statement:
- Action: sts:AssumeRole
Effect: Allow
Principal:
Service: ec2.amazonaws.com
Version: 2012-10-17
example-AmazonEKSWorkerNodePolicy:
type: aws:iam:RolePolicyAttachment
properties:
policyArn: arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy
role: ${example.name}
example-AmazonEKSCNIPolicy:
type: aws:iam:RolePolicyAttachment
properties:
policyArn: arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy
role: ${example.name}
example-AmazonEC2ContainerRegistryReadOnly:
type: aws:iam:RolePolicyAttachment
properties:
policyArn: arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly
role: ${example.name}
Create NodeGroup Resource
new NodeGroup(name: string, args: NodeGroupArgs, opts?: CustomResourceOptions);
@overload
def NodeGroup(resource_name: str,
opts: Optional[ResourceOptions] = None,
ami_type: Optional[str] = None,
capacity_type: Optional[str] = None,
cluster_name: Optional[str] = None,
disk_size: Optional[int] = None,
force_update_version: Optional[bool] = None,
instance_types: Optional[Sequence[str]] = None,
labels: Optional[Mapping[str, str]] = None,
launch_template: Optional[NodeGroupLaunchTemplateArgs] = None,
node_group_name: Optional[str] = None,
node_group_name_prefix: Optional[str] = None,
node_role_arn: Optional[str] = None,
release_version: Optional[str] = None,
remote_access: Optional[NodeGroupRemoteAccessArgs] = None,
scaling_config: Optional[NodeGroupScalingConfigArgs] = None,
subnet_ids: Optional[Sequence[str]] = None,
tags: Optional[Mapping[str, str]] = None,
taints: Optional[Sequence[NodeGroupTaintArgs]] = None,
update_config: Optional[NodeGroupUpdateConfigArgs] = None,
version: Optional[str] = None)
@overload
def NodeGroup(resource_name: str,
args: NodeGroupArgs,
opts: Optional[ResourceOptions] = None)
func NewNodeGroup(ctx *Context, name string, args NodeGroupArgs, opts ...ResourceOption) (*NodeGroup, error)
public NodeGroup(string name, NodeGroupArgs args, CustomResourceOptions? opts = null)
public NodeGroup(String name, NodeGroupArgs args)
public NodeGroup(String name, NodeGroupArgs args, CustomResourceOptions options)
type: aws:eks:NodeGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NodeGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args NodeGroupArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args NodeGroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NodeGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args NodeGroupArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
NodeGroup Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The NodeGroup resource accepts the following input properties:
- Cluster
Name string Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- Node
Role stringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- Scaling
Config Pulumi.Aws. Eks. Inputs. Node Group Scaling Config Args Configuration block with scaling settings. Detailed below.
- Subnet
Ids List<string> Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- Ami
Type string Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- Capacity
Type string Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- Disk
Size int Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- Force
Update boolVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- Instance
Types List<string> List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- Labels Dictionary<string, string>
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- Launch
Template Pulumi.Aws. Eks. Inputs. Node Group Launch Template Args Configuration block with Launch Template settings. Detailed below.
- Node
Group stringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- Node
Group stringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- Release
Version string AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- Remote
Access Pulumi.Aws. Eks. Inputs. Node Group Remote Access Args Configuration block with remote access settings. Detailed below.
- Dictionary<string, string>
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Taints
List<Pulumi.
Aws. Eks. Inputs. Node Group Taint Args> The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- Update
Config Pulumi.Aws. Eks. Inputs. Node Group Update Config Args - Version string
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- Cluster
Name string Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- Node
Role stringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- Scaling
Config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- Subnet
Ids []string Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- Ami
Type string Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- Capacity
Type string Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- Disk
Size int Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- Force
Update boolVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- Instance
Types []string List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- Labels map[string]string
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- Launch
Template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- Node
Group stringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- Node
Group stringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- Release
Version string AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- Remote
Access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- map[string]string
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Taints
[]Node
Group Taint Args The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- Update
Config NodeGroup Update Config Args - Version string
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- cluster
Name String Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- node
Role StringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- scaling
Config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- subnet
Ids List<String> Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- ami
Type String Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- capacity
Type String Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- disk
Size Integer Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force
Update BooleanVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance
Types List<String> List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels Map<String,String>
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch
Template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- node
Group StringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node
Group StringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- release
Version String AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote
Access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- Map<String,String>
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- taints
List<Node
Group Taint Args> The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update
Config NodeGroup Update Config Args - version String
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- cluster
Name string Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- node
Role stringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- scaling
Config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- subnet
Ids string[] Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- ami
Type string Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- capacity
Type string Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- disk
Size number Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force
Update booleanVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance
Types string[] List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels {[key: string]: string}
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch
Template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- node
Group stringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node
Group stringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- release
Version string AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote
Access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- {[key: string]: string}
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- taints
Node
Group Taint Args[] The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update
Config NodeGroup Update Config Args - version string
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- cluster_
name str Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- node_
role_ strarn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- scaling_
config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- subnet_
ids Sequence[str] Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- ami_
type str Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- capacity_
type str Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- disk_
size int Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force_
update_ boolversion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance_
types Sequence[str] List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels Mapping[str, str]
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch_
template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- node_
group_ strname Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node_
group_ strname_ prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- release_
version str AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote_
access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- Mapping[str, str]
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- taints
Sequence[Node
Group Taint Args] The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update_
config NodeGroup Update Config Args - version str
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- cluster
Name String Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- node
Role StringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- scaling
Config Property Map Configuration block with scaling settings. Detailed below.
- subnet
Ids List<String> Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- ami
Type String Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- capacity
Type String Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- disk
Size Number Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force
Update BooleanVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance
Types List<String> List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels Map<String>
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch
Template Property Map Configuration block with Launch Template settings. Detailed below.
- node
Group StringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node
Group StringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- release
Version String AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote
Access Property Map Configuration block with remote access settings. Detailed below.
- Map<String>
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- taints List<Property Map>
The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update
Config Property Map - version String
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
Outputs
All input properties are implicitly available as output properties. Additionally, the NodeGroup resource produces the following output properties:
- Arn string
Amazon Resource Name (ARN) of the EKS Node Group.
- Id string
The provider-assigned unique ID for this managed resource.
- Resources
List<Pulumi.
Aws. Eks. Outputs. Node Group Resource> List of objects containing information about underlying resources.
- Status string
Status of the EKS Node Group.
- Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- Arn string
Amazon Resource Name (ARN) of the EKS Node Group.
- Id string
The provider-assigned unique ID for this managed resource.
- Resources
[]Node
Group Resource List of objects containing information about underlying resources.
- Status string
Status of the EKS Node Group.
- map[string]string
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
Amazon Resource Name (ARN) of the EKS Node Group.
- id String
The provider-assigned unique ID for this managed resource.
- resources
List<Node
Group Resource> List of objects containing information about underlying resources.
- status String
Status of the EKS Node Group.
- Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn string
Amazon Resource Name (ARN) of the EKS Node Group.
- id string
The provider-assigned unique ID for this managed resource.
- resources
Node
Group Resource[] List of objects containing information about underlying resources.
- status string
Status of the EKS Node Group.
- {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn str
Amazon Resource Name (ARN) of the EKS Node Group.
- id str
The provider-assigned unique ID for this managed resource.
- resources
Sequence[Node
Group Resource] List of objects containing information about underlying resources.
- status str
Status of the EKS Node Group.
- Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
Amazon Resource Name (ARN) of the EKS Node Group.
- id String
The provider-assigned unique ID for this managed resource.
- resources List<Property Map>
List of objects containing information about underlying resources.
- status String
Status of the EKS Node Group.
- Map<String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
Look up Existing NodeGroup Resource
Get an existing NodeGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: NodeGroupState, opts?: CustomResourceOptions): NodeGroup
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
ami_type: Optional[str] = None,
arn: Optional[str] = None,
capacity_type: Optional[str] = None,
cluster_name: Optional[str] = None,
disk_size: Optional[int] = None,
force_update_version: Optional[bool] = None,
instance_types: Optional[Sequence[str]] = None,
labels: Optional[Mapping[str, str]] = None,
launch_template: Optional[NodeGroupLaunchTemplateArgs] = None,
node_group_name: Optional[str] = None,
node_group_name_prefix: Optional[str] = None,
node_role_arn: Optional[str] = None,
release_version: Optional[str] = None,
remote_access: Optional[NodeGroupRemoteAccessArgs] = None,
resources: Optional[Sequence[NodeGroupResourceArgs]] = None,
scaling_config: Optional[NodeGroupScalingConfigArgs] = None,
status: Optional[str] = None,
subnet_ids: Optional[Sequence[str]] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
taints: Optional[Sequence[NodeGroupTaintArgs]] = None,
update_config: Optional[NodeGroupUpdateConfigArgs] = None,
version: Optional[str] = None) -> NodeGroup
func GetNodeGroup(ctx *Context, name string, id IDInput, state *NodeGroupState, opts ...ResourceOption) (*NodeGroup, error)
public static NodeGroup Get(string name, Input<string> id, NodeGroupState? state, CustomResourceOptions? opts = null)
public static NodeGroup get(String name, Output<String> id, NodeGroupState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Ami
Type string Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- Arn string
Amazon Resource Name (ARN) of the EKS Node Group.
- Capacity
Type string Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- Cluster
Name string Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- Disk
Size int Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- Force
Update boolVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- Instance
Types List<string> List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- Labels Dictionary<string, string>
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- Launch
Template Pulumi.Aws. Eks. Inputs. Node Group Launch Template Args Configuration block with Launch Template settings. Detailed below.
- Node
Group stringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- Node
Group stringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- Node
Role stringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- Release
Version string AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- Remote
Access Pulumi.Aws. Eks. Inputs. Node Group Remote Access Args Configuration block with remote access settings. Detailed below.
- Resources
List<Pulumi.
Aws. Eks. Inputs. Node Group Resource Args> List of objects containing information about underlying resources.
- Scaling
Config Pulumi.Aws. Eks. Inputs. Node Group Scaling Config Args Configuration block with scaling settings. Detailed below.
- Status string
Status of the EKS Node Group.
- Subnet
Ids List<string> Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- Dictionary<string, string>
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.- Taints
List<Pulumi.
Aws. Eks. Inputs. Node Group Taint Args> The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- Update
Config Pulumi.Aws. Eks. Inputs. Node Group Update Config Args - Version string
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- Ami
Type string Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- Arn string
Amazon Resource Name (ARN) of the EKS Node Group.
- Capacity
Type string Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- Cluster
Name string Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- Disk
Size int Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- Force
Update boolVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- Instance
Types []string List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- Labels map[string]string
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- Launch
Template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- Node
Group stringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- Node
Group stringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- Node
Role stringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- Release
Version string AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- Remote
Access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- Resources
[]Node
Group Resource Args List of objects containing information about underlying resources.
- Scaling
Config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- Status string
Status of the EKS Node Group.
- Subnet
Ids []string Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- map[string]string
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- map[string]string
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.- Taints
[]Node
Group Taint Args The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- Update
Config NodeGroup Update Config Args - Version string
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- ami
Type String Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- arn String
Amazon Resource Name (ARN) of the EKS Node Group.
- capacity
Type String Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- cluster
Name String Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- disk
Size Integer Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force
Update BooleanVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance
Types List<String> List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels Map<String,String>
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch
Template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- node
Group StringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node
Group StringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- node
Role StringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- release
Version String AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote
Access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- resources
List<Node
Group Resource Args> List of objects containing information about underlying resources.
- scaling
Config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- status String
Status of the EKS Node Group.
- subnet
Ids List<String> Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- Map<String,String>
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.- taints
List<Node
Group Taint Args> The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update
Config NodeGroup Update Config Args - version String
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- ami
Type string Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- arn string
Amazon Resource Name (ARN) of the EKS Node Group.
- capacity
Type string Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- cluster
Name string Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- disk
Size number Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force
Update booleanVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance
Types string[] List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels {[key: string]: string}
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch
Template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- node
Group stringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node
Group stringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- node
Role stringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- release
Version string AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote
Access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- resources
Node
Group Resource Args[] List of objects containing information about underlying resources.
- scaling
Config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- status string
Status of the EKS Node Group.
- subnet
Ids string[] Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- {[key: string]: string}
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.- taints
Node
Group Taint Args[] The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update
Config NodeGroup Update Config Args - version string
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- ami_
type str Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- arn str
Amazon Resource Name (ARN) of the EKS Node Group.
- capacity_
type str Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- cluster_
name str Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- disk_
size int Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force_
update_ boolversion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance_
types Sequence[str] List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels Mapping[str, str]
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch_
template NodeGroup Launch Template Args Configuration block with Launch Template settings. Detailed below.
- node_
group_ strname Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node_
group_ strname_ prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- node_
role_ strarn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- release_
version str AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote_
access NodeGroup Remote Access Args Configuration block with remote access settings. Detailed below.
- resources
Sequence[Node
Group Resource Args] List of objects containing information about underlying resources.
- scaling_
config NodeGroup Scaling Config Args Configuration block with scaling settings. Detailed below.
- status str
Status of the EKS Node Group.
- subnet_
ids Sequence[str] Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- Mapping[str, str]
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.- taints
Sequence[Node
Group Taint Args] The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update_
config NodeGroup Update Config Args - version str
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
- ami
Type String Type of Amazon Machine Image (AMI) associated with the EKS Node Group. See the AWS documentation for valid values. This provider will only perform drift detection if a configuration value is provided.
- arn String
Amazon Resource Name (ARN) of the EKS Node Group.
- capacity
Type String Type of capacity associated with the EKS Node Group. Valid values:
ON_DEMAND
,SPOT
. This provider will only perform drift detection if a configuration value is provided.- cluster
Name String Name of the EKS Cluster. Must be between 1-100 characters in length. Must begin with an alphanumeric character, and must only contain alphanumeric characters, dashes and underscores (
^[0-9A-Za-z][A-Za-z0-9\-_]+$
).- disk
Size Number Disk size in GiB for worker nodes. Defaults to
50
for Windows,20
all other node groups. The provider will only perform drift detection if a configuration value is provided.- force
Update BooleanVersion Force version update if existing pods are unable to be drained due to a pod disruption budget issue.
- instance
Types List<String> List of instance types associated with the EKS Node Group. Defaults to
["t3.medium"]
. The provider will only perform drift detection if a configuration value is provided.- labels Map<String>
Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.
- launch
Template Property Map Configuration block with Launch Template settings. Detailed below.
- node
Group StringName Name of the EKS Node Group. If omitted, the provider will assign a random, unique name. Conflicts with
node_group_name_prefix
. The node group name can't be longer than 63 characters. It must start with a letter or digit, but can also include hyphens and underscores for the remaining characters.- node
Group StringName Prefix Creates a unique name beginning with the specified prefix. Conflicts with
node_group_name
.- node
Role StringArn Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.
- release
Version String AMI version of the EKS Node Group. Defaults to latest version for Kubernetes version.
- remote
Access Property Map Configuration block with remote access settings. Detailed below.
- resources List<Property Map>
List of objects containing information about underlying resources.
- scaling
Config Property Map Configuration block with scaling settings. Detailed below.
- status String
Status of the EKS Node Group.
- subnet
Ids List<String> Identifiers of EC2 Subnets to associate with the EKS Node Group. These subnets must have the following resource tag:
kubernetes.io/cluster/CLUSTER_NAME
(whereCLUSTER_NAME
is replaced with the name of the EKS Cluster).- Map<String>
Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Map<String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.- taints List<Property Map>
The Kubernetes taints to be applied to the nodes in the node group. Maximum of 50 taints per node group. Detailed below.
- update
Config Property Map - version String
Kubernetes version. Defaults to EKS Cluster Kubernetes version. The provider will only perform drift detection if a configuration value is provided.
Supporting Types
NodeGroupLaunchTemplate
- Version string
EC2 Launch Template version number. While the API accepts values like
$Default
and$Latest
, the API will convert the value to the associated version number (e.g.,1
) on read and the provider will show a difference on next plan. Using thedefault_version
orlatest_version
attribute of theaws.ec2.LaunchTemplate
resource or data source is recommended for this argument.- Id string
Identifier of the EC2 Launch Template. Conflicts with
name
.- Name string
Name of the EC2 Launch Template. Conflicts with
id
.
- Version string
EC2 Launch Template version number. While the API accepts values like
$Default
and$Latest
, the API will convert the value to the associated version number (e.g.,1
) on read and the provider will show a difference on next plan. Using thedefault_version
orlatest_version
attribute of theaws.ec2.LaunchTemplate
resource or data source is recommended for this argument.- Id string
Identifier of the EC2 Launch Template. Conflicts with
name
.- Name string
Name of the EC2 Launch Template. Conflicts with
id
.
- version String
EC2 Launch Template version number. While the API accepts values like
$Default
and$Latest
, the API will convert the value to the associated version number (e.g.,1
) on read and the provider will show a difference on next plan. Using thedefault_version
orlatest_version
attribute of theaws.ec2.LaunchTemplate
resource or data source is recommended for this argument.- id String
Identifier of the EC2 Launch Template. Conflicts with
name
.- name String
Name of the EC2 Launch Template. Conflicts with
id
.
- version string
EC2 Launch Template version number. While the API accepts values like
$Default
and$Latest
, the API will convert the value to the associated version number (e.g.,1
) on read and the provider will show a difference on next plan. Using thedefault_version
orlatest_version
attribute of theaws.ec2.LaunchTemplate
resource or data source is recommended for this argument.- id string
Identifier of the EC2 Launch Template. Conflicts with
name
.- name string
Name of the EC2 Launch Template. Conflicts with
id
.
- version str
EC2 Launch Template version number. While the API accepts values like
$Default
and$Latest
, the API will convert the value to the associated version number (e.g.,1
) on read and the provider will show a difference on next plan. Using thedefault_version
orlatest_version
attribute of theaws.ec2.LaunchTemplate
resource or data source is recommended for this argument.- id str
Identifier of the EC2 Launch Template. Conflicts with
name
.- name str
Name of the EC2 Launch Template. Conflicts with
id
.
- version String
EC2 Launch Template version number. While the API accepts values like
$Default
and$Latest
, the API will convert the value to the associated version number (e.g.,1
) on read and the provider will show a difference on next plan. Using thedefault_version
orlatest_version
attribute of theaws.ec2.LaunchTemplate
resource or data source is recommended for this argument.- id String
Identifier of the EC2 Launch Template. Conflicts with
name
.- name String
Name of the EC2 Launch Template. Conflicts with
id
.
NodeGroupRemoteAccess
- Ec2Ssh
Key string EC2 Key Pair name that provides access for remote communication with the worker nodes in the EKS Node Group. If you specify this configuration, but do not specify
source_security_group_ids
when you create an EKS Node Group, either port 3389 for Windows, or port 22 for all other operating systems is opened on the worker nodes to the Internet (0.0.0.0/0). For Windows nodes, this will allow you to use RDP, for all others this allows you to SSH into the worker nodes.- Source
Security List<string>Group Ids Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes. If you specify
ec2_ssh_key
, but do not specify this configuration when you create an EKS Node Group, port 22 on the worker nodes is opened to the Internet (0.0.0.0/0).
- Ec2Ssh
Key string EC2 Key Pair name that provides access for remote communication with the worker nodes in the EKS Node Group. If you specify this configuration, but do not specify
source_security_group_ids
when you create an EKS Node Group, either port 3389 for Windows, or port 22 for all other operating systems is opened on the worker nodes to the Internet (0.0.0.0/0). For Windows nodes, this will allow you to use RDP, for all others this allows you to SSH into the worker nodes.- Source
Security []stringGroup Ids Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes. If you specify
ec2_ssh_key
, but do not specify this configuration when you create an EKS Node Group, port 22 on the worker nodes is opened to the Internet (0.0.0.0/0).
- ec2Ssh
Key String EC2 Key Pair name that provides access for remote communication with the worker nodes in the EKS Node Group. If you specify this configuration, but do not specify
source_security_group_ids
when you create an EKS Node Group, either port 3389 for Windows, or port 22 for all other operating systems is opened on the worker nodes to the Internet (0.0.0.0/0). For Windows nodes, this will allow you to use RDP, for all others this allows you to SSH into the worker nodes.- source
Security List<String>Group Ids Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes. If you specify
ec2_ssh_key
, but do not specify this configuration when you create an EKS Node Group, port 22 on the worker nodes is opened to the Internet (0.0.0.0/0).
- ec2Ssh
Key string EC2 Key Pair name that provides access for remote communication with the worker nodes in the EKS Node Group. If you specify this configuration, but do not specify
source_security_group_ids
when you create an EKS Node Group, either port 3389 for Windows, or port 22 for all other operating systems is opened on the worker nodes to the Internet (0.0.0.0/0). For Windows nodes, this will allow you to use RDP, for all others this allows you to SSH into the worker nodes.- source
Security string[]Group Ids Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes. If you specify
ec2_ssh_key
, but do not specify this configuration when you create an EKS Node Group, port 22 on the worker nodes is opened to the Internet (0.0.0.0/0).
- ec2_
ssh_ strkey EC2 Key Pair name that provides access for remote communication with the worker nodes in the EKS Node Group. If you specify this configuration, but do not specify
source_security_group_ids
when you create an EKS Node Group, either port 3389 for Windows, or port 22 for all other operating systems is opened on the worker nodes to the Internet (0.0.0.0/0). For Windows nodes, this will allow you to use RDP, for all others this allows you to SSH into the worker nodes.- source_
security_ Sequence[str]group_ ids Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes. If you specify
ec2_ssh_key
, but do not specify this configuration when you create an EKS Node Group, port 22 on the worker nodes is opened to the Internet (0.0.0.0/0).
- ec2Ssh
Key String EC2 Key Pair name that provides access for remote communication with the worker nodes in the EKS Node Group. If you specify this configuration, but do not specify
source_security_group_ids
when you create an EKS Node Group, either port 3389 for Windows, or port 22 for all other operating systems is opened on the worker nodes to the Internet (0.0.0.0/0). For Windows nodes, this will allow you to use RDP, for all others this allows you to SSH into the worker nodes.- source
Security List<String>Group Ids Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes. If you specify
ec2_ssh_key
, but do not specify this configuration when you create an EKS Node Group, port 22 on the worker nodes is opened to the Internet (0.0.0.0/0).
NodeGroupResource
- Autoscaling
Groups List<Pulumi.Aws. Eks. Inputs. Node Group Resource Autoscaling Group> List of objects containing information about AutoScaling Groups.
- Remote
Access stringSecurity Group Id Identifier of the remote access EC2 Security Group.
- Autoscaling
Groups []NodeGroup Resource Autoscaling Group List of objects containing information about AutoScaling Groups.
- Remote
Access stringSecurity Group Id Identifier of the remote access EC2 Security Group.
- autoscaling
Groups List<NodeGroup Resource Autoscaling Group> List of objects containing information about AutoScaling Groups.
- remote
Access StringSecurity Group Id Identifier of the remote access EC2 Security Group.
- autoscaling
Groups NodeGroup Resource Autoscaling Group[] List of objects containing information about AutoScaling Groups.
- remote
Access stringSecurity Group Id Identifier of the remote access EC2 Security Group.
- autoscaling_
groups Sequence[NodeGroup Resource Autoscaling Group] List of objects containing information about AutoScaling Groups.
- remote_
access_ strsecurity_ group_ id Identifier of the remote access EC2 Security Group.
- autoscaling
Groups List<Property Map> List of objects containing information about AutoScaling Groups.
- remote
Access StringSecurity Group Id Identifier of the remote access EC2 Security Group.
NodeGroupResourceAutoscalingGroup
- Name string
Name of the EC2 Launch Template. Conflicts with
id
.
- Name string
Name of the EC2 Launch Template. Conflicts with
id
.
- name String
Name of the EC2 Launch Template. Conflicts with
id
.
- name string
Name of the EC2 Launch Template. Conflicts with
id
.
- name str
Name of the EC2 Launch Template. Conflicts with
id
.
- name String
Name of the EC2 Launch Template. Conflicts with
id
.
NodeGroupScalingConfig
- Desired
Size int Desired number of worker nodes.
- Max
Size int Maximum number of worker nodes.
- Min
Size int Minimum number of worker nodes.
- Desired
Size int Desired number of worker nodes.
- Max
Size int Maximum number of worker nodes.
- Min
Size int Minimum number of worker nodes.
- desired
Size Integer Desired number of worker nodes.
- max
Size Integer Maximum number of worker nodes.
- min
Size Integer Minimum number of worker nodes.
- desired
Size number Desired number of worker nodes.
- max
Size number Maximum number of worker nodes.
- min
Size number Minimum number of worker nodes.
- desired_
size int Desired number of worker nodes.
- max_
size int Maximum number of worker nodes.
- min_
size int Minimum number of worker nodes.
- desired
Size Number Desired number of worker nodes.
- max
Size Number Maximum number of worker nodes.
- min
Size Number Minimum number of worker nodes.
NodeGroupTaint
NodeGroupUpdateConfig
- int
Desired max number of unavailable worker nodes during node group update.
- int
Desired max percentage of unavailable worker nodes during node group update.
- int
Desired max number of unavailable worker nodes during node group update.
- int
Desired max percentage of unavailable worker nodes during node group update.
- Integer
Desired max number of unavailable worker nodes during node group update.
- Integer
Desired max percentage of unavailable worker nodes during node group update.
- number
Desired max number of unavailable worker nodes during node group update.
- number
Desired max percentage of unavailable worker nodes during node group update.
- int
Desired max number of unavailable worker nodes during node group update.
- int
Desired max percentage of unavailable worker nodes during node group update.
- Number
Desired max number of unavailable worker nodes during node group update.
- Number
Desired max percentage of unavailable worker nodes during node group update.
Import
EKS Node Groups can be imported using the cluster_name
and node_group_name
separated by a colon (:
), e.g.,
$ pulumi import aws:eks/nodeGroup:NodeGroup my_node_group my_cluster:my_node_group
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
aws
Terraform Provider.