Azure Arc에서 사용하도록 설정된 AKS의 알려진 문제
적용 대상: Azure Local, 버전 23H2
이 문서에서는 Arc on Azure Local 버전 23H2에서 사용하도록 설정된 AKS의 중요한 알려진 문제 및 해결 방법을 식별합니다.
이 문서에서는 모든 Azure 로컬 버전 23H2 릴리스에 대한 AKS Arc의 알려진 문제에 대해 설명합니다. 이러한 알려진 문제는 지속적으로 업데이트되며, 해결 방법이 필요한 중요한 문제가 발견되면 추가됩니다. Azure Local에 Kubernetes 클러스터를 배포하기 전에 이 정보를 주의 깊게 검토합니다.
버전 2311.2의 알려진 문제(일반 공급 릴리스)
이 릴리스는 Azure Local의 소프트웨어 버전 10.2311.2.7에 매핑됩니다.
| 기능 | 문제 | 설명/해결 방법 |
|---|---|---|
| 클러스터 배포 | Azure 로컬 사용자 지정 위치의 지역과 다른 지역에서 Azure CLI를 사용하여 Kubernetes 클러스터를 만들면 기본 노드 풀에 대한 작업이 실패합니다. | Azure 로컬 사용자 지정 위치 지역과 동일한 지역에 리소스 그룹을 만듭니다. Azure CLI를 사용하여 Kubernetes 클러스터를 만들려면 기본 옵션을 사용합니다. |
| Azure 로컬 업그레이드 | Azure 로컬 클러스터를 GA(버전 2311.2)로 업그레이드한 후에는 미리 보기 버전(2311.0)에서 만든 클러스터에서 일부 작업(예: 크기 조정 및 업데이트)을 수행할 수 없습니다. | 영향을 받는 클러스터의 Kubernetes 버전을 GA 지원 버전으로 업그레이드하는 데 사용합니다 az aksarc upgrade . 실행 az aksarc get-versions 하여 시스템에서 지원되는 모든 버전을 나열할 수 있습니다. |
| Azure 로컬 업그레이드 | Azure 로컬 클러스터를 GA(버전 2311.2)로 업그레이드한 후에는 클러스터 이름에 31자를 초과하는 경우 미리 보기 버전(2311.0)에서 만든 Kubernetes 클러스터가 제대로 작동하지 않습니다. | 이 클러스터를 삭제하고 31자 미만의 클러스터 이름을 사용하여 새 클러스터를 만듭니다. |
버전 2311의 알려진 문제(미리 보기 릴리스)
이 릴리스는 Azure Local의 소프트웨어 버전 10.2311.0.26에 매핑됩니다.
| 기능 | 문제 | 설명/해결 방법 |
|---|---|---|
| 포털 | 클러스터를 만드는 동안 Kubernetes 버전을 지정하는 것은 Azure Portal에서 지원되지 않습니다. | Azure CLI를 사용하여 지원되는 Kubernetes 버전으로 Kubernetes 클러스터를 만들 수 있습니다. |
| 포털 | Azure Portal에서 Kubernetes 클러스터를 만들 때 사용 가능한 VM 유형 목록이 완료되지 않습니다. | |
| 클러스터 업그레이드 | 대상 Kubernetes 버전을 지정하지 않으면 클러스터 업그레이드 az akshybrid upgrade 에 대한 Azure CLI 명령이 작동하지 않습니다. |
매개 변수를 사용하여 명령을 --version <target version> 실행할 az akshybrid upgrade 때 대상 Kubernetes 버전을 지정해야 합니다. |
| 지원되는 VM 크기 | az akshybrid vmsize 이 명령은 필요한 사용 가능한 VM 유형을 올바르게 반환하지 않습니다. |
10분 동안 기다렸다가 동일한 명령을 다시 실행하여 지원되는 VM 유형을 봅니다. |
| Azure 로컬 업그레이드 | Azure Portal에서 AKS Arc 클러스터를 만들면 "클러스터 확장은 리소스 종류 Microsoft.HybridContainerService/ProvisionedClusterInstances를 api 버전2024-01-01으로 지원하지 않습니다." 오류가 발생합니다. |
Azure Portal은 Azure Local 버전 23H2에서 AKS의 미리 보기를 지원하지 않는 GA 버전으로 업그레이드됩니다. Azure Local을 최신 버전으로 업그레이드해야 합니다. |