View a markdown version of this page

사용자 지정 ECS 최적화 Amazon Linux AMI 빌드 - Amazon EKS
사전 조건사용자 지정 AMI를 생성

이 페이지 개선에 도움 주기

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 GitHub에서 이 페이지 편집 링크를 선택합니다.

사용자 지정 ECS 최적화 Amazon Linux AMI 빌드

주의

Amazon EKS는 2025년 11월 26일 이후 더 이상 EKS 최적화 Amazon Linux 2(AL2) AMI 게시를 중지했습니다. Amazon EKS에 대한 AL2023 및 Bottlerocket 기반 AMI는 1.33 이상을 포함하여 지원되는 모든 Kubernetes 버전에서 사용할 수 있습니다.

Amazon EKS는 kubelet에 대한 구성, AWS IAM Authenticator for Kubernetes를 보고 고유한 AL 기반 AMI를 처음부터 빌드하기 위해 사용할 수 있는 오픈 소스 빌드 스크립트를 Amazon EKS AMI 빌드 사양 리포지토리에 제공합니다.

이 리포지토리에는 부팅 시 실행되는 특수 AL2용 부트스트랩 스크립트와 AL2023용 nodeadm 도구가 포함되어 있습니다. 이러한 스크립트는 인스턴스의 인증서 데이터, 컨트롤 플레인 엔드포인트, 클러스터 이름 등을 구성합니다. 스크립트는 Amazon EKS 최적화 AMI 빌드의 신뢰할 수 있는 소스로 간주되므로 GitHub 리포지토리를 따라 AMI에 대한 변경을 모니터링할 수 있습니다.

EKS 최적화 AMI를 기반으로 사용자 지정 AMI를 빌드하는 경우 운영 체제 업그레이드(즉, dnf upgrade)를 실행하거나 EKS 최적화 AMI에 포함된 Kubernetes 또는 GPU 패키지를 업그레이드하는 것이 지원되지 않거나 권장되지 않습니다. 이 경우 구성 요소 호환성을 위반할 위험이 있기 때문입니다. EKS 최적화 AMI에 포함된 운영 체제 또는 패키지를 업그레이드하는 경우 프로덕션에 배포하기 전에 개발 또는 스테이징 환경에서 철저히 테스트하는 것이 좋습니다.

GPU 인스턴스에 대한 사용자 지정 AMI를 빌드하는 경우 실행할 각 인스턴스 유형 생성 및 패밀리에 대해 별도의 사용자 지정 AMI를 빌드하는 것이 좋습니다. EKS 최적화 가속 AMI는 기본 인스턴스 유형 생성 및 패밀리를 기반으로 런타임에 드라이버와 패키지를 선택적으로 설치합니다. 자세한 내용은 EKS AMI 스크립트에서 installation 및 runtime을 참조하세요.

사전 조건

필요한 Amazon 플러그인을 설치합니다.

packer plugins install github.com/hashicorp/amazon

Packer가 설치되어 있는지 확인합니다.

packer --version

공식 Amazon EKS AMI 리포지토리를 복제하거나 포크합니다.

git clone https://github.com/awslabs/amazon-eks-ami.git
cd amazon-eks-ami

기본값과 추가 옵션을 보려면 다음 명령을 실행합니다. AMI를 사용자 지정하는 데 사용할 수 있는 구성에 대한 자세한 내용은 Amazon Linux 2023 페이지의 템플릿 변수를 참조하세요.

make help

사용자 지정 AMI를 생성

다음은 다양한 사용자 지정 AMI에 대한 명령의 예입니다.

EKS NVIDIA AL2 AMI 

make k8s=1.32 os_distro=al2 \
  enable_accelerator=nvidia \
  nvidia_driver_major_version=580 \
  enable_efa=true

EKS NVIDIA AL2023 AMI 

make k8s=1.36 os_distro=al2023 \
  enable_accelerator=nvidia \
  nvidia_driver_major_version=580 \
  enable_efa=true

NVIDIA 드라이버 버전 595를 사용하는 EKS NVIDIA AL2023 AMI

중요

G7 EC2 인스턴스 유형에는 NVIDIA 드라이버 버전 595 이상이 필요합니다. EKS 최적화 가속 AMI에는 현재 G7 인스턴스를 지원하지 않는 NVIDIA 드라이버 버전 580이 포함되어 있습니다. Amazon EKS에서 G7 인스턴스를 사용하려면 NVIDIA 드라이버 버전 595를 사용하여 사용자 지정 AMI를 빌드해야 합니다.

노드 프로비저닝 및 오토 스케일링에 Karpenter를 사용하는 경우 자동 AMI 선택을 사용하는 NodePool에서 g7 인스턴스 패밀리를 제외하는 것이 좋습니다. g7 인스턴스에 사용자 지정 AMI를 사용하도록 Karpenter NodeClass를 구성하는 방법은 Karpenter 설명서의 amiSelectorTerms를 참조하세요.

make k8s=1.36 os_distro=al2023 \
  enable_accelerator=nvidia \
  nvidia_driver_major_version=595 \
  enable_efa=true

STIG 준수 Neuron AL2023 AMI: 

make k8s=1.31 os_distro=al2023 \
  enable_accelerator=neuron \
  enable_fips=true \
  source_ami_id=ami-0abcd1234efgh5678 \
  kms_key_id=alias/aws-stig

이러한 명령을 실행하면 Packer는 다음 작업을 수행합니다.

  • 임시 Amazon EC2 인스턴스를 시작합니다.

  • Kubernetes 구성 요소, 드라이버 및 구성을 설치합니다.

  • AWS 계정에서 AMI를 생성합니다.

예상되는 출력은 다음과 같아야 합니다.

==> Wait completed after 8 minutes 42 seconds

==> Builds finished. The artifacts of successful builds are:
--> amazon-ebs: AMIs were created:
us-west-2: ami-0e139a4b1a7a9a3e9

--> amazon-ebs: AMIs were created:
us-west-2: ami-0e139a4b1a7a9a3e9

--> amazon-ebs: AMIs were created:
us-west-2: ami-0e139a4b1a7a9a3e9