Skip to content

Amazon Linux 2023

Template variables

Variable Description
ami_component_description
ami_description
ami_name
ami_regions
ami_users
arch
associate_public_ip_address
aws_access_key_id
aws_region
aws_secret_access_key
aws_session_token
binary_bucket_name
binary_bucket_region
containerd_version
creator
enable_accelerator Vendor that provides the GPU or accelerator hardware. Currently we support Neuron and NVIDIA.
enable_efa Valid options are true or false. Wheather or not to install the software needed to use AWS Elastic Fabric Adapter (EFA) network interfaces.
enable_fips Install openssl and enable fips related kernel parameters
encrypted
iam_instance_profile The name of an IAM instance profile to launch the EC2 instance with.
instance_type
kms_key_id
kubernetes_build_date
kubernetes_version
launch_block_device_mappings_volume_size
nodeadm_build_image Image to use as a build environment for nodeadm
nvidia_driver_major_version To be used only when enable_accelerator = nvidia. Driver version to install, depends on what is available in NVIDIA repository.
remote_folder Directory path for shell provisioner scripts on the builder instance
runc_version
security_group_id
source_ami_filter_name
source_ami_id
source_ami_owners
ssh_interface If using session_manager, you need to specify a non-minimal ami as the minimal version does not have the SSM agent installed.
ssh_username
ssm_agent_version Version of the SSM agent to install from the S3 bucket provided by the SSM agent project, such as latest. If empty, the latest version of the SSM agent available in the Amazon Linux core repositories will be installed.
subnet_id
temporary_key_pair_type
temporary_security_group_source_cidrs
user_data_file Path to a file that will be used for the user data when launching the instance.
volume_type
working_dir Directory path for ephemeral resources on the builder instance

Accelerated images

One can build images that contain Neuron or Nvidia drivers and runtime configuration. To build Neuron image execute:

make k8s=1.29 os_distro=al2023 enable_accelerator=neuron enable_efa=true

To build NVIDIA image execute:

make k8s=1.29 os_distro=al2023 enable_accelerator=nvidia enable_efa=true

One can pass the NVIDIA driver major version using the following:

make k8s=1.29 os_distro=al2023 enable_accelerator=nvidia enable_efa=true nvidia_driver_major_version=560

To see which driver versions are available, one can check the NVIDIA AL2023 repository.