AKS(Azure Kubernetes Service)에서 지원되는 Kubernetes 버전

Kubernetes 커뮤니티 약 4개월마다 부 버전을 릴리스합니다.

부 버전 릴리스에는 새로운 기능과 향상된 기능이 포함됩니다. 패치는 더 자주 릴리스되며(매주 릴리스되기도 함), 부 버전의 중요한 버그 수정용으로만 제공됩니다. 패치 릴리스에는 보안 취약성 또는 주요 버그에 대한 수정이 포함됩니다.

Kubernetes 버전

Kubernetes는 표준 유의적 버전 버전 관리 체계를 각 버전에 사용합니다.

[major].[minor].[patch]

Examples:
  1.29.2
  1.29.1

버전의 각 번호는 이전 버전과의 일반적인 호환성을 나타냅니다.

• 주 버전은 호환되지 않는 API 업데이트 또는 이전 버전과의 호환성이 손상될 수 있으면 변경됩니다.
• 부 버전은 다른 부 릴리스의 이전 버전과 호환되는 기능 업데이트가 수행되면 변경됩니다.
• 패치 버전은 이전 버전과 호환되는 버그 수정이 수행되면 변경됩니다.

실행하는 부 버전의 최신 패치 릴리스를 실행하는 것을 목표로 합니다. 예를 들어 프로덕션 클러스터가 1.29.1을(를) 사용 중이고, 1.29.2이(가) 1.29 부 버전에 사용할 수 있는 최신 패치 버전인 경우 클러스터가 완전히 패치되고 지원되도록 가능한 한 빨리 1.29.2(으)로 업그레이드해야 합니다.

AKS Kubernetes 릴리스 달력

AKS Kubernetes 릴리스 달력에서 예정된 버전 릴리스를 봅니다. 지역 릴리스 상태 및 버전 릴리스 정보의 실시간 업데이트를 보려면 AKS 릴리스 상태 웹 페이지를 방문하세요. 릴리스 상태 웹 페이지에 대한 자세한 내용은 AKS 릴리스 추적기를 참조하세요.

이전 릴리스 기록은 Kubernetes 기록을 참조하세요.

LTS 버전

AKS Kubernetes 릴리스 일정 Gantt 차트

이 정보를 시각적으로 확인하려면 현재 릴리스가 모두 표시된 Gantt 차트를 참조하세요.

버전별 AKS 구성 요소 호환성이 손상되는 변경

사용 가능한 부 버전으로 업그레이드하기 전에 다음과 같은 중요한 변경 내용을 확인합니다.

Kubernetes 1.30

Kubernetes 1.29

Kubernetes 1.28

Kubernetes 1.27

별칭 부 버전

AKS를 사용하면 정확한 패치 버전을 지정하지 않고도 클러스터를 만들 수 있습니다. 패치를 지정하지 않고 클러스터를 만들면 클러스터는 부 버전의 최신 GA 패치를 실행합니다. 예를 들어 1.29을(를) 사용하여 클러스터를 만들고, 1.29.2이(가) 사용 가능한 최신 GA 패치인 경우 1.29.2을(를) 사용하여 클러스터가 생성됩니다. 패치 버전을 동일한 부 버전으로 업그레이드하려면 자동 업그레이드를 사용하세요.

어떤 패치가 있는지 확인하려면 az aks show --resource-group myResourceGroup --name myAKSCluster 명령을 실행합니다. currentKubernetesVersion 속성은 전체 Kubernetes 버전을 표시합니다.

{
 "apiServerAccessProfile": null,
  "autoScalerProfile": null,
  "autoUpgradeProfile": null,
  "azurePortalFqdn": "myaksclust-myresourcegroup.portal.hcp.eastus.azmk8s.io",
  "currentKubernetesVersion": "1.29.2",
}

Kubernetes 버전 지원 정책

AKS는 GA(일반 공급) 버전을 모든 지역에서 사용할 수 있고 모든 SLO 또는 SLA 측정에서 사용하도록 설정되는 버전으로 정의합니다. AKS에서 지원하는 Kubernetes의 3개 GA 부 버전은 다음과 같습니다.

