

 **이 페이지 개선에 도움 주기** 

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

# Image Builder를 사용한 사용자 지정 Windows AMI 구축
<a name="eks-custom-ami-windows"></a>

EC2 Image Builder를 사용하여 다음 옵션 중 하나로 사용자 지정 Amazon EKS 최적화 Windows AMI를 생성할 수 있습니다.
+  [Amazon EKS 최적화 Windows AMI를 기반으로 사용](#custom-windows-ami-as-base) 
+  [Amazon 관리형 빌드 구성 요소 사용](#custom-windows-ami-build-component) 

두 방법 모두 고유한 Image Builder 레시피를 만들어야 합니다. 자세한 내용은 Image Builder 사용 설명서의 [이미지 레시피의 새 버전 생성](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html)을 참조하세요.

**중요**  
`eks`에 대한 다음 **Amazon 관리형** 구성 요소에는 `CVE-2024-5321`에 대한 패치가 포함됩니다.  
 `1.28.2` 이상
 `1.29.2` 이상
 `1.30.1` 이상
Kubernetes 1.31 이상의 모든 버전

## Amazon EKS 최적화 Windows AMI를 기반으로 사용
<a name="custom-windows-ami-as-base"></a>

이 옵션은 사용자 지정 Windows AMI를 구축하는 데 권장되는 방법입니다. AWS에서 제공하는 Amazon EKS 최적화 Windows AMI는 Amazon 관리형 빌드 구성 요소보다 더 자주 업데이트됩니다.

1. 새 Image Builder 레시피를 시작합니다.

   1. https://console.aws.amazon.com/imagebuilder에서 EC2 Image Builder 콘솔을 엽니다.

   1. 왼쪽 탐색 창에서 **이미지 레시피**를 선택합니다.

   1. **이미지 레시피 생성**을 선택합니다.

1. **레시피 세부 정보** 섹션에서 **이름**과 **버전**을 입력합니다.

1. **기본 이미지** 섹션에서 Amazon EKS 최적화 Windows AMI의 ID를 지정합니다.

   1. **사용자 지정 AMI ID 입력**을 선택합니다.

   1. 필요한 Windows OS 버전의 AMI ID를 검색합니다. 자세한 내용은 [권장 Microsoft Windows AMI ID 검색](retrieve-windows-ami-id.md) 섹션을 참조하세요.

   1. 사용자 지정 **AMI ID**를 입력합니다. AMI ID를 찾을 수 없는 경우 AMI ID의 AWS 리전이 콘솔의 오른쪽 상단에 표시된 AWS 리전과 일치하는지 확인합니다.

1. (선택사항) 최신 보안 업데이트를 받으려면 **빌드 구성 요소 - ** 섹션에서 `update-windows` 구성 요소를 추가합니다.

   1. **이름으로 구성 요소 찾기** 검색 상자 오른쪽의 드롭다운 목록에서 **Amazon 관리형**을 선택합니다.

   1. **이름으로 구성 요소 찾기** 상자에 `update-windows`를 입력합니다.

   1. ** `update-windows` ** 검색 결과의 확인란을 선택합니다. 이 구성 요소에는 운영 체제의 최신 Windows 패치가 포함되어 있습니다.

1. 나머지 이미지 레시피 입력을 필요한 구성으로 완료합니다. 자세한 내용은 Image Builder 사용 설명서의 [새 이미지 레시피 버전 생성(콘솔)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html#create-image-recipe-version-console)을 참조하세요.

1. **레시피 생성**을 선택합니다.

1. 신규 또는 기존 이미지 파이프라인에서 새 이미지 레시피를 사용합니다. 이미지 파이프라인이 성공적으로 실행되면 사용자 지정 AMI가 출력 이미지로 나열되고 사용할 준비가 됩니다. 자세한 내용은 [EC2 Image Builder 콘솔 마법사를 사용하여 이미지 파이프라인 생성](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html)을 참조하세요.

## Amazon 관리형 빌드 구성 요소 사용
<a name="custom-windows-ami-build-component"></a>

Amazon EKS 최적화 Windows AMI를 기반으로 사용할 수 없는 경우 Amazon 관리형 빌드 구성 요소를 대신 사용할 수 있습니다. 이 옵션은 지원되는 최신 Kubernetes 버전보다 뒤처질 수 있습니다.

1. 새 Image Builder 레시피를 시작합니다.

   1. https://console.aws.amazon.com/imagebuilder에서 EC2 Image Builder 콘솔을 엽니다.

   1. 왼쪽 탐색 창에서 **이미지 레시피**를 선택합니다.

   1. **이미지 레시피 생성**을 선택합니다.

1. **레시피 세부 정보** 섹션에서 **이름**과 **버전**을 입력합니다.

1. **기본 이미지** 섹션에서 사용자 지정 AMI를 생성하는 데 사용할 옵션을 결정합니다.
   +  **관리형 이미지 선택** - **이미지 운영 체제(OS)**에서 **Windows**를 선택합니다. 그리고 나서 **이미지 오리진**에 대해 다음 옵션 중 하나를 선택합니다.
     +  **빠른 시작(Amazon 관리형)** - **이미지 이름** 드롭다운에서 Amazon EKS 지원 Windows Server 버전을 선택합니다. 자세한 내용은 [최적화된 Windows AMI를 사용한 노드 생성](eks-optimized-windows-ami.md) 섹션을 참조하세요.
     +  **내가 소유한 이미지** - **이미지 이름**으로 자체 라이선스가 있는 이미지의 ARN을 선택합니다. 제공하는 이미지에 Amazon EKS 구성 요소가 이미 설치되어 있을 수 없습니다.
   +  **사용자 지정 AMI ID 입력** - AMI ID에 자체 라이선스가 있는 AMI의 ID를 입력합니다. 제공하는 이미지에 Amazon EKS 구성 요소가 이미 설치되어 있을 수 없습니다.

1. **빌드 구성 요소 - Windows** 섹션에서 다음을 수행합니다.

   1. **이름으로 구성 요소 찾기** 검색 상자 오른쪽의 드롭다운 목록에서 **Amazon 관리형**을 선택합니다.

   1. **이름으로 구성 요소 찾기** 상자에 `eks`를 입력합니다.

   1. 반환되는 결과가 원하는 버전이 아닐 수도 있지만, ** `eks-optimized-ami-windows` ** 검색 결과의 확인란을 선택합니다.

   1. **이름으로 구성 요소 찾기** 상자에 `update-windows`를 입력합니다.

   1. **update-windows** 검색 결과의 확인란을 선택합니다. 이 구성 요소에는 운영 체제의 최신 Windows 패치가 포함되어 있습니다.

1. **선택한 구성 요소** 섹션에서 다음을 수행합니다.

   1. ** `eks-optimized-ami-windows` **의 **버전 관리 옵션**을 선택합니다.

   1. **구성 요소 버전 지정**을 선택합니다.

   1. **구성 요소 버전** 필드에 {{version.x}}를 입력합니다. 이때 {{버전}}을 지원되는 Kubernetes 버전으로 바꿉니다. 버전 번호의 일부로 {{x}}를 입력하면 사용자가 명시적으로 정의하는 버전 부분과도 일치하는 최신 구성 요소 버전을 사용한다는 의미입니다. 콘솔 출력에서 원하는 버전을 관리형 구성 요소로 사용할 수 있는지 여부를 알려주므로 유의하세요. 최신 Kubernetes 버전은 빌드 구성 요소에 사용하지 못할 수 있습니다. 사용 가능한 버전에 대한 자세한 내용은 [`eks-optimized-ami-windows` 구성 요소 버전에 대한 정보 검색](#custom-windows-ami-component-versions) 섹션을 참조하세요.

1. 나머지 이미지 레시피 입력을 필요한 구성으로 완료합니다. 자세한 내용은 Image Builder 사용 설명서의 [새 이미지 레시피 버전 생성(콘솔)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-image-recipes.html#create-image-recipe-version-console)을 참조하세요.

1. **레시피 생성**을 선택합니다.

1. 신규 또는 기존 이미지 파이프라인에서 새 이미지 레시피를 사용합니다. 이미지 파이프라인이 성공적으로 실행되면 사용자 지정 AMI가 출력 이미지로 나열되고 사용할 준비가 됩니다. 자세한 내용은 [EC2 Image Builder 콘솔 마법사를 사용하여 이미지 파이프라인 생성](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html)을 참조하세요.

## `eks-optimized-ami-windows` 구성 요소 버전에 대한 정보 검색
<a name="custom-windows-ami-component-versions"></a>

각 구성 요소와 함께 설치되는 항목에 대한 특정 정보를 검색할 수 있습니다. 예를 들어, 설치된 `kubelet` 버전을 확인할 수 있습니다. 구성 요소는 Amazon EKS 지원 Windows 운영 체제 버전에 대한 기능 테스트를 거칩니다. 자세한 내용은 [출시 일정](eks-optimized-windows-ami.md#windows-ami-release-calendar) 섹션을 참조하세요. 지원되는 것으로 나열되지 않았거나 지원이 종료된 다른 Windows OS 버전은 구성 요소와 호환되지 않을 수 있습니다.

1. https://console.aws.amazon.com/imagebuilder에서 EC2 Image Builder 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **구성 요소**를 선택합니다.

1. **이름으로 구성 요소 찾기** 검색 상자 오른쪽의 드롭다운 목록에서 **내 소유**를 **빠른 시작(Amazon 관리형)**으로 변경합니다.

1. **이름으로 구성 요소 찾기** 상자에 `eks`를 입력합니다.

1. (선택사항) 최신 버전을 사용하는 경우, **버전** 열을 두 번 선택하여 내림차순으로 정렬합니다.

1. 원하는 버전의 ** `eks-optimized-ami-windows` ** 링크를 선택합니다.

결과 페이지의 **설명**에 특정 정보가 표시됩니다.