다음을 통해 공유

Azure Stack Hub의 AKS 엔진에 대한 릴리스 정보

  • 아티클

AKS 엔진의 버전 v0.80.2에 적용됩니다.

이 문서에서는 Azure Stack Hub 업데이트에서 AKS(Azure Kubernetes Service) 엔진의 내용을 설명합니다. 이 업데이트에는 Azure Stack Hub 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대한 개선 사항 및 수정 사항이 포함됩니다. 이 문서는 글로벌 Azure용 AKS 엔진에 대한 릴리스 정보를 문서화하기 위한 것이 아닙니다.

업그레이드 고려 사항

  • 올바른 마켓플레이스 항목, AKS Base Ubuntu 20.04 이미지 배포판 또는 AKS 기본 Windows Server를 AKS 엔진 버전에 사용하고 있나요? 새 이미지 및 AKS 엔진 다운로드 섹션에서 버전을 찾을 수 있습니다.
  • 대상 클러스터에 올바른 클러스터 사양(apimodel.json) 및 리소스 그룹을 사용하고 있나요? 원래 클러스터를 배포했을 때 이 파일은 출력 디렉터리에 생성되었습니다. 배포 명령 매개 변수 Kubernetes 클러스터 배포를 참조하세요.
  • 신뢰할 수 있는 컴퓨터를 사용하여 AKS 엔진을 실행하고 업그레이드 작업을 수행하고 있나요?
  • 활성 워크로드를 사용하여 운영 클러스터를 업데이트하는 경우 클러스터가 정상적인 부하를 받고 있다고 가정하여 업그레이드에 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 리디렉션해야 하는 경우 백업 클러스터가 있어야 합니다. 백업 클러스터를 사용하는 것이 좋습니다.
  • 가능하면 Azure Stack Hub 환경 내의 VM에서 명령을 실행하여 네트워크 홉과 잠재적인 연결 오류를 줄입니다.
  • 구독에 전체 프로세스에 대한 충분한 할당량이 있는지 확인합니다. 프로세스는 프로세스 중에 새 VM을 할당합니다. 결과 VM 수는 원래 VM과 동일하지만 프로세스 중에 몇 가지 VM을 추가로 만들 계획입니다.
  • 시스템 업데이트 또는 예약된 작업은 계획되지 않습니다.
  • 프로덕션 클러스터와 동일한 값으로 구성된 클러스터에서 스테이징된 업그레이드를 설정하고 프로덕션 클러스터에서 업그레이드를 테스트합니다.

업그레이드 명령 사용

Azure Stack Hub의 aks-engine upgrade Kubernetes 클러스터 업그레이드에 설명된 대로 명령을 사용해야 합니다.

업그레이드 중단

예기치 않은 요인으로 클러스터 업그레이드가 중단되는 경우가 있습니다. AKS 엔진이 오류를 보고하거나 AKS 엔진 실행 프로세스에 문제가 발생할 때 중단이 발생할 수 있습니다. 중단의 원인을 검사하고, 해결한 다음, 동일한 upgrade 명령을 다시 제출하여 업그레이드 프로세스를 계속합니다. 명령은 upgrade idempotent이며 명령을 다시 제출한 후 클러스터 업그레이드를 다시 시작해야 합니다. 일반적으로 중단은 업데이트를 완료하는 데 시간이 늘어나지만 완료에 영향을 주지 않아야 합니다.

예상 업그레이드 시간

예상 업그레이드 시간은 클러스터의 VM당 12~15분입니다. 예를 들어 20노드 클러스터를 업그레이드하는 데 약 5시간이 걸릴 수 있습니다.

AKS 엔진 0.70.0 이상을 사용하는 지침

새 이미지 및 AKS 엔진 다운로드

AKS 기본 Ubuntu 이미지 및 AKS 엔진의 새 버전을 다운로드합니다.

Azure Stack Hub용 AKS 엔진 설명서에 설명된 대로 Kubernetes 클러스터를 배포하려면 다음이 필요합니다.

  • aks 엔진 이진(필수)입니다.
  • AKS Base Ubuntu 16.04-LTS 이미지 배포판(더 이상 사용되지 않음, 대신 20.04를 사용하도록 API 모델 변경).
  • AKS Base Ubuntu 18.04-LTS 이미지 배포판(더 이상 사용되지 않음, 대신 20.04를 사용하도록 API 모델 변경).
  • AKS Base Ubuntu 20.04-LTS 이미지 배포판(Linux 에이전트에 필요).
  • AKS 기본 Windows Server 이미지(Windows 에이전트에는 다음 이미지 중 하나가 필요합니다.)
    • AKS 기본 Windows Server Image Containerd.
    • AKS 기본 Windows Server 이미지 Docker.

이러한 이미지의 새 버전은 이 업데이트에서 사용할 수 있습니다.

  • AKS 엔진 및 Azure Stack 버전 매핑 테이블에서 필요한 AKS 기본 이미지를 확인합니다.

    AZURE Stack Hub Marketplace에 AKS(Azure Kubernetes Services) 엔진 필수 구성 요소 추가의 지침을 따릅니다.

  • Kubernetes 클러스터 관리자(일반적으로 Azure Stack Hub의 테넌트 사용자)는 새 aks-engine을 다운로드해야 합니다. Azure Stack Hub의 Linux에 AKS 엔진 설치(또는 해당하는 Windows 문서)의 지침을 참조하세요. 클러스터를 처음으로 설치하는 데 사용한 것과 동일한 프로세스를 따를 수 있습니다. 업데이트는 이전 이진 파일을 덮어씁니다. 예를 들어 get-akse.sh 스크립트를 사용한 경우 연결된 환경에서 설치에 설명된 것과 동일한 단계를 수행합니다. Windows 시스템에 설치하는 경우에도 동일한 프로세스가 적용됩니다. Azure Stack Hub의 Windows에 AKS 엔진을 설치합니다.

Ubuntu 16.04 배포판으로 만든 Kubernetes 클러스터 업그레이드

AKS 엔진 v0.63.0부터 OS가 수명 종료에 도달함에 따라 Ubuntu 16.04 배포판은 더 이상 지원되지 않습니다. AKS 엔진 v0.67.0 이상 버전의 경우 aks-engine 업그레이드는 지원 aks-ubuntu-16.04 되지 않는 배포판 값을 .으로 aks-ubuntu-18.04자동으로 덮어씁니다. AKS 엔진 v0.75.3 이상 버전의 경우 Kubernetes v1.24 이상을 사용하는 경우 aks-engine-azurestack 업그레이드는 지원 aks-ubuntu-16.04 되지 않는 배포판 값을 aks-ubuntu-20.04자동으로 덮어씁니다.