• AKS에서 릴리스된 최신 GA 부 버전입니다(N이라고 함).
• 이전 부 버전 2개.
  • 지원되는 각 부 버전은 지정된 시간에 여러 패치를 지원할 수 있습니다. AKS는 중요한 CVE 또는 보안 취약성이 감지된 경우 패치를 더 이상 사용하지 않을 권리를 보유합니다. 패치 가용성 및 임시 사용 중단에 대한 인식은 버전 릴리스 정보를 참조하고 AKS 릴리스 상태 웹 페이지를 방문하세요.

또한 AKS는 미리 보기 사용 약관에 따라 명시적으로 레이블이 지정된 미리 보기 버전을 지원할 수도 있습니다.

AKS는 일반 지원 버전 이후 하나의 Kubernetes GA 부 버전에 대해서만 플랫폼 지원을 제공합니다. AKS에서 Kubernetes 버전의 플랫폼 지원 기간은 "N-3"으로 알려져 있습니다. 자세한 내용은 플랫폼 지원 정책을 참조하세요.

AKS에서 지원되는 Kubernetes 부 버전의 창은 "N-2"라고 합니다. 여기서 N은 최신 릴리스를 참조하며, 이는 두 개의 이전 부 릴리스도 지원됨을 의미합니다.

예를 들어 AKS에서 버전 1.29를 도입하는 날에는 다음 버전에 대한 지원이 제공됩니다.

새로운 부 버전이 릴리스되면 지원되는 가장 오래된 부 버전 및 패치 릴리스는 사용 중단되고 제거됩니다. 예를 들어 현재 지원되는 부 버전 목록은 다음과 같습니다.

1.29
1.28
1.27

AKS에서 1.30을 릴리스하면 30일 후에 모든 1.27 버전이 지원에서 제외됩니다.

AKS는 지정된 부 버전에 대한 업스트림 커뮤니티 릴리스 가용성을 기반으로 여러 패치를 지원할 수 있습니다. AKS는 CVE 또는 잠재적인 버그 문제로 인해 언제든지 이러한 패치를 더 이상 사용하지 않을 권리가 있습니다. 항상 부 버전에 최신 패치를 사용하는 것이 좋습니다.

플랫폼 지원 정책

플랫폼 지원 정책은 지원되지 않는 특정 Kubernetes 버전에 대한 축소된 지원 계획입니다. 플랫폼 지원 중에 고객은 AKS/Azure 플랫폼 관련 문제에 대해서만 Microsoft로부터 지원을 받습니다. Kubernetes 기능 및 구성 요소와 관련된 문제는 지원되지 않습니다.

플랫폼 지원 정책은 클러스터가 n-4로 떨어지기 전에 n-3 버전(여기서 n은 지원되는 최신 AKS GA 부 버전)의 클러스터에 적용됩니다. 예를 들어, v1.29가 최신 GA 버전인 경우 Kubernetes v1.26은 플랫폼 지원으로 간주됩니다. 그러나 v1.30 GA 릴리스 중에는 v1.26이 v1.27로 자동 업그레이드됩니다. n-2 버전을 실행 중인 경우 n-3 버전이 되는 순간 더 이상 사용되지 않으며 플랫폼 지원 정책을 시작하게 됩니다.

AKS는 세 가지 부 버전의 슬라이딩 윈도우만 지원하는 오픈 소스 프로젝트인 Kubernetes의 릴리스와 패치를 사용합니다. AKS는 해당 버전이 업스트림으로 서비스되는 동안에만 완전한 지원을 보장할 수 있습니다. 더 이상 업스트림으로 생성되는 패치가 없으므로 AKS는 해당 버전을 패치되지 않은 상태로 두거나 포크할 수 있습니다. 이러한 제한 사항으로 인해 플랫폼 지원은 Kubernetes 업스트림에 의존하는 어떤 것도 지원하지 않습니다.

이 표에는 플랫폼 지원과 비교하여 커뮤니티 지원에 대한 지원 지침이 요약되어 있습니다.

지원되는 kubectl 버전

