AWS eks documentation change
Summary
Updated documentation for building custom EKS AMIs with NVIDIA drivers. Added specific instructions for G7 instances requiring NVIDIA driver v595+, updated Kubernetes versions in examples, and added Karpenter integration notes.
Security assessment
Changes involve routine updates to AMI build procedures and version requirements. No security vulnerabilities or fixes are mentioned in the diff.
Diff
diff --git a/eks/latest/userguide/eks-ami-build-scripts.md b/eks/latest/userguide/eks-ami-build-scripts.md index 94aaf57be..f7330b774 100644 --- a//eks/latest/userguide/eks-ami-build-scripts.md +++ b//eks/latest/userguide/eks-ami-build-scripts.md @@ -7 +7 @@ -PrerequisitesQuickstart +PrerequisitesCreate a custom AMI @@ -38 +38 @@ When building custom AMIs for GPU instances, it is recommended to build separate -## Quickstart +Install the required [Amazon plugin](https://developer.hashicorp.com/packer/integrations/hashicorp/amazon). @@ -40 +39,0 @@ When building custom AMIs for GPU instances, it is recommended to build separate -This quickstart shows you the commands to create a custom AMI in your AWS account. To learn more about the configurations available to customize your AMI, see the template variables on the [Amazon Linux 2023](https://awslabs.github.io/amazon-eks-ami/usage/al2023/) page. @@ -42,3 +41 @@ This quickstart shows you the commands to create a custom AMI in your AWS accoun -### Prerequisites - -Install the required [Amazon plugin](https://developer.hashicorp.com/packer/integrations/hashicorp/amazon). For example: + packer plugins install github.com/hashicorp/amazon @@ -45,0 +43 @@ Install the required [Amazon plugin](https://developer.hashicorp.com/packer/inte +Verify that Packer is installed. @@ -47 +44,0 @@ Install the required [Amazon plugin](https://developer.hashicorp.com/packer/inte - packer plugins install github.com/hashicorp/amazon @@ -49 +46 @@ Install the required [Amazon plugin](https://developer.hashicorp.com/packer/inte -### Step 1. Setup your environment + packer --version @@ -51 +48 @@ Install the required [Amazon plugin](https://developer.hashicorp.com/packer/inte -Clone or fork the official Amazon EKS AMI repository. For example: +Clone or fork the official Amazon EKS AMI repository. @@ -57 +54 @@ Clone or fork the official Amazon EKS AMI repository. For example: -Verify that Packer is installed: +To view default values and additional options, run the following command. To learn more about the configurations available to customize your AMI, see the template variables on the [Amazon Linux 2023](https://awslabs.github.io/amazon-eks-ami/usage/al2023/) page. @@ -60 +57 @@ Verify that Packer is installed: - packer --version + make help @@ -62 +59 @@ Verify that Packer is installed: -### Step 2. Create a custom AMI +## Create a custom AMI @@ -66 +63 @@ The following are example commands for various custom AMIs. -**Basic NVIDIA AL2 AMI:** +**EKS NVIDIA AL2 AMI** @@ -69 +66 @@ The following are example commands for various custom AMIs. - make k8s=1.31 os_distro=al2 \ + make k8s=1.32 os_distro=al2 \ @@ -71 +68 @@ The following are example commands for various custom AMIs. - nvidia_driver_major_version=560 \ + nvidia_driver_major_version=580 \ @@ -74 +71 @@ The following are example commands for various custom AMIs. -**Basic NVIDIA AL2023 AMI:** +**EKS NVIDIA AL2023 AMI** @@ -77 +74,15 @@ The following are example commands for various custom AMIs. - make k8s=1.31 os_distro=al2023 \ + make k8s=1.36 os_distro=al2023 \ + enable_accelerator=nvidia \ + nvidia_driver_major_version=580 \ + enable_efa=true + +**EKS NVIDIA AL2023 AMI with NVIDIA driver version 595** + +###### Important + +The G7 EC2 instance type requires NVIDIA driver version 595 or later. The EKS-optimized accelerated AMIs currently include NVIDIA driver version 580, which does not support G7 instances. You must build a custom AMI with NVIDIA driver version 595 to use G7 instances with Amazon EKS. + +If you are using Karpenter for node provisioning and auto-scaling, it is recommended to exclude the `g7` instance family from your NodePools that use automatic AMI selection. See [`amiSelectorTerms`](https://karpenter.sh/docs/concepts/nodeclasses/#specamiselectorterms) in the Karpenter documentation for how to configure your Karpenter NodeClass to use your custom AMI for `g7` instances. + + + make k8s=1.36 os_distro=al2023 \ @@ -79 +90 @@ The following are example commands for various custom AMIs. - nvidia_driver_major_version=560 \ + nvidia_driver_major_version=595 \ @@ -91 +102,10 @@ The following are example commands for various custom AMIs. -After you run these commands, Packer will do the following: * Launch a temporary Amazon EC2 instance. * Install Kubernetes components, drivers, and configurations. * Create the AMI in your AWS account. +After you run these commands, Packer will do the following: + + * Launch a temporary Amazon EC2 instance. + + * Install Kubernetes components, drivers, and configurations. + + * Create the AMI in your AWS account. + + + @@ -108,7 +127,0 @@ The expected output should look like this: -### Step 3. View default values - -To view default values and additional options, run the following command: - - - make help -