Ubuntu 18.04 배포판으로 만든 Kubernetes 클러스터 업그레이드

AKS 엔진 v0.75.3부터 OS가 수명에 도달함에 따라 Ubuntu 18.04 배포판은 더 이상 지원되지 않습니다. AKS 엔진 v0.75.3 이상 버전의 경우 aks-engine-azurestack 업그레이드는 지원 aks-ubuntu-18.04 되지 않는 배포판 값을 aks-ubuntu-20.04자동으로 덮어씁니다.

Docker 컨테이너 런타임을 사용하여 만든 Kubernetes 클러스터 업그레이드

Kubernetes v1.24에서는 dockershim 구성 요소가 kubelet에서 제거되었습니다. 따라서 Docker 컨테이너 런타임은 더 이상 지원되지 않는 옵션입니다. 자세한 내용은 Kubernetes v1.24 릴리스 정보를 참조하세요. AKS 엔진 v0.75.3 이상 버전의 경우 aks-engine-azurestack 업그레이드는 지원 containerRuntime docker 되지 않는 값을 containerd자동으로 덮어씁니다.

AKS 엔진 릴리스 v0.75.3의 경우 Kubernetes v1.23에서 Windows 노드가 있는 클러스터는 Docker 런타임과 함께 Windows 기본 이미지를 사용할 수 있습니다. Kubernetes v1.24에서 Windows 노드가 있는 클러스터는 Containerd 런타임에서 Windows 기본 이미지를 사용할 수 있습니다.

AKS 엔진 및 Azure Stack 버전 매핑

Azure Stack Hub 버전 AKS 엔진 버전
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*
2406 0.80.2*

참고 항목

지원됩니다.* 자세한 내용은 AKS 엔진 버전 지원 정책을 참조하세요.

AKS 엔진 및 해당 이미지 매핑

다음 표에서 Azure Stack Hub에서 AKS 엔진에 대해 지원되는 Kubernetes 버전을 찾을 수 있습니다. 전역 Azure 및 Azure Stack Hub에서 지원되는 버전을 반환하는 aks-engine get-versions 명령을 사용하지 마세요.

AKS 엔진 AKS 기본 이미지 Kubernetes 버전 API 모델 샘플
v0.43.1 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2019년 10월(2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2020년 3월(2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2020년 5월(2020.05.13), AKS 기본 Windows 이미지(17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 8월(2020.08.24), AKS 기본 Windows 이미지(17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 9월(2020.09.14), AKS 기본 Windows 이미지(17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, 2021년 1월(2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS 기본 Windows 이미지(17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2(2021.05.24), AKS 기본 Windows 이미지(17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API 모델 샘플(Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3(2021.09.27), AKS 기본 Windows 이미지(17763.2213.210927) 1.19.15, 1.20.11 API 모델 샘플(Linux, Windows)
v0.67.3 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3(2021.09.27), AKS 기본 Windows 이미지(17763.2213.210927) 1.19.15, 1.20.11 API 모델 샘플(Linux, Windows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2(2022.04.07), AKS 기본 Windows 이미지(17763.2565.220408) 1.21.10*, 1.22.7* API 모델 샘플(Linux, Windows)
v0.71.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q3(2022.08.12), AKS 기본 Windows 이미지(17763.3232.220805) 1.22.7*, 1.23.6* API 모델 샘플(Linux, Windows)
v0.73.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q4(2022.11.02), AKS 기본 Windows 이미지(17763.3532.221102) 1.22.15*, 1.23.13* API 모델 샘플(Linux, Windows)
v0.75.3 AKS Base Ubuntu 20.04-LTS 이미지 배포판(2023.032.2), AKS Base Windows Server 2019 Image Docker(17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd(17763.3887.20230332) 1.23.15*, 1.24.9** API 모델 샘플(Linux, Windows)
v0.76.0 AKS Base Ubuntu 20.04-LTS Image Distro(2023.116.3), AKS Base Windows Server 2019 Image Containerd(17763.4252.20231163) 1.24.11**, 1.25.7** API 모델 샘플(Linux, Windows)
v0.77.0 AKS Base Ubuntu 20.04-LTS Image Distro(2023.206.1), AKS Base Windows Server 2019 Image Containerd(17763.4645.20232061) 1.25.7**, 1.26.6** API 모델 샘플(Linux, Windows)
v0.78.0 AKS Base Ubuntu 20.04-LTS Image Distro(2023.242.3), AKS Base Windows Server 2019 Image Containerd(17763.4737.20232423) 1.25.13**, 1.26.8** API 모델 샘플(Linux, Windows)
v0.79.0 AKS Base Ubuntu 20.04-LTS Image Distro(2023.296.1), AKS Base Windows Server 2019 Image Containerd(17763.4974.20232961) 1.26.9**, 1.27.6** API 모델 샘플(Linux, Windows)
v0.80.2 AKS Base Ubuntu 20.04-LTS Image Distro(2024.032.1), AKS Base Windows Server 2019 Image Containerd(17763.5329.20240321) 1.27.10**, 1.28.6** API 모델 샘플(Linux, Windows)

참고 항목

*Kubernetes v1.21부터 Azure용 클라우드 공급자만 Azure Stack Hub에서 지원됩니다.

참고 항목

** Kubernetes v1.24부터 컨테이너 런타임만 containerd 지원됩니다. 자세한 내용은 Docker 컨테이너 런타임으로 만든 Kubernetes 클러스터 업그레이드 섹션을 참조하세요.

업데이트 계획

AKS 엔진 upgrade 명령은 클러스터의 업그레이드 프로세스를 완전히 자동화하고 VM(가상 머신), 네트워킹, 스토리지, Kubernetes 및 오케스트레이션 작업을 처리합니다. 업데이트를 적용하기 전에 릴리스 정보 정보를 검토해야 합니다.

AKSe 0.76.0의 새로운 기능

  • Kubernetes v1.24.11 및 v1.25.7에 대한 지원이 추가되었습니다.
  • v0.76.0 GitHub 페이지에서 다른 기능을 찾을 수 있습니다.

AKSe 0.75.3 이상의 새로운 기능

AKS 엔진 릴리스 v0.75.3 및 Azure Stack Hub의 모든 향후 AKS 엔진 릴리스는 새로운 aks-engine-azurestack 리포지토리에서 제공됩니다. 따라서 모든 aks-engine 명령을 .로 aks-engine-azurestack바꿔야 합니다. Azure Stack Hub에서 최신 AKS 엔진 릴리스를 가져오는 명령도 변경되었습니다. Linux 클라이언트 만들기 및 Windows 클라이언트 만들기에서 새 명령을 볼 수 있습니다. 문제가 발견되면 새 리포지토리에서 문제를 만듭니다.

Azure Stack Hub의 AKS 엔진 릴리스 v0.75.3은 Linux 기본 이미지로 Ubuntu 20.04 LTS를 제공합니다. 이 릴리스부터 Ubuntu 18.04는 더 이상 지원되지 않습니다. 자세한 내용은 Ubuntu 18.04 배포판으로 만든 Kubernetes 클러스터 업그레이드를 참조하세요.

Kubernetes v1.24부터 런타임만 containerd 지원됩니다. 자세한 내용은 Docker 런타임을 사용하여 만든 Kubernetes 클러스터 업그레이드를 참조하세요. AKS 엔진 릴리스 v0.75.3의 경우 Kubernetes v1.23에서 Windows 노드가 있는 클러스터는 Docker 런타임에서 Windows 기본 이미지를 사용할 수 있습니다. Kubernetes v1.24에서 Windows 노드가 있는 클러스터는 Containerd 런타임에서 Windows 기본 이미지를 사용할 수 있습니다.

v0.75.3 GitHub 페이지에서 더 많은 기능을 찾을 수 있습니다.

AKS 엔진 0.70.0 이상을 사용하는 지침

Microsoft는 버전 0.70.0에서 Azure 클라우드 공급자를 업그레이드했습니다. Azure 클라우드 공급자는 Azure Stack Hub의 AKS Azure와 AKS 엔진 간에 공유되는 핵심 구성 요소입니다.

AKS 엔진 0.70.0 이상을 사용하려면 다음을 수행합니다.

  • 새 Kubernetes 클러스터를 처음으로 만들려고 하는 경우: AKS 엔진 및 해당 이미지 매핑 테이블에서 적절한 버전에 대해 제공된 샘플 API 모델을 사용합니다.

  • 새 클러스터를 만들지만 기존 API 모델을 사용하려는 경우: Azure용 클라우드 공급자 지침에 따라 API 모델을 수정합니다. 새 설정을 포함하지 않으면 배포 오류가 발생합니다.

  • 스토리지 볼륨을 사용하는 경우: AzureDiskCSI 드라이버를 사용하고 있는지 확인합니다. 버전 0.70.0 이상은 레거시 트리 내 스토리지 공급자가 아닌 CSI 드라이버만 지원합니다. 업그레이드하려면 스토리지 볼륨을 사용하는 동안 업그레이드의 지침을 따릅니다.

알려진 문제

  • 단일 클러스터 내에 여러 Kubernetes 서비스를 병렬로 배포하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 한 번에 하나의 서비스를 배포하는 것이 좋습니다.
  • aks-engine 도구는 Azure 및 Azure Stack Hub에서 공유 소스 코드 리포지토리이므로 많은 릴리스 정보 및 끌어오기 요청을 검토하면 도구가 이전에 나열된 것 이상으로 다른 버전의 Kubernetes 및 OS 플랫폼을 지원한다고 믿게 될 수 있습니다. 이를 무시하고 위의 버전 테이블을 이 업데이트의 공식 가이드로 사용할 수 있습니다.
  • AKS 엔진 v0.67.0은 Windows 클러스터를 배포할 때 잘못된 Windows 이미지를 사용합니다. v0.70.0을 사용하여 이 문제를 해결합니다.

참조

다음 목록은 Azure 및 Azure Stack Hub에 대한 전체 릴리스 정보 집합입니다.

AKS 엔진의 버전 v0.67.0에 적용됩니다.

이 문서에서는 Azure Stack Hub 업데이트에서 AKS(Azure Kubernetes Service) 엔진의 내용을 설명합니다. 이 업데이트에는 Azure Stack Hub 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대한 개선 사항 및 수정 사항이 포함됩니다. 이 문서는 글로벌 Azure용 AKS 엔진에 대한 릴리스 정보를 문서화하기 위한 것이 아닙니다.

업데이트 계획

AKS 엔진 upgrade 명령은 클러스터의 업그레이드 프로세스를 완전히 자동화합니다. VM(가상 머신), 네트워킹, 스토리지, Kubernetes 및 오케스트레이션 작업을 처리합니다. 업데이트를 적용하기 전에 릴리스 정보 정보를 검토해야 합니다.

업그레이드 고려 사항

  • 올바른 마켓플레이스 항목, AKS Base Ubuntu 16.04-LTS 또는 18.04 Image Distro 또는 AKS Base Windows Server를 AKS 엔진 버전에 사용하고 있나요? "새 이미지 및 AKS 엔진 다운로드" 섹션에서 버전을 찾을 수 있습니다.
  • 대상 클러스터에 올바른 클러스터 사양(apimodel.json) 및 리소스 그룹을 사용하고 있나요? 원래 클러스터를 배포했을 때 이 파일은 출력 디렉터리에 생성되었습니다. 배포 명령 매개 변수 Kubernetes 클러스터 배포를 참조하세요.
  • 신뢰할 수 있는 컴퓨터를 사용하여 AKS 엔진을 실행하고 업그레이드 작업을 수행하고 있나요?
  • 활성 워크로드를 사용하여 운영 클러스터를 업데이트하는 경우 클러스터가 정상적인 부하를 받고 있다고 가정하여 업그레이드에 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 리디렉션해야 하는 경우 백업 클러스터가 있어야 합니다. 백업 클러스터를 사용하는 것이 좋습니다.
  • 가능하면 Azure Stack Hub 환경 내의 VM에서 명령을 실행하여 네트워크 홉과 잠재적인 연결 오류를 줄입니다.
  • 구독에 전체 프로세스에 대한 충분한 할당량이 있는지 확인합니다. 프로세스는 프로세스 중에 새 VM을 할당합니다. 결과 VM 수는 원래 VM과 동일하지만 프로세스 중에 몇 가지 VM을 추가로 만들 계획입니다.
  • 시스템 업데이트 또는 예약된 작업은 계획되지 않습니다.
  • 프로덕션 클러스터와 동일한 값으로 구성된 클러스터에서 스테이징된 업그레이드를 설정하고 프로덕션 클러스터에서 업그레이드를 테스트합니다.

업그레이드 명령 사용

Azure Stack Hub의 aks-engine upgrade Kubernetes 클러스터 업그레이드에 설명된 대로 명령을 사용해야 합니다.

업그레이드 중단

예기치 않은 요인으로 클러스터 업그레이드가 중단되는 경우가 있습니다. AKS 엔진이 오류를 보고하거나 AKS 엔진 실행 프로세스에 문제가 발생할 때 중단이 발생할 수 있습니다. 중단의 원인을 검사하고, 해결한 다음, 동일한 upgrade 명령을 다시 제출하여 업그레이드 프로세스를 계속합니다. 명령은 upgrade idempotent이며 명령을 다시 제출한 후 클러스터 업그레이드를 다시 시작해야 합니다. 일반적으로 중단은 업데이트를 완료하는 데 시간이 늘어나지만 완료에 영향을 주지 않아야 합니다.

예상 업그레이드 시간

예상 업그레이드 시간은 클러스터의 VM당 12~15분입니다. 예를 들어 20노드 클러스터를 업그레이드하는 데 약 5시간이 걸릴 수 있습니다.

새 이미지 및 AKS 엔진 다운로드

AKS 기본 Ubuntu 이미지 및 AKS 엔진의 새 버전을 다운로드합니다.

Azure Stack Hub용 AKS 엔진 설명서에 설명된 대로 Kubernetes 클러스터를 배포하려면 다음이 필요합니다.

  • aks 엔진 이진(필수)입니다.
  • AKS Base Ubuntu 16.04-LTS 이미지 배포판(더 이상 사용되지 않음, 대신 18.04를 사용하도록 API 모델 변경).
  • AKS Base Ubuntu 18.04-LTS 이미지 배포판(Linux 에이전트에 필요).
  • AKS 기본 Windows Server 이미지 배포판(Windows 에이전트에 필요).

이러한 이미지의 새 버전은 이 업데이트에서 사용할 수 있습니다.

  • AKS 엔진 및 Azure Stack 버전 매핑 테이블에서 필요한 AKS 기본 이미지를 확인합니다.

    AZURE Stack Hub Marketplace에 AKS(Azure Kubernetes Services) 엔진 필수 구성 요소 추가의 지침을 따릅니다.

  • Kubernetes 클러스터 관리자(일반적으로 Azure Stack Hub의 테넌트 사용자)는 새 aks-engine을 다운로드해야 합니다. Azure Stack Hub의 Linux에 AKS 엔진 설치(또는 해당하는 Windows 문서)의 지침을 참조하세요. 클러스터를 처음으로 설치하는 데 사용한 것과 동일한 프로세스를 따를 수 있습니다. 업데이트는 이전 이진 파일을 덮어씁니다. 예를 들어 get-akse.sh 스크립트를 사용한 경우 연결된 환경에서 설치에 설명된 것과 동일한 단계를 수행합니다. Windows 시스템에 설치하는 경우에도 동일한 프로세스가 적용됩니다. Azure Stack Hub의 Windows에 AKS 엔진을 설치합니다.

Ubuntu 16.04 배포판으로 만든 Kubernetes 클러스터 업그레이드

AKS 엔진 v0.67.0부터 OS가 수명 종료에 도달함에 따라 Ubuntu 16.04 배포판은 더 이상 지원되지 않습니다. 클러스터를 업그레이드하려면 OS 배포판 aks-ubuntu-18.04 이 입력 API 모델에서 생성되고 aks-engine deploy 입력으로 전달되는 모델로 설정해야 합니다 aks-engine upgrade.

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

AKS 엔진 및 Azure Stack 버전 매핑

Azure Stack Hub 버전 AKS 엔진 버전
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

AKS 엔진 v0.67.0의 Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack Hub의 현재 버전 및 업그레이드 버전을 찾을 수 있습니다. 이 테이블은 Azure Stack Hub의 AKS 엔진 클러스터에 적용됩니다. 전역 Azure 및 Azure Stack Hub에서 지원되는 버전을 반환하는 aks-engine get-versions 명령을 사용하지 마세요.

현재 버전 업그레이드 가능
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

API 모델 JSON 파일에서 섹션 아래에 릴리스 및 버전 값을 지정합니다 orchestratorProfile . 예를 들어 Kubernetes 1.17.17을 배포하려는 경우 다음 두 값을 설정해야 합니다(예제 kubernetes-azurestack.json 참조).

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS 엔진 및 해당 이미지 매핑

AKS 엔진 AKS 기본 이미지 Kubernetes 버전 API 모델 샘플
v0.43.1 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2019년 10월(2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2020년 3월(2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2020년 5월(2020.05.13), AKS 기본 Windows 이미지(17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 8월(2020.08.24), AKS 기본 Windows 이미지(17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 9월(2020.09.14), AKS 기본 Windows 이미지(17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, 2021년 1월(2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS 기본 Windows 이미지(17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2(2021.05.24), AKS 기본 Windows 이미지(17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API 모델 샘플(Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3(2021.09.27), AKS 기본 Windows 이미지(17763.2213.210927) 1.19.15, 1.20.11 API 모델 샘플(Linux, Windows)

새로운 기능

프라이빗 미리 보기에 참여하려는 경우 미리 보기 액세스를 요청할 수 있습니다.

새로운 기능은 다음과 같습니다.

  • Kubernetes 1.19.15 및 1.20.11 지원

알려진 문제

  • 단일 클러스터 내에 여러 Kubernetes 서비스를 병렬로 배포하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 한 번에 하나의 서비스를 배포하는 것이 좋습니다.
  • aks-engine 도구는 Azure 및 Azure Stack Hub에서 공유 소스 코드 리포지토리이므로 많은 릴리스 정보 및 끌어오기 요청을 검토하면 도구가 이전에 나열된 것 이상으로 다른 버전의 Kubernetes 및 OS 플랫폼을 지원한다고 믿게 될 수 있습니다. 이를 무시하고 위의 버전 테이블을 이 업데이트의 공식 가이드로 사용할 수 있습니다.

참조

다음 목록은 Azure 및 Azure Stack Hub에 대한 전체 릴리스 정보 집합입니다.

AKS 엔진의 버전 v0.60.1에 적용됩니다.

이 문서에서는 Azure Stack Hub 업데이트에서 AKS(Azure Kubernetes Service) 엔진의 내용을 설명합니다. 이 업데이트에는 Azure Stack Hub 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대한 개선 사항 및 수정 사항이 포함됩니다. 이 문서는 글로벌 Azure용 AKS 엔진에 대한 릴리스 정보를 문서화하기 위한 것이 아닙니다.

업데이트 계획

AKS 엔진 upgrade 명령은 클러스터의 업그레이드 프로세스를 완전히 자동화하고 VM(가상 머신), 네트워킹, 스토리지, Kubernetes 및 오케스트레이션 작업을 처리합니다. 업데이트를 적용하기 전에 릴리스 정보 정보를 검토해야 합니다.

업그레이드 고려 사항

  • 올바른 마켓플레이스 항목, AKS Base Ubuntu 16.04-LTS 또는 18.04 Image Distro 또는 AKS Base Windows Server를 AKS 엔진 버전에 사용하고 있나요? "새 이미지 및 AKS 엔진 다운로드" 섹션에서 버전을 찾을 수 있습니다.
  • 대상 클러스터에 올바른 클러스터 사양(apimodel.json) 및 리소스 그룹을 사용하고 있나요? 원래 클러스터를 배포했을 때 이 파일은 출력 디렉터리에 생성되었습니다. 배포 명령 매개 변수 Kubernetes 클러스터 배포를 참조하세요.
  • 신뢰할 수 있는 컴퓨터를 사용하여 AKS 엔진을 실행하고 업그레이드 작업을 수행하고 있나요?
  • 활성 워크로드를 사용하여 운영 클러스터를 업데이트하는 경우 클러스터가 정상적인 부하를 받고 있다고 가정하여 업그레이드에 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 리디렉션해야 하는 경우 백업 클러스터가 있어야 합니다. 백업 클러스터를 사용하는 것이 좋습니다.
  • 가능하면 Azure Stack Hub 환경 내의 VM에서 명령을 실행하여 네트워크 홉과 잠재적인 연결 오류를 줄입니다.
  • 구독에 전체 프로세스에 대한 충분한 할당량이 있는지 확인합니다. 프로세스는 프로세스 중에 새 VM을 할당합니다. 결과 VM 수는 원래 VM과 동일하지만 프로세스 중에 몇 가지 VM을 추가로 만들 계획입니다.
  • 시스템 업데이트 또는 예약된 작업은 계획되지 않습니다.
  • 프로덕션 클러스터와 동일한 값으로 구성된 클러스터에서 스테이징된 업그레이드를 설정하고 프로덕션 클러스터에서 업그레이드를 테스트합니다.

업그레이드 명령 사용

Azure Stack Hub의 aks-engine upgrade Kubernetes 클러스터 업그레이드에 설명된 대로 명령을 사용해야 합니다.

업그레이드 중단

예기치 않은 요인으로 클러스터 업그레이드가 중단되는 경우가 있습니다. AKS 엔진이 오류를 보고하거나 AKS 엔진 실행 프로세스에 문제가 발생할 때 중단이 발생할 수 있습니다. 중단의 원인을 검사하고, 해결한 다음, 동일한 upgrade 명령을 다시 제출하여 업그레이드 프로세스를 계속합니다. 명령은 upgrade idempotent이며 명령을 다시 제출한 후 클러스터 업그레이드를 다시 시작해야 합니다. 일반적으로 중단은 업데이트를 완료하는 데 시간이 늘어나지만 완료에 영향을 주지 않아야 합니다.

예상 업그레이드 시간

예상 업그레이드 시간은 클러스터의 VM당 12~15분입니다. 예를 들어 20노드 클러스터를 업그레이드하는 데 약 5시간이 걸릴 수 있습니다.

새 이미지 및 AKS 엔진 다운로드

AKS 기본 Ubuntu 이미지 및 AKS 엔진의 새 버전을 다운로드합니다.

Azure Stack Hub의 AKS 엔진 설명서에 설명된 대로 Kubernetes 클러스터를 배포하려면 다음이 필요합니다.

  • aks 엔진 이진(필수)입니다.
  • AKS Base Ubuntu 16.04-LTS 이미지 배포판(더 이상 사용되지 않음, 대신 18.04를 사용하도록 API 모델 변경).
  • AKS Base Ubuntu 18.04-LTS 이미지 배포판(Linux 에이전트에 필요).
  • AKS 기본 Windows Server 이미지 배포판(Windows 에이전트에 필요).

이러한 새 버전은 이 업데이트에서 사용할 수 있습니다.

  • Azure Stack Hub 운영자는 새 AKS 기본 이미지를 스탬프 마켓플레이스에 다운로드해야 합니다.

    • AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2021년 1월(2021.01.28)

    • AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),

    • AKS 기본 Windows 이미지(17763.1697.210129)

      AZURE Stack Hub Marketplace에 AKS(Azure Kubernetes Services) 엔진 필수 구성 요소 추가의 지침을 따릅니다.

  • Kubernetes 클러스터 관리자(일반적으로 Azure Stack Hub의 테넌트 사용자)는 새 aks-engine을 다운로드해야 합니다. Azure Stack Hub의 Linux에 AKS 엔진 설치(또는 해당하는 Windows 문서)의 지침을 참조하세요. 클러스터를 처음으로 설치하는 데 사용한 것과 동일한 프로세스를 따를 수 있습니다. 업데이트는 이전 이진 파일을 덮어씁니다. 예를 들어 get-akse.sh 스크립트를 사용한 경우 연결된 환경에서 설치에 설명된 것과 동일한 단계를 수행합니다. Windows 시스템에 설치하는 경우에도 동일한 프로세스가 적용됩니다. Azure Stack Hub의 Windows에 AKS 엔진을 설치합니다.

AKS 엔진 및 Azure Stack 버전 매핑

Azure Stack Hub 버전 AKS 엔진 버전
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

AKS 엔진 v0.60.1의 Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack Hub의 현재 버전 및 업그레이드 버전을 찾을 수 있습니다. 이 테이블은 Azure Stack Hub의 AKS 엔진 클러스터에 적용됩니다. 전역 Azure 및 Azure Stack Hub에서 지원되는 버전을 반환하는 aks-engine get-versions 명령을 사용하지 마세요.

현재 버전 업그레이드 가능
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

API 모델 JSON 파일에서 섹션 아래에 릴리스 및 버전 값을 지정합니다 orchestratorProfile . 예를 들어 Kubernetes 1.17.17을 배포하려는 경우 다음 두 값을 설정해야 합니다(예제 kubernetes-azurestack.json 참조).

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS 엔진 및 해당 이미지 매핑

AKS 엔진 AKS 기본 이미지 Kubernetes 버전 API 모델 샘플
v0.43.1 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2019년 10월(2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2020년 3월(2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS 이미지 배포판, 2020년 5월(2020.05.13), AKS 기본 Windows 이미지(17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 8월(2020.08.24), AKS 기본 Windows 이미지(17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 9월(2020.09.14), AKS 기본 Windows 이미지(17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, 2021년 1월(2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS 기본 Windows 이미지(17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

새로운 기능

프라이빗 미리 보기에 참여하려는 경우 미리 보기 액세스를 요청할 수 있습니다.

새로운 기능은 다음과 같습니다.

  • Ubuntu 18.04의 일반 공급.
  • 인증서 회전 공개 미리 보기 #4214.
  • T4 Nvidia GPU 프라이빗 미리 보기 #4259.
  • Azure Active Directory 통합 프라이빗 미리 보기.
  • Azure Blob용 CSI 드라이버 프라이빗 미리 보기 #712.
  • CSI 드라이버 Azure Disks 공개 미리 보기 #712.
  • CSI 드라이버 NFS 공개 미리 보기 #712.
  • Kubernetes 1에 대한 지원. 17.17 #4188 및 1.18.15 #4187.

알려진 문제

  • 단일 클러스터 내에 여러 Kubernetes 서비스를 병렬로 배포하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 한 번에 하나의 서비스를 배포하는 것이 좋습니다.
  • aks-engine 도구는 Azure 및 Azure Stack Hub에서 공유 소스 코드 리포지토리이므로 많은 릴리스 정보 및 끌어오기 요청을 검토하면 도구가 이전에 나열된 것 이상으로 다른 버전의 Kubernetes 및 OS 플랫폼을 지원한다고 믿게 될 수 있습니다. 이를 무시하고 위의 버전 테이블을 이 업데이트의 공식 가이드로 사용할 수 있습니다.

참조

다음 목록은 Azure 및 Azure Stack Hub에 대한 전체 릴리스 정보 집합입니다.

AKS 엔진의 버전 v0.55.4에 적용됩니다.

이 문서에서는 Azure Stack Hub 업데이트에서 AKS(Azure Kubernetes Service) 엔진의 내용을 설명합니다. 이 업데이트에는 Azure Stack Hub 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대한 개선 사항 및 수정 사항이 포함됩니다. 이 문서는 글로벌 Azure용 AKS 엔진에 대한 릴리스 정보를 문서화하기 위한 것이 아닙니다.

업데이트 계획

AKS 엔진 upgrade 명령은 클러스터의 업그레이드 프로세스를 완전히 자동화하고 VM(가상 머신), 네트워킹, 스토리지, Kubernetes 및 오케스트레이션 작업을 처리합니다. 업데이트를 적용하기 전에 릴리스 정보 정보를 검토해야 합니다.

업그레이드 고려 사항

  • AKS 엔진 버전에 올바른 마켓플레이스 항목인 AKS Base Ubuntu 16.04-LTS 이미지 배포판을 사용하고 있나요? "새 이미지 및 AKS 엔진 다운로드" 섹션에서 버전을 찾을 수 있습니다.
  • 대상 클러스터에 올바른 클러스터 사양(apimodel.json) 및 리소스 그룹을 사용하고 있나요? 원래 클러스터를 배포했을 때 이 파일은 출력 디렉터리에 생성되었습니다. 배포 명령 매개 변수 Kubernetes 클러스터 배포를 참조하세요.
  • 신뢰할 수 있는 컴퓨터를 사용하여 AKS 엔진을 실행하고 업그레이드 작업을 수행하고 있나요?
  • 활성 워크로드를 사용하여 운영 클러스터를 업데이트하는 경우 클러스터가 정상적인 부하를 받고 있다고 가정하여 업그레이드에 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 리디렉션해야 하는 경우 백업 클러스터가 있어야 합니다. 백업 클러스터를 사용하는 것이 좋습니다.
  • 가능하면 Azure Stack Hub 환경 내의 VM에서 명령을 실행하여 네트워크 홉과 잠재적인 연결 오류를 줄입니다.
  • 구독에 전체 프로세스에 대한 충분한 할당량이 있는지 확인합니다. 프로세스는 프로세스 중에 새 VM을 할당합니다. 결과 VM 수는 원래 VM과 동일하지만 프로세스 중에 몇 가지 VM을 추가로 만들 계획입니다.
  • 시스템 업데이트 또는 예약된 작업은 계획되지 않습니다.
  • 프로덕션 클러스터와 동일한 값으로 구성된 클러스터에서 스테이징된 업그레이드를 설정하고 프로덕션 클러스터에서 업그레이드를 테스트합니다.

업그레이드 명령 사용

Azure Stack Hub의 aks-engine upgrade Kubernetes 클러스터 업그레이드에 설명된 대로 명령을 사용해야 합니다.

업그레이드 중단

예기치 않은 요인으로 클러스터 업그레이드가 중단되는 경우가 있습니다. AKS 엔진이 오류를 보고하거나 AKS 엔진 실행 프로세스에 문제가 발생할 때 중단이 발생할 수 있습니다. 중단의 원인을 검사하고, 해결한 다음, 동일한 upgrade 명령을 다시 제출하여 업그레이드 프로세스를 계속합니다. 명령은 upgrade idempotent이며 명령을 다시 제출한 후 클러스터 업그레이드를 다시 시작해야 합니다. 일반적으로 중단은 업데이트를 완료하는 데 시간이 늘어나지만 완료에 영향을 주지 않아야 합니다.

예상 업그레이드 시간

예상 업그레이드 시간은 클러스터의 VM당 12~15분입니다. 예를 들어 20노드 클러스터를 업그레이드하는 데 약 5시간이 걸릴 수 있습니다.

새 이미지 및 AKS 엔진 다운로드

AKS 기본 Ubuntu 이미지 및 AKS 엔진의 새 버전을 다운로드합니다.

Azure Stack Hub의 AKS 엔진 설명서에 설명된 대로 Kubernetes 클러스터를 배포하려면 다음 두 가지 주요 구성 요소가 필요합니다.

  • aks 엔진 이진(필수)입니다.
  • AKS Base Ubuntu 16.04-LTS 이미지 배포판

이러한 이미지의 새 버전은 이 업데이트에서 사용할 수 있습니다.

  • Azure Stack Hub 운영자는 새 AKS 기본 Ubuntu 이미지를 스탬프 마켓플레이스에 다운로드해야 합니다.

  • 이름: AKS Base Ubuntu 16.04-LTS Image Distro, 2020년 9월(2020.09.14)

  • 버전: 2020.09.14

    AZURE Stack Hub Marketplace에 AKS(Azure Kubernetes Services) 엔진 필수 구성 요소 추가의 지침을 따릅니다.

  • Kubernetes 클러스터 관리자(일반적으로 Azure Stack Hub의 테넌트 사용자)는 새 aks-engine을 다운로드해야 합니다. Azure Stack Hub의 Linux에 AKS 엔진 설치(또는 해당하는 Windows 문서)의 지침을 참조하세요. 클러스터를 처음으로 설치하는 데 사용한 것과 동일한 프로세스를 따를 수 있습니다. 업데이트는 이전 이진 파일을 덮어씁니다. 예를 들어 get-akse.sh 스크립트를 사용한 경우 연결된 환경에서 설치에 설명된 것과 동일한 단계를 수행합니다. Windows 시스템에 설치하는 경우에도 동일한 프로세스가 적용됩니다. Azure Stack Hub의 Windows에 AKS 엔진을 설치합니다.

AKS 엔진 및 Azure Stack 버전 매핑

Azure Stack Hub 버전 AKS 엔진 버전
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

AKS 엔진 v0.55.4의 Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack Hub의 현재 버전 및 업그레이드 버전을 찾을 수 있습니다. 이 테이블은 Azure Stack Hub의 AKS 엔진 클러스터에 적용됩니다. 전역 Azure 및 Azure Stack Hub에서 지원되는 버전을 반환하는 aks-engine get-versions 명령을 사용하지 마세요.

현재 버전 업그레이드 가능
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

API 모델 JSON 파일에서 섹션 아래에 릴리스 및 버전 값을 지정합니다 orchestratorProfile . 예를 들어 Kubernetes 1.17.17을 배포하려는 경우 다음 두 값을 설정해야 합니다(예제 kubernetes-azurestack.json 참조).

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

AKS 엔진 및 해당 이미지 매핑

Kubernetes 버전 주의
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 API 모델 샘플(Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API 모델 샘플(Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API 모델 샘플(Linux, Windows)

새로운 기능

알려진 문제

  • 단일 클러스터 내에 여러 Kubernetes 서비스를 병렬로 배포하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 한 번에 하나의 서비스를 배포하는 것이 좋습니다.
  • aks-engine get-versions을 실행하는 경우 출력은 Azure 및 Azure Stack Hub에 적용 가능한 정보를 생성합니다. 그러나 Azure Stack Hub에 해당하는 항목을 식별할 수 있는 명시적인 방법은 없습니다. 이 명령을 사용하여 업그레이드할 수 있는 버전을 결정하지 마세요. 이전 섹션에서 설명한 업그레이드 참조 테이블을 사용합니다.
  • aks-engine 도구는 Azure 및 Azure Stack Hub에서 공유 소스 코드 리포지토리이므로 많은 릴리스 정보 및 끌어오기 요청을 검토하면 도구가 이전에 나열된 것 이상으로 다른 버전의 Kubernetes 및 OS 플랫폼을 지원한다고 믿게 될 수 있습니다. 이를 무시하고 위의 버전 테이블을 이 업데이트의 공식 가이드로 사용할 수 있습니다.

참조

다음은 Azure 및 Azure Stack Hub에 대한 전체 릴리스 정보 집합입니다.

AKS 엔진 버전 0.48.0 이하에 적용됩니다.

이 문서에서는 Azure Stack Hub 업데이트에서 AKS(Azure Kubernetes Service) 엔진의 내용을 설명합니다. 이 업데이트에는 Azure Stack Hub 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대한 개선 사항 및 수정 사항이 포함됩니다. 이 문서는 글로벌 Azure용 AKS 엔진에 대한 릴리스 정보를 문서화하기 위한 것이 아닙니다.

업데이트 계획

AKS 엔진 upgrade 명령은 클러스터의 업그레이드 프로세스를 완전히 자동화하고 VM(가상 머신), 네트워킹, 스토리지, Kubernetes 및 오케스트레이션 작업을 처리합니다. 업데이트를 적용하기 전에 릴리스 정보 정보를 검토해야 합니다.

업그레이드 고려 사항

  • AKS 엔진 버전에 올바른 마켓플레이스 항목인 AKS Base Ubuntu 16.04-LTS 이미지 배포판을 사용하고 있나요? 섹션에서 새 AKS 기본 Ubuntu 이미지 및 AKS 엔진 버전 다운로드에서 버전을 찾을 수 있습니다.
  • 대상 클러스터에 올바른 클러스터 사양(apimodel.json) 및 리소스 그룹을 사용하고 있나요? 원래 클러스터를 배포했을 때 이 파일은 출력 디렉터리에 생성되었습니다. 배포 명령 매개 변수 Kubernetes 클러스터 배포를 참조하세요.
  • 신뢰할 수 있는 컴퓨터를 사용하여 AKS 엔진을 실행하고 업그레이드 작업을 수행하고 있나요?
  • 활성 워크로드를 사용하여 운영 클러스터를 업데이트하는 경우 클러스터가 정상적인 부하를 받고 있다고 가정하여 업그레이드에 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 리디렉션해야 하는 경우 백업 클러스터가 있어야 합니다. 백업 클러스터를 사용하는 것이 좋습니다.
  • 가능하면 Azure Stack Hub 환경 내의 VM에서 명령을 실행하여 네트워크 홉과 잠재적인 연결 오류를 줄입니다.
  • 구독에 전체 프로세스에 대한 충분한 할당량이 있는지 확인합니다. 프로세스는 프로세스 중에 새 VM을 할당합니다. 결과 VM 수는 원래 VM과 동일하지만 프로세스 중에 몇 가지 VM을 추가로 만들 계획입니다.
  • 시스템 업데이트 또는 예약된 작업은 계획되지 않습니다.
  • 프로덕션 클러스터와 동일한 값으로 구성된 클러스터에서 스테이징된 업그레이드를 설정하고 프로덕션 클러스터에서 업그레이드를 테스트합니다.

업그레이드 명령 사용

Azure Stack Hub의 aks-engine upgrade Kubernetes 클러스터 업그레이드에 설명된 대로 명령을 사용해야 합니다.

업그레이드 중단

예기치 않은 요인으로 클러스터 업그레이드가 중단되는 경우가 있습니다. AKS 엔진이 오류를 보고하거나 AKS 엔진 실행 프로세스에 문제가 발생할 때 중단이 발생할 수 있습니다. 중단의 원인을 검사하고, 해결한 다음, 동일한 upgrade 명령을 다시 제출하여 업그레이드 프로세스를 계속합니다. 명령은 upgrade idempotent이며 명령을 다시 제출한 후 클러스터 업그레이드를 다시 시작해야 합니다. 일반적으로 중단은 업데이트를 완료하는 데 시간이 늘어나지만 완료에 영향을 주지 않아야 합니다.

예상 업그레이드 시간

예상 업그레이드 시간은 클러스터의 VM당 12~15분입니다. 예를 들어 20노드 클러스터를 업그레이드하는 데 약 5시간이 걸릴 수 있습니다.

새 이미지 및 AKS 엔진 다운로드

AKS 기본 Ubuntu 이미지 및 AKS 엔진의 새 버전을 다운로드합니다.

Azure Stack Hub의 AKS 엔진 설명서에 설명된 대로 Kubernetes 클러스터를 배포하려면 다음 두 가지 주요 구성 요소가 필요합니다.

  • aks 엔진 이진(필수)입니다.
  • AKS Base Ubuntu 16.04-LTS 이미지 배포판.

이러한 새 버전은 이 업데이트에서 사용할 수 있습니다.

  • Azure Stack Hub 운영자는 새 AKS 기본 이미지를 스탬프 마켓플레이스에 다운로드해야 합니다.

    • 이름: AKS Base Ubuntu 16.04-LTS Image Distro, March 2020

    • Version: 2020.03.19

      AZURE Stack Hub Marketplace에 AKS(Azure Kubernetes Services) 엔진 필수 구성 요소 추가의 지침을 따릅니다.

  • Kubernetes 클러스터 관리자(일반적으로 Azure Stack Hub의 테넌트 사용자)는 새 aks-engine을 다운로드해야 합니다. Azure Stack Hub의 Linux에 AKS 엔진 설치(또는 해당하는 Windows 문서)의 지침을 참조하세요. 클러스터를 처음으로 설치하는 데 사용한 것과 동일한 프로세스를 따를 수 있습니다. 업데이트는 이전 이진 파일을 덮어씁니다. 예를 들어 get-akse.sh 스크립트를 사용한 경우 연결된 환경에서 설치에 설명된 것과 동일한 단계를 수행합니다. Windows 시스템에 설치하는 경우에도 동일한 프로세스가 적용됩니다. Azure Stack Hub의 Windows에 AKS 엔진을 설치합니다.

Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack Hub의 현재 버전 및 업그레이드 버전을 찾을 수 있습니다. 이 테이블은 Azure Stack Hub의 AKS 엔진 클러스터에 적용됩니다. 전역 Azure 및 Azure Stack Hub에서 지원되는 버전을 반환하는 aks-engine get-versions 명령을 사용하지 마세요.

현재 버전 업그레이드 가능
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

새로운 기능

  • Kubernetes 버전 1.15.10(#2834)에 대한 지원. 새 클러스터를 배포할 때 API 모델 .json 파일(클러스터 정의 파일이라고도 함)에서 릴리스 버전 번호와 부 버전 번호를 다음 형식으로 지정합니다. 클러스터 정의 파일 예제는 kubernetes-azurestack.json 참조하세요.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    참고 항목

    Kubernetes 버전이 API 모델 .json 파일에 명시적으로 제공되지 않으면 버전 1.15가 사용되고(#2932) orchestratorVersion은 기본적으로 1.15.11로 설정되므로 클러스터 배포 중에 오류가 발생합니다.

  • aks-engine v0.43.1을 사용하면 클라우드 공급자가 제어 루프 및 기타 작업을 수행하는 기본 빈도 설정이 들어오는 요청에 대한 Azure Stack Hub Resource Manager 임계값 제한과 잘 작동하지 않습니다. 이 업데이트는 Azure Stack Hub 리소스 관리자(#2861)에 대한 재시도 부하를 줄이기 위해 Azure Stack Hub의 기본값을 변경합니다.

  • aPI 모델 .json 파일에 Azure Stack Hub(#2717)에서 지원하지 않는 속성이 포함된 경우 aks-engine의 새 확인 단계를 수행하면 실행이 중지되거나 경고가 표시됩니다.

  • 새 확인 체크 인을 통해 aks-engine은 aks 엔진 실행 버전(#2342)에 필요한 AKS 기본 이미지 버전의 가용성을 확인합니다. 이 문제는 API 모델 .json 파일을 구문 분석한 후 Azure Stack Hub Resource Manager를 호출하기 전에 발생합니다.

  • 명령의 새 aks 엔진 옵션 "--control-plane-only" upgrade 를 사용하면 사용자가 마스터 Virtual Machines(#2635)만 대상으로 작업을 업그레이드할 수 있습니다.

  • Ubuntu 16.04-LTS용 Linux 커널 버전 4.15.0-1071-azure 업데이트 자세한 내용은 "패키지: linux-image-4.15.0-1071-azure(4.15.0-1071.76) [보안]"을 참조하세요.

  • Kubernetes 버전 1.14.8 및 1.15.10을 지원하는 새로운 하이퍼쿠브 업데이트입니다.

  • 클러스터의 Kubernetes 버전과 일치하도록 kubectl을 업데이트합니다. 이 구성 요소는 Kubernetes 클러스터 컨트롤 플레인 노드에서 사용할 수 있으며 SSH를 통해 마스터로 실행할 수 있습니다.

  • 최신 2020년 2월 릴리스(#2850)를 사용한 Azure Container Monitor 추가 기능에 대한 업데이트입니다.

  • coredns 버전 v1.6.6(#2555)으로 업그레이드합니다.

  • 버전 3.3.18(#2462)로 업그레이드 etcd 합니다.

  • 버전 3.0.11(#2887)로 업그레이드 moby 합니다.

  • 이 릴리스에서 AKS 엔진은 이미지를 빌드할 때 공무원 Kubernetes MCR registry @ mcr.microsoft.com 을 사용할 때 종속성을 k8s.gcr.io 줄입니다(#2722).

알려진 문제

  • 단일 클러스터 내에 여러 Kubernetes 서비스를 병렬로 배포하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 한 번에 하나의 서비스를 배포하는 것이 좋습니다.
  • aks 엔진 get-versions 을 실행하면 Azure 및 Azure Stack Hub에 적용할 수 있는 정보가 생성되지만 Azure Stack Hub에 해당하는 정보를 식별할 수 있는 명시적인 방법은 없습니다. 이 명령을 사용하여 업그레이드할 수 있는 버전을 결정하지 마세요. 이전 섹션에서 설명한 업그레이드 참조 테이블을 사용합니다.
  • aks-engine 도구는 Azure 및 Azure Stack Hub에서 공유 소스 코드 리포지토리이므로 많은 릴리스 정보 및 끌어오기 요청을 검토하면 도구가 이전에 나열된 것 이상으로 다른 버전의 Kubernetes 및 OS 플랫폼을 지원한다고 믿게 될 수 있습니다. 이를 무시하고 위의 버전 테이블을 이 업데이트의 공식 가이드로 사용할 수 있습니다.

참조

다음은 수정된 일부 버그 목록과 버전 0.44.0부터 버전 0.48.0까지의 릴리스 정보 전체 집합입니다. 릴리스 정보에는 Azure 및 Azure Stack Hub가 모두 포함됩니다.

버그 수정

  • userAssignedIdentityId Windows azure.json 따옴표 누락(#2327)

  • 추가 기능은 update config 업그레이드 전용입니다(#2282)

  • Windows 노드에서 관리 IP를 가져오기 위한 충돌 시간 제한(#2284)

  • Windows VHD에 1.0.28 Azure CNI .zip 파일 추가(#2268)

  • 설정 IPAddressCount 에 대한 올바른 기본값 순서(#2358)

  • 수동 오류 및 손쉬운 유지 관리를 방지하기 위해 모든 K8s 버전에 단일 omsagent yaml을 사용하도록 업데이트(#2692)

릴리스 정보

다음은 Azure 및 Azure Stack Hub에 대한 전체 릴리스 정보 집합입니다.

다음 단계