kubectl에 대한 Kubernetes 지원 정책에 따라 kube-apiserver 버전에 비례하여 이전 또는 최신 kubectl의 부 버전 하나를 사용할 수 있습니다.

예를 들어 kube-apiserver가 1.28에 있으면 해당 kube-apiserver와 함께 kubectl의 1.27~1.29 버전을 사용할 수 있습니다.

kubectl을 설치하거나 최신 버전으로 업데이트하려면 다음을 실행합니다.

az aks install-cli

Install-AzAksKubectl -Version latest

LTS(장기 지원)

AKS는 퍼블릭 리포지토리의 커뮤니티 업스트림에서 포트 보안 수정을 지원하기 위해 1년 커뮤니티 지원 및 1년 LTS(장기 지원)를 제공합니다. 업스트림 LTS 작업 그룹은 고객에게 더 긴 지원 기간을 제공하기 위해 이 커뮤니티에 다시 기여합니다.

LTS에 대한 자세한 내용은 AKS(Azure Kubernetes Service)에 대한 장기 지원을 참조하세요.

릴리스 및 사용 중단 프로세스

AKS Kubernetes 릴리스 달력에서 예정된 버전 릴리스 및 사용 중단을 참조할 수 있습니다.

새 Kubernetes 부 버전의 경우

• AKS는 AKS 릴리스 정보에 새 버전 릴리스의 계획된 날짜와 함께 각 이전 버전의 사용 중단에 대한 공지를 제거하기 전 최소 30일 전에 게시합니다.
• AKS는 Azure Advisor를 사용하여 새 버전이 더 이상 사용되지 않는 API로 인해 클러스터에 문제를 일으킬 수 있는지 경고합니다. Azure Advisor는 지원이 중단된 경우에도 경고합니다.
• AKS는 AKS 및 포털 액세스 권한이 있는 모든 사용자가 사용할 수 있는 서비스 상태 알림을 게시하고 구독 관리자에게 예정된 버전 제거 날짜가 포함된 이메일을 보냅니다.

  참고 항목

  구독 관리자 또는 변경하려는 사용자를 확인하려면 Azure 구독 관리를 참조하세요.

• 버전 제거 후 30일 동안 지원되는 부 버전 릴리스로 업그레이드하여 지원을 계속 받을 수 있습니다.

새 Kubernetes 패치 버전의 경우

• 이러한 버전은 패치 버전의 긴급한 특성으로 인해 사용 가능한 대로 서비스에 도입될 수 있습니다. 일단 사용 가능해지면 패치의 최소 수명 주기는 2개월입니다.
• 일반적으로 AKS는 새 패치 버전의 릴리스를 광범위하게 전달하지 않습니다. 그러나 AKS는 적시에 AKS에서 지원하기 위해 사용 가능한 CVE 패치를 지속적으로 모니터링하고 유효성을 검사합니다. 중요한 패치가 발견되거나 사용자 작업이 필요한 경우 AKS는 새로 사용 가능한 패치로 업그레이드하라고 알립니다.
• AKS에서 패치 릴리스가 제거된 후 30일 내에 지원되는 패치로 업그레이드하고 지원을 계속 받을 수 있습니다. 그러나 버전이 더 이상 사용되지 않거나 제거되면 클러스터 또는 노드 풀을 더 이상 만들 수 없습니다.

지원되는 버전 정책 예외

AKS에는 사전에 알리지 않고 프로덕션에 영향을 주는 하나 이상의 중요한 버그 또는 보안 문제가 있는 신규/기존 버전을 추가하거나 제거할 수 있는 권한이 있습니다.

버그 또는 보안 문제의 심각도에 따라 특정 패치 릴리스를 건너뛰거나 롤아웃을 가속화할 수 있습니다.

Azure Portal 및 CLI 버전

Azure Portal, Azure CLI, Azure PowerShell을 사용하여 AKS 클러스터를 배포하는 경우 클러스터는 기본적으로 N-1 부 버전 및 최신 패치로 설정됩니다. 예를 들어 AKS에서 1.29.2, 1.29.1, 1.28.7, 1.28.6, 1.27.11, 1.27.10을 지원하는 경우 선택된 기본 버전은 1.28.7입니다.

az aks get-versions --location eastus --output table

Get-AzAksVersion -Location eastus

FAQ

Microsoft에서 새 Kubernetes 버전을 알리는 방법은 무엇인가요?

AKS 팀은 설명서 GitHub와 지원이 중단될 클러스터를 소유한 구독 관리자에게 보내는 이메일을 통해 새로운 Kubernetes 버전의 예정 날짜가 포함된 공지 사항을 게시합니다. AKS는 또한 지원이 중단된 경우 Azure Advisor를 사용하여 Azure Portal 내부에서 경고하고 애플리케이션이나 개발 프로세스에 영향을 줄 수 있는 더 이상 사용되지 않는 API에 대해 알려 줍니다.

계속 지원받으려면 Kubernetes 버전을 얼마나 자주 업그레이드해야 하나요?

Kubernetes 1.19부터 오픈 소스 커뮤니티의 지원이 1년으로 확장되었습니다. AKS는 전적으로 업스트림 약정과 일치하는 패치 및 지원을 사용하도록 설정합니다. 1.19 이상의 AKS 클러스터의 경우 최소 1년에 한 번 업그레이드하여 지원되는 버전을 유지할 수 있습니다.

지원되지 않는 부 버전으로 Kubernetes 클러스터를 업그레이드하면 어떻게 되나요?

n-3 버전 이전인 경우에는 지원 범위에 해당되지 않음을 의미하며, 업그레이드하라는 메시지를 받게 됩니다. 버전 n-3에서 n-2로 업그레이드하면 지원 정책 내에 다시 포함됩니다. 예시:

• 지원되는 가장 오래된 AKS 부 버전이 1.27이고, 1.26 이상을 사용하는 경우에는 지원되지 않습니다.
• 1.26에서 1.27 이상으로 업그레이드하면 지원 정책 내에서 다시 지원됩니다.

다운그레이드는 지원되지 않습니다.

‘지원에 포함되지 않음’은 무엇을 의미하나요?

'지원되지 않음'은 다음을 의미합니다.

• 실행하는 버전이 지원되는 버전 목록에 없습니다.
• 버전 사용 중단 후 30일의 유예 기간 내에 있는 경우를 제외하고는 지원을 요청할 때 클러스터를 지원되는 버전으로 업그레이드하라는 메시지가 표시됩니다.

또한 AKS는 지원되는 버전 목록에 해당하지 않는 클러스터에 대한 런타임 또는 다른 보증을 수행하지 않습니다.

지원되지 않는 부 버전으로 Kubernetes 클러스터를 스케일링하면 어떻게 되나요?

AKS에서 지원하지 않는 부 버전의 경우 규모 축소 또는 규모 확대가 계속 작동해야 합니다. 서비스 품질이 보장되지 않으므로 클러스터를 다시 지원하도록 업그레이드하는 것이 좋습니다.

Kubernetes 버전을 계속 사용할 수 있나요?

클러스터가 3개를 초과하는 부 버전에 대해 지원되지 않고 보안 위험이 발생하는 것으로 확인되면 Azure에서 클러스터를 업그레이드하도록 사용자에게 사전에 연락합니다. 추가 작업을 수행하지 않으면 Azure는 사용자를 대신하여 자동으로 클러스터를 업그레이드할 권리를 가집니다.

지원되지 않는 부 버전을 사용하여 Kubernetes 클러스터를 스케일링하면 어떻게 되나요?

AKS에서 지원하지 않는 부 버전의 경우 규모 축소 또는 규모 확대가 계속 작동해야 합니다. 서비스 품질이 보장되지 않으므로 클러스터를 다시 지원하도록 업그레이드하는 것이 좋습니다.

노드 풀이 지원되는 AKS 버전 중 하나가 아닌 경우 컨트롤 플레인은 어떤 버전을 지원하나요?

컨트롤 플레인은 모든 노드 풀의 버전 기간 내에 있어야 합니다. 컨트롤 플레인 또는 노드 풀의 업그레이드에 관한 자세한 내용은 노드 풀 업그레이드에 대한 설명서를 참조하세요.

컨트롤 플레인과 노드 풀 간에 허용되는 버전 차이는 무엇인가요?

이제 버전 차이 정책을 통해 컨트롤 플레인과 에이전트 풀 간에 최대 3개의 버전 차이가 허용됩니다. AKS는 버전 1.28부터 이러한 기울이기 버전 정책 변경 내용을 따릅니다.

여러 AKS 버전을 건너뛰면서 클러스터를 업그레이드할 수 있나요?

지원되는 AKS 클러스터를 업그레이드하는 경우 Kubernetes 부 버전은 건너뛸 수 없습니다. Kubernetes 컨트롤 플레인 버전 차이 정책은 부 버전 건너뛰기를 지원하지 않습니다. 예를 들어 다음과 같이 업그레이드합니다.

• 1.28.x ->1.29.x: 허용됨.
• 1.27.x ->1.28.x: 허용됨.
• 1.27.x ->1.29.x: 허용되지 않음.

컨트롤 플레인 버전 업그레이드의 경우 커뮤니티 지원 버전에 대해 순차적으로 최대 3개의 부 버전을 사용할 수 있습니다.

1.27.x ->1.29.x에서 업그레이드하려면 다음을 수행합니다.

1. 1.27.x ->1.28.x에서 업그레이드.
2. 1.28.x ->1.29.x에서 업그레이드.

1.28 버전부터 에이전트 풀 버전은 버전 기울이기 정책당 평면 버전을 제어하기 위해 최대 3개 버전이 될 수 있습니다. 버전이 지원되는 최소 버전보다 훨씬 뒤처진 경우 지원되는 최소 버전으로 가져오기 위해 둘 이상의 컨트롤 플레인 업그레이드 작업을 수행해야 할 수 있습니다. 예를 들어 현재 컨트롤 플레인 버전이 1.23.x 이고 지원되는 최소 버전 인 1.27.x 로 업그레이드하려는 경우를 예로 들어 볼 수 있습니다. 1.27.x를 얻으려면 1.23.x에서 순차적으로 4번 업그레이드해야 할 수 있습니다. 또한 에이전트 풀 버전은 컨트롤 플레인 부 버전으로 업그레이드할 수 있습니다. 즉, 위의 예제에서는 컨트롤 플레인 버전이 1.25.x인 경우 agentpool 버전을 1.23.x 에서 1.25.x로 두 번 업그레이드할 수 있습니다. 이후 컨트롤 플레인 버전이 1.27.x인 경우 1.25.x에서 1.27.x로 변경됩니다. 현재 위치에서 업그레이드하는 경우 즉, 컨트롤 플레인과 에이전트 풀을 함께 업그레이드할 때 위에 기록된 컨트롤 플레인 업그레이드에 적용할 수 있는 동일한 규칙이 적용됩니다.

지원되지 않는 버전에서 업그레이드를 수행하는 경우 업그레이드는 기능을 보장하지 않고 수행되며 서비스 수준 계약 및 제한된 보증에서 제외됩니다. 지원되지 않는 버전을 실행하는 클러스터에는 컨트롤 플레인 업그레이드를 노드 풀 업그레이드와 분리할 수 있는 유연성이 있습니다. 그러나 버전이 상당히 오래된 경우 클러스터를 다시 만드는 것이 좋습니다.

플랫폼 지원 기간 동안 새 1.xx.x 클러스터를 만들 수 있나요?

아니요, 플랫폼 지원 기간 동안에는 새 클러스터를 만들 수 없습니다.

플랫폼 지원을 사용하지 않는 새로 사용되지 않는 버전에 있습니다. 새 노드 풀을 추가할 수 있나요? 아니면 업그레이드해야 하나요?

예, 컨트롤 플레인 버전과 호환되는 한 에이전트 풀을 추가할 수 있습니다.

다음 단계

클러스터를 업그레이드하는 방법에 대한 자세한 내용은 다음을 참조하세요.

• AKS(Azure Kubernetes Service) 클러스터 업그레이드
• Azure Kubernetes Fleet Manager를 통해 여러 AKS 클러스터 업그레이드