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

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

# Amazon EKS 추가 기능 버전의 클러스터와의 호환성 확인
<a name="addon-compat"></a>

Amazon EKS 추가 기능을 생성하기 전에 Amazon EKS 추가 기능 버전이 클러스터와 호환되는지 확인해야 합니다.

[describe-addon-versions API](https://docs.aws.amazon.com/eks/latest/APIReference/API_DescribeAddonVersions.html)를 사용하여 EKS 추가 기능의 사용 가능한 버전과 각 추가 기능 버전에서 지원하는 Kubernetes 버전을 나열합니다.

1. `aws sts get-caller-identity` 명령으로 AWS CLI가 설치되어 작동하고 있는지 확인합니다. 이 명령이 작동하지 않는 경우 [AWS CLI 시작](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 방법을 알아봅니다.

1. 버전 호환성 정보를 검색하려는 추가 기능의 이름(예: `amazon-cloudwatch-observability`)을 확인합니다.

1. 클러스터의 Kubernetes 버전(예: `1.35`)을 확인합니다.

1. AWS CLI를 사용하여 클러스터의 Kubernetes 버전과 호환되는 추가 기능 버전을 검색합니다.

   ```
   aws eks describe-addon-versions --addon-name amazon-cloudwatch-observability --kubernetes-version 1.35
   ```

   예제 출력은 다음과 같습니다.

   ```
   {
       "addons": [
           {
               "addonName": "amazon-cloudwatch-observability",
               "type": "observability",
               "addonVersions": [
                   {
                       "addonVersion": "vX.X.X-eksbuild.X",
                       "architecture": [
                           "amd64",
                           "arm64"
                       ],
                       "computeTypes": [
                           "ec2",
                           "auto",
                           "hybrid"
                       ],
                       "compatibilities": [
                           {
                               "clusterVersion": "1.35",
                               "platformVersions": [
                                   "*"
                               ],
                               "defaultVersion": true
                           }
                       ],
                   }
               ]
           }
       ]
   }
   ```

   이 출력은 추가 기능 버전 `vX.X.X-eksbuild.X`이 Kubernetes 클러스터 버전 `1.35`과 호환됨을 보여줍니다.

## 컴퓨팅 유형과의 추가 기능 호환성
<a name="_add_on_compatibility_with_compute_types"></a>

`describe-addon-versions` 출력의 `computeTypes` 필드는 추가 기능이 EKS Auto Mode 관리형 노드 또는 하이브리드 노드와 호환됨을 나타냅니다. `auto`로 표시된 추가 기능은 EKS Auto Mode의 클라우드 기반 AWS 관리형 인프라에서 작동하는 반면 `hybrid`로 표시된 추가 기능은 EKS 클라우드 컨트롤 플레인에 연결된 온프레미스 노드에서 실행 가능합니다.

자세한 내용은 [Amazon EKS Auto Mode 고려 사항](eks-add-ons.md#addon-consider-auto) 섹션을 참조하세요.