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

AKS 엔진의 버전 v 0.63.0에 적용 됩니다.

이 문서에서는 Azure Stack Hub 업데이트에 대 한 AKS (Azure Kubernetes Service) 엔진의 콘텐츠를 설명 합니다. 업데이트에는 Azure Stack 허브 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대 한 향상 된 기능 및 수정 사항이 포함 되어 있습니다. 이는 글로벌 Azure에 대 한 AKS 엔진의 릴리스 정보를 문서화 하기 위한 것이 아닙니다.

업데이트 계획

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

업그레이드 고려 사항

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

업그레이드 명령 사용

Azure Stack 허브의 Kubernetes 클러스터 업그레이드문서에 설명 된 대로 AKS 엔진 업그레이드 명령을 사용 해야 합니다.

업그레이드 중단

경우에 따라 예기치 않은 요인이 클러스터 업그레이드를 중단 합니다. AKS 엔진이 오류를 보고 하거나 AKS 엔진 실행 프로세스에 발생 하는 경우 중단이 발생할 수 있습니다. 업그레이드 프로세스를 계속 하려면 중단의 원인을 확인 하 고이를 해결 한 다음 동일한 업그레이드 명령을 다시 제출 하십시오. 업그레이드 명령은 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 기본 Ubuntu 18.04-LTS 이미지 배포판 (Linux 에이전트에 필요)
  • AKS 기본 Windows Server 이미지 배포판 (Windows 에이전트에 필요)

이 업데이트에서는 다음과 같은 새 버전을 사용할 수 있습니다.

Ubuntu 16.04 배포판를 사용 하 여 만든 Kubernetes 클러스터 업그레이드

AKS Engine v 0.63.0로 시작 하는 Ubuntu 16.04 배포판를 사용 하 여 만든 Kubernetes 클러스터를 업그레이드 하는 경우 OS가 수명 종료에 도달 했으므로 Ubuntu 16.04 배포판가 더 이상 지원 되지 않습니다. 클러스터를 업그레이드 하려면에 aks-ubuntu-18.04 의해 생성 되 aks-engine deploy 고에 대 한 입력으로 전달 되는 입력 API 모델에서 OS 배포판을로 설정 해야 aks-engine upgrade 합니다.

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

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

AKS 엔진 및 Azure Stack 버전 매핑

Azure Stack 허브 버전 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

AKS engine v 0.63.0의 Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack 허브에 대 한 최신 버전 및 업그레이드 버전을 확인할 수 있습니다. 명령에는 글로벌 Azure에서 지원 되는 버전도 포함 되므로 aks 명령을 따르지 마세요. 다음 버전 및 업그레이드 테이블은 Azure Stack Hub의 AKS engine 클러스터에 적용 됩니다.

현재 버전 업그레이드 가능
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.20.6

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

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

AKS 엔진 및 해당 이미지 매핑

AKS 엔진 AKS 기본 이미지 Kubernetes 버전 API 모델 샘플
v 0.43.1 AKS 기본 Ubuntu 16.04-LTS 이미지 배포판, 10 월 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v 0.48.0 AKS 기본 Ubuntu 16.04-LTS 이미지 배포판, 3 월 2020 (2020.03.19) 1.15.10, 1.14.7
v 0.51.0 AKS Base Ubuntu 16.04-LTS Image 배포판 2020, 2020.05.13 (AKS Base Windows Image) (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)

새로운 기능

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

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

  • Kubernetes 1.18.18, 1.19.10, 1.20.6 지원

알려진 문제

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

업그레이드 고려 사항

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

업그레이드 명령 사용

다음 문서 Azure Stack Hub Kubernetes 클러스터 업그레이드에설명된 대로 AKS 엔진 업그레이드 명령을 사용해야 합니다.

업그레이드 중단

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

예상 업그레이드 시간

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

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

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

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

  • aks 엔진 이진 파일(필수)
  • AKS Base Ubuntu 16.04-LTS 이미지 배포판(필수)
  • AKS Base Ubuntu 18.04-LTS 이미지 배포판(선택 사항)
  • AKS 기본 Windows Server 이미지 배포판(선택 사항)

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

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

    • 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)

      다음 문서의 지침에 따라 AKS(Azure Kubernetes Services) 엔진 필수 구성 Azure Stack Hub Marketplace에 추가합니다.

  • Kubernetes 클러스터 관리자(일반적으로 Azure Stack Hub 테넌트 사용자)는 새 aks-engine 버전 0.60.1을 다운로드해야 합니다. 다음 문서인 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에서 지원되는 버전도 포함되어 있기 때문에 aks-engine get-versions 명령을 따르지 마세요. 다음 버전 및 업그레이드 테이블은 Azure Stack Hub AKS 엔진 클러스터에 적용됩니다.

현재 버전 업그레이드 사용 가능
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.js참조).

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

AKS 엔진 및 해당 이미지 매핑

AKS 엔진 AKS 기본 이미지 Kubernetes 버전 API 모델 샘플
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, 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 Image Distro, 2020년 3월(2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, 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 엔진 업그레이드 명령은 클러스터의 업그레이드 프로세스를 완전히 자동화하고 VM(가상 머신), 네트워킹, 스토리지, Kubernetes 및 오케스트레이션 작업을 처리합니다. 업데이트를 적용하기 전에 릴리스 정보 정보를 검토해야 합니다.

업그레이드 고려 사항

  • AKS 엔진 버전에 올바른 마켓플레이스 항목 AKS Base Ubuntu 16.04-LTS Image Distro를 사용하고 있나요? "새 이미지 및 AKS 엔진 다운로드" 섹션에서 버전을 찾을 수 있습니다.

  • 대상 클러스터에 올바른 클러스터 사양( ) 및 리소스 그룹을 사용하고 apimodel.json 있나요? 원래 클러스터를 배포할 때 이 파일은 출력 디렉터리에 생성되었습니다. 명령 deploy 매개 변수 Kubernetes 클러스터 배포를 참조하세요.

  • 신뢰할 수 있는 머신을 사용하여 AKS 엔진을 실행하고 업그레이드 작업을 수행하고 있나요?

  • 활성 워크로드가 있는 운영 클러스터를 업데이트하는 경우 클러스터가 정상 부하에 있다고 가정하여 해당 워크로드에 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 리디렉션해야 하는 경우 백업 클러스터가 있어야 합니다. 백업 클러스터를 권장합니다.

  • 가능하면 Azure Stack Hub 환경 내의 VM에서 명령을 실행하여 네트워크 홉 및 잠재적인 연결 오류를 줄입니다.

  • 구독에 전체 프로세스에 대한 충분한 할당량이 있는지 확인합니다. 프로세스는 프로세스 중에 새 VM을 할당합니다. 결과 VM 수는 원래 VM과 동일하지만 프로세스 중에 몇 개의 VM을 추가로 만들 계획입니다.

  • 시스템 업데이트 또는 예약된 작업은 계획되지 않습니다.

  • 프로덕션 클러스터와 동일한 값으로 구성된 클러스터에서 단계적 업그레이드를 설정하고 프로덕션 클러스터에서 업그레이드를 테스트합니다.

업그레이드 명령 사용

다음 문서 Azure Stack Hub upgrade Kubernetes 클러스터 업그레이드에설명된 대로 AKS 엔진 명령을 사용해야 합니다.

업그레이드 중단

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

예상 업그레이드 시간

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

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

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

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

  • aks 엔진 이진 파일

  • AKS Base Ubuntu 16.04-LTS 이미지 배포판

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

AKS 엔진 및 Azure Stack 버전 매핑

Azure Stack 허브 버전 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 engine v 0.55.4의 Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack 허브에 대 한 최신 버전 및 업그레이드 버전을 확인할 수 있습니다. 명령에는 글로벌 Azure에서 지원 되는 버전도 포함 되므로 aks 명령을 따르지 마세요. 다음 버전 및 업그레이드 테이블은 Azure Stack Hub의 AKS engine 클러스터에 적용 됩니다.

현재 버전 업그레이드 가능
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.16.14를 배포 하려는 경우 다음 두 값을 설정 해야 합니다 ( kubernetes-azurestack.js의예제 참조).

    -   "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)

새로운 기능

  • Azure Stack의 Linux VHD를 2020.09.14 #3828 에 업데이트 합니다.
  • Azure Stack #3702 K8s v 1.17.11에 대 한 지원을 추가 합니다.
  • Azure Stack #3704 K8s v 1.16.14에 대 한 지원을 추가 합니다.
  • 2020.09.14 #3750 에 대 한 Linux VHD 업데이트
  • 8 월 #3730 에 대 한 Windows VHD 업데이트
  • Kubernetes 0.3.7 #3669 로 업그레이드 합니다.
  • Docker 버전을 업그레이드 하 여 로그 회전 문제를 해결 #3693
  • CoreDNS를 v 1.7.0 #3608 로 업그레이드 합니다.
  • Moby 19.03 패키지를 사용 #3549
  • Azure에 대 한 수정-cni 업데이트 전략 #3571

알려진 문제

  • 단일 클러스터 내에서 여러 Kubernetes 서비스를 병렬로 배포 하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 가능 하면 한 번에 하나의 서비스를 배포 합니다.
  • Aks를 실행 하면 Azure 및 Azure Stack Hub에 적용 가능한 정보가 생성 되지만 Azure Stack 허브에 해당 하는 것을 명시적으로 확인할 수 있는 방법은 없습니다. 이 명령을 사용 하 여 업그레이드할 수 있는 버전을 확인할 수 없습니다. 위에서 설명한 업그레이드 참조 테이블을 사용 합니다.
  • Aks 도구는 Azure 및 Azure Stack 허브의 공유 소스 코드 리포지토리입니다. 여러 릴리스 정보 및 끌어오기 요청을 검사 하면 도구에서 위에 나열 된 것 이외의 다른 버전의 Kubernetes 및 OS 플랫폼을 지원 한다고 생각 하 고,이를 무시 하 고 위의 버전 테이블을이 업데이트에 대 한 공식 가이드로 사용할 수 있습니다.

참조

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

AKS 엔진의 버전 0.48.0 또는 이전 버전에 적용 됩니다.

이 문서에서는 Azure Stack Hub 업데이트에 대 한 AKS (Azure Kubernetes Service) 엔진의 콘텐츠를 설명 합니다. 업데이트에는 Azure Stack 허브 플랫폼을 대상으로 하는 AKS 엔진의 최신 릴리스에 대 한 향상 된 기능 및 수정 사항이 포함 되어 있습니다. 이는 글로벌 Azure에 대 한 AKS 엔진의 릴리스 정보를 문서화 하기 위한 것이 아닙니다.

업데이트 계획

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

업그레이드 고려 사항

  • 사용자의 AKS 엔진 버전에 대 한 올바른 marketplace 항목인 AKS Base Ubuntu 16.04-LTS Image 배포판를 사용 하 고 있나요? 새 AKS Base Ubuntu 이미지 및 AKS 엔진 버전 다운로드섹션에서 버전을 찾을 수 있습니다.

  • 대상 클러스터에 대 한 올바른 클러스터 사양 (apimodel.json) 및 리소스 그룹을 사용 하 고 있나요? 클러스터를 처음 배포 하는 경우이 파일이 출력 디렉터리에 생성 됩니다. "배포" 명령 매개 변수 배포 a Kubernetes cluster를 참조 하세요.

  • 신뢰할 수 있는 컴퓨터를 사용 하 여 AKS 엔진을 실행 하 고 있고 업그레이드 작업을 수행 하 고 있습니까?

  • 활성 작업을 사용 하 여 운영 클러스터를 업데이트 하는 경우 클러스터의 정상적인 부하가 있다고 가정할 때 영향을 주지 않고 업그레이드를 적용할 수 있습니다. 그러나 사용자를 해당 사용자에 게 리디렉션해야 하는 경우에는 백업 클러스터가 필요 합니다.

  • 가능 하면 Azure Stack 허브 환경 내의 VM에서 명령을 실행 하 여 네트워크 홉 및 잠재적인 연결 오류를 줄이십시오.

  • 구독에 전체 프로세스에 대 한 충분 한 할당량이 있는지 확인 합니다. 프로세스는 프로세스 중에 새 Vm을 할당 합니다. 생성 되는 Vm 수는 원래와 동일 하지만, 프로세스 중에 만들 Vm을 몇 개 더 계획 합니다.

  • 시스템 업데이트나 예약 된 작업은 계획 되지 않습니다.

  • 프로덕션 클러스터와 동일한 값으로 구성 된 클러스터에서 단계적 업그레이드를 설정 하 고 프로덕션 클러스터에서 업그레이드를 테스트 합니다.

업그레이드 명령 사용

Azure Stack 허브의 Kubernetes 클러스터 업그레이드문서에 설명 된 대로 AKS 엔진 "업그레이드" 명령을 사용 해야 합니다.

업그레이드 중단

경우에 따라 예기치 않은 요인이 클러스터 업그레이드를 중단 합니다. AKS 엔진이 오류를 보고 하거나 AKS 엔진 실행 프로세스에 발생 하는 경우 중단이 발생할 수 있습니다. 업그레이드 프로세스를 계속 하려면 중단의 원인을 확인 하 고이를 해결 한 다음 동일한 업그레이드 명령을 다시 제출 하십시오. 업그레이드 명령은 idempotent 명령을 다시 전송한 후 클러스터 업그레이드를 다시 시작 해야 합니다. 일반적으로 중단은 업데이트를 완료 하는 데 걸리는 시간을 증가 하지만 완료에는 영향을 주지 않습니다.

예상 업그레이드 시간

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

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

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

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

  • Aks 이진 파일
  • AKS 기본 Ubuntu 16.04-LTS 이미지 배포판

이 업데이트에서는 다음과 같은 새 버전을 사용할 수 있습니다.

Kubernetes 버전 업그레이드 경로

다음 표에서 Azure Stack 허브에 대 한 최신 버전 및 업그레이드 버전을 확인할 수 있습니다. get-versions명령에는 글로벌 Azure에서 지원 되는 버전도 포함 되므로 aks 명령을 따르지 마세요. 다음 버전 및 업그레이드 테이블은 Azure Stack Hub의 AKS engine 클러스터에 적용 됩니다.

현재 버전 업그레이드 가능
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 파일 (a.k.s.)에서를 지정 해야 합니다. 클러스터 정의 파일) 릴리스 버전 번호 및 부 버전 번호입니다. kubernetes-azurestack.js에 대한 예제를 찾을 수 있습니다.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    참고

    Kubernetes 버전이 API 모델 json 파일에 명시적으로 제공 되지 않은 경우 버전 1.15 ( # 2932)이 사용 되 고, orchestratorVersion는 기본적으로로 지정 되며 1.15.11 ,이로 인해 클러스터를 배포 하는 동안 오류가 발생 합니다.

  • Aks-engine v 0.43.1를 사용 하는 경우 클라우드 공급자가 제어 루프 및 기타 작업을 수행 하는 기본 빈도 설정이 들어오는 요청에 대 한 임계값 제한 리소스 관리자 Azure Stack 허브에서 제대로 작동 하지 않습니다. 이 업데이트는 Azure Stack 허브의 기본값을 변경 하 여 Azure Stack Hub 리소스 관리자 ( # 2861)에 대 한 다시 시도 부하를 줄입니다.

  • Aks에서 새 확인 단계를 수행 하면 api 모델 json 파일에 Azure Stack 허브가 지원 하지 않는 속성 ( # 2717)이 포함 되어 있는 경우 실행이 중지 되거나 경고가 표시 됩니다.

  • 새 확인 체크 인을 사용 하면 aks는 ( # 2342) 버전의 aks를 실행 하는 데 필요한 aks base 이미지 버전의 가용성을 확인 합니다. 이는 api 모델 파일의 구문을 분석 한 후 Azure Stack 허브 리소스 관리자를 호출 하기 전에 발생 합니다.

  • "업그레이드" 명령의 New aks-engine 옵션은 사용자가 마스터 Virtual Machines ( # 2635)만 대상으로 하는 작업을 업그레이드할 수 있도록 합니다.

  • Linux 커널 버전 4.15.0에 대 한 업데이트-1071-Ubuntu 16.04-LTS 자세한 내용은 "Package: 4.15.0-1071-azure (4.15.0-1071.76) [ security ] "를 참조 하십시오.

  • Kubernetes 버전 1.14.8 및 1.15.10를 지 원하는 새로운 hyperkube 업데이트

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

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

  • coredns를 버전 v 1.6.6 ( # 2555)로 업그레이드 합니다.

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

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

  • 이 릴리스 AKS 엔진은에서 종속성 k8s.gcr.io 을 잘라내어 이제 Kubernetes MCR registry @ mcr.microsoft.com 이미지를 빌드할 때 공식 ( # 2722)을 사용 합니다.

알려진 문제

  • 단일 클러스터 내에서 여러 Kubernetes 서비스를 병렬로 배포 하면 기본 부하 분산 장치 구성에서 오류가 발생할 수 있습니다. 가능 하면 한 번에 하나의 서비스를 배포 합니다.

  • Aks를 실행 하면 Azure 및 Azure Stack Hub에 적용 가능한 정보가 생성 되지만 Azure Stack 허브에 해당 하는 것을 명시적으로 확인할 수 있는 방법은 없습니다. 이 명령을 사용 하 여 업그레이드할 수 있는 버전 영역을 확인할 수 없습니다. 위에서 설명한 업그레이드 참조 테이블을 사용 합니다.

  • Aks 도구는 Azure 및 Azure Stack 허브의 공유 소스 코드 리포지토리입니다. 여러 릴리스 정보 및 끌어오기 요청을 검사 하면 도구에서 위에 나열 된 것 이외의 다른 버전의 Kubernetes 및 OS 플랫폼을 지 원하는 것으로 생각 합니다 .이를 무시 하 고 위의 버전 표를이 업데이트에 대 한 공식 가이드로 사용 하세요.

참조

다음은 0.44.0에서 0.48.0까지 릴리스 정보 전체 집합 및 수정 된 버그의 목록입니다. 후자 목록에는 Azure 및 Azure Stack Hub 항목이 포함 됩니다.

버그 수정

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

  • Addons update config 는 업그레이드 전용입니다. ( # 2282)

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

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

  • IPAddressCount 설정 ( # 2358)에 대 한 기본값을 수정 합니다.

  • 모든 k8s 버전에 대해 단일 omsagent yaml을 사용 하 여 수동 오류 및 쉬운 유지 관리를 방지 하는 업데이트 ( # 2692)

릴리스 정보

Azure 및 Azure Stack Hub의 전체 릴리스 정보 집합은 다음과 같습니다.

다음 단계