Skip to main content
Version: v2.13

EC2 Machine Configuration Reference

For more details about EC2 nodes, refer to the official documentation for the EC2 Management Console.

Region​

The geographical region in which to build your cluster.

Zone​

The zone, an isolated location within a region to build your cluster

Instance Type​

The instance type, which determines the hardware characteristics, used to provision your cluster.

Root Disk Size​

Configure the size (in GB) for your root device.

VPC/Subnet​

The VPC or specific subnet, an IP range in your VPC, to add your resources to.

IAM Instance Profile Name​

The name of the instance profile used to pass an IAM role to an EC2 instance.

Advanced Options​

AMI ID​

The Amazon Machine Image used for the nodes in your cluster.

SSH Username for AMI​

The username for connecting to your launched instances. Refer to here for the default usernames to selected AMIs. For AMIs not listed, check with the AMI provider.

Security Group​

Choose the default security group or configure a security group.

Please refer to Amazon EC2 security group when using Node Driver to see what rules are created in the rancher-nodes Security Group.

EBS Root Volume Type​

The EBS volume type to use for the root device.

Encrypt EBS Volume​

Enable Amazon EBS Encryption.

Request Spot Instance​

Enable option to request spot instances and specify the maximum instance price per hour you're willing to pay.

Use only private address​

Enable option on use only private addresses.

EBS-Optimized Instance​

Use an EBS-optimized instance.

Allow access to EC2 metadata​

Enable access to EC2 metadata.

Use tokens for metadata​

Use Instance Metadata Service Version 2 (IMDSv2), a token-based method to access metadata.

Add Tag​

Add metadata using tags to categorize resources.

IPv6 Address Count​

Specify how many IPv6 addresses to assign to the instance’s network interface.

IPv6 Address Only​

Enable this option if the instance should use IPv6 exclusively. IPv6-only VPCs or subnets require this. When enabled, the instance will have IPv6 as its sole address, and the IPv6 Address Count must be greater than zero.

HTTP Protocol IPv6​

Enable or disable IPv6 endpoints for the instance metadata service.

Enable Primary IPv6​

Enable this option to designate the first assigned IPv6 address as the primary address. This ensures a consistent, non-changing IPv6 address for the instance. It does not control whether IPv6 addresses are assigned.