:_mod-docs-content-type: ASSEMBLY
[id="cluster-api-config-options-aws"]
= Cluster API configuration options for Amazon Web Services
include::_attributes/common-attributes.adoc[]
:context: cluster-api-config-options-aws

toc::[]

[role="_abstract"]
You can change the configuration of your {aws-first} Cluster API machines by updating values in the Cluster API custom resource manifests.

:FeatureName: Managing machines with the Cluster API
include::snippets/technology-preview.adoc[]

The YAML file examples show configurations for an {aws-full} cluster.

You can enable features by updating values in the Cluster API custom resource manifests.

//Sample YAML for CAPI AWS machine template resource
include::modules/capi-yaml-machine-template-aws.adoc[leveloffset=+1]

//Sample YAML for a CAPI AWS compute machine set resource
include::modules/capi-yaml-machine-set-aws.adoc[leveloffset=+1]

////
//Not yet supported, relies on Cluster API CAS support
// Cluster autoscaler GPU labels
include::modules/machine-feature-agnostic-options-label-gpu-autoscaler.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources
* xref:../../../machine_management/applying-autoscaling.adoc#cluster-autoscaler-cr_applying-autoscaling[Cluster autoscaler resource definition]
////

// Elastic Fabric Adapter instances and placement group options
include::modules/machine-feature-aws-existing-placement-group.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html[Elastic Fabric Adapter ({aws-short} documentation)]

* link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#limitations-placement-groups[Placement groups for your Amazon EC2 instances (AWS documentation)]

* link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types[Supported instance types ({aws-short} documentation)]

// Amazon EC2 Instance Metadata Service configuration options
include::modules/machine-feature-aws-imds-options.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html[IMDSv2 ({aws-short} documentation)]

* link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#imds-considerations[Instance metadata access considerations ({aws-short} documentation)]

////
//This link is for a note that does not apply to TP clusters, reassess for Cluster API GA
* xref:../../../machine_configuration/mco-update-boot-images.adoc#mco-update-boot-images[Boot image management]
////

// Dedicated Instances configuration options
include::modules/machine-feature-aws-dedicated-instances.adoc[leveloffset=+2]

// Dedicated Hosts configuration options
include::modules/machine-feature-aws-dedicated-hosts.adoc[leveloffset=+2]

// Dedicated Hosts configuration options for a specific host
include::modules/machine-feature-aws-dedicated-hosts-byo-template.adoc[leveloffset=+2]

// Non-guaranteed Spot Instances and hourly cost limits
include::modules/machine-feature-agnostic-nonguaranteed-instances.adoc[leveloffset=+2]

// Throughput for gp3 drives
include::modules/machine-feature-aws-throughput-capi.adoc[leveloffset=+2]

// Capacity Reservation configuration options
include::modules/machine-feature-agnostic-capacity-reservation.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* link:https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/capacity-reservation-overview.html[On-Demand Capacity Reservations and Capacity Blocks for ML ({aws-short} documentation)]

//Adding a GPU node to a machine set (stesmith)
include::modules/machine-feature-aws-add-nvidia-gpu-node.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* link:https://aws.amazon.com/ec2/instance-types/#Accelerated_Computing[{aws-short} G4dn instance type]

* link:https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/latest/platform-support.html[NVIDIA GPU Operator Community support matrix (NVIDIA documentation)]

* link:https://docs.nvidia.com/ai-enterprise/latest/product-support-matrix/index.html[NVIDIA AI Enterprise support matrix (NVIDIA documentation)]

// //Deploying the Node Feature Discovery Operator (stesmith)
// include::modules/nvidia-gpu-aws-deploying-the-node-feature-discovery-operator.adoc[leveloffset=+1]
