이 문서에서는 AKS(Azure Kubernetes Service) 노드에 사용할 수 있는 OS 버전과 OS 버전을 테스트하고 업그레이드하는 모범 사례를 설명합니다.
중요합니다
March 17, 2027부터 AKS(Azure Kubernetes Service) 더 이상 Ubuntu 20.04에 대한 보안 업데이트를 지원하거나 제공하지 않습니다. 기존 노드 이미지는 삭제되며 Ubuntu 20.04를 실행하는 노드 풀의 크기를 조정할 수 없습니다. 노드 풀을 Kubernetes 버전 1.35 이상으로 업그레이드하여 지원되는 Ubuntu 버전으로 마이그레이션합니다. 이 서비스 중단에 대한 자세한 내용은 사용 중지 관련 GitHub 이슈 및 Azure 업데이트의 사용 중지 공지를 참조하세요. 공지 사항 및 업데이트 소식을 접하려면 AKS 릴리스 정보를 참고하세요.
중요합니다
2027년 1월 30일부터 AKS(Azure Kubernetes Service) 더 이상 Ubuntu 22.04에 대한 보안 업데이트를 지원하거나 제공하지 않습니다. 중단을 방지하려면 해당 날짜까지 Ubuntu 24.04 이상으로 전환 합니다. 현재와 2027년 6월 30일 사이에 중단 없이 AKS에서 Ubuntu 22.04를 계속 사용할 수 있습니다. 2027년 6월 30일까지 마이그레이션하지 않으면 새 노드 풀을 만들 수 없고, AKS는 새 노드 이미지를 생성하지 않으며, 기존 노드 풀에 대한 보안 패치를 더 이상 받지 않습니다. Kubernetes 버전 1.33 이상에서 LTS(장기 지원)를 사용하도록 설정하려면 먼저 노드 풀을 Ubuntu 24.04로 업데이트합니다. 2028년 4월 30일에 AKS는 Ubuntu 22.04 노드 이미지와 기존 코드를 제거하여 크기 조정 및 수정 작업이 실패합니다. 보안 취약성, 실패한 노드 이미지 업그레이드 및 크기 조정 오류와 같은 서비스 중단을 방지하려면 2027년 6월 30일까지 Ubuntu 24.04 이상으로 마이그레이션 합니다. 마이그레이션 옵션은 다음과 같습니다.
-
OSSku(기본 운영 체제 SKU): 사용하는
Ubuntu경우 Kubernetes 버전을 1.35 이상으로 업그레이드할 때 자동으로 Ubuntu 24.04로 마이그레이션됩니다. -
버전이 지정된 OSSku:
Ubuntu2204을(를) 사용하는 경우, Kubernetes 1.35 이상에서는Ubuntu로, 그리고 Kubernetes 1.32 이상에서는Ubuntu2404로 OSSku를 업데이트하십시오.
이 사용 중지에 대한 자세한 내용은 GitHub 이슈 및 Azure 업데이트 포스트를 참조하세요. 공지 사항 및 업데이트 소식을 접하려면 AKS 릴리스 정보를 참고하세요.
중요합니다
November 30, 2025부터 AKS(Azure Kubernetes Service) 더 이상 Azure Linux 2.0에 대한 보안 업데이트를 지원하거나 제공하지 않습니다. Azure Linux 2.0 노드 이미지는 202512.06.0 릴리스 고정되어 있습니다. 2026년 3월 31일부터 노드 이미지가 제거되며 노드 풀의 크기를 조정할 수 없습니다. 노드 풀을 지원되는 Kubernetes 버전으로 업그레이드하거나 osSku AzureLinux3 마이그레이션하여 지원되는 Azure Linux 버전으로 마이그레이션합니다. 자세한 내용은 GitHub 서비스 종료 이슈 및 Azure 업데이트 서비스 종료 공지를 참조하세요. 공지 사항 및 업데이트 소식을 접하려면 AKS 릴리스 정보를 참고하세요.
지원되는 OS 버전
각 노드 이미지는 OS SKU를 사용하여 지정할 수 있는 OS 버전에 해당합니다. 클러스터 및 노드 풀을 만들 때 다음 매개 변수를 지정할 수 있습니다.
- --os-type: Linux 또는 Windows 포함한 OS 유형입니다. 클러스터를 만들거나 업데이트할 때 Windows OS 유형을 지정할 수 없습니다.
- --os-sku: OS 버전 또는 OS 변형을 지정하는 데 사용됩니다. 클러스터를 만들거나 업데이트하는 동안에는 Windows OS SKU를 지정할 수 없습니다. 지원되는 OS SKU 옵션에 대한 자세한 내용은 Azure AKS CLI 또는 API 참조하세요.
- --kubernetes-version: 노드 풀 또는 클러스터를 만드는 데 사용할 Kubernetes 버전입니다.
모범 사례 지침
기본 OS 버전은 가장 최근에 유효성이 검사된 버전입니다.
- Ubuntu의 경우 클러스터 및 노드 풀을 만들 때
--os-type Linux및--os-sku Ubuntu을(를) 지정하는 것이 좋습니다. 그러면 Kubernetes 버전에 따라 최신 기본 Ubuntu 버전으로 자동으로 업데이트됩니다.- Azure Linux의 경우
--os-type Linux및--os-sku AzureLinux지정하면서 클러스터 및 노드 풀을 만드는 것이 좋습니다. 그러면 Kubernetes 버전에 따라 최신 기본 Azure Linux 버전으로 자동으로 업데이트됩니다.- Windows 경우
--os-type Windows및--os-sku Windows2022지정하는 동안 노드 풀을 만드는 것이 좋습니다. 노드 풀이 릴리스되면 노드 풀을 다음 OS 버전으로 수동으로 업데이트해야 합니다.
| OS 유형 | 운영 체제 SKU | 지원되는 Kubernetes 버전 | 기본 버전 관리 |
|---|---|---|---|
| Linux | Ubuntu | 이 OS SKU는 모든 Kubernetes 버전에서 지원됩니다. | 이 OS SKU의 OS 버전은 Kubernetes 버전에 따라 변경됩니다. Ubuntu 22.04는 Kubernetes 버전 1.25~1.34의 기본값입니다. Ubuntu 24.04는 Kubernetes 버전 1.35 이상에 대한 기본값입니다. |
| Linux | Ubuntu2404 | 이 OS SKU는 Kubernetes 1.32에서 1.38까지만 지원됩니다. | Kubernetes 버전을 업그레이드하지 않고 새 OS 버전으로 마이그레이션하려는 경우 이 버전 OS SKU를 사용하는 것이 좋습니다. Ubuntu 24.04는 Kubernetes 버전 1.35 이상에서 사용하는 --os-sku Ubuntu 경우 기본값입니다. |
| Linux | Ubuntu2204 | 이 OS SKU는 Kubernetes 버전 1.25에서 1.36까지 지원됩니다. | Ubuntu 22.04로 롤백해야 하는 경우 이 버전이 지정된 OS SKU를 사용하는 것이 좋습니다. Ubuntu 22.04는 Kubernetes 1.25부터 1.35 버전에서 --os-sku Ubuntu을(를) 사용할 때 기본값입니다. |
| Linux | AzureLinux | 이 OS SKU는 모든 Kubernetes 버전에서 지원됩니다. | 이 OS SKU의 OS 버전은 Kubernetes 버전에 따라 변경됩니다. Azure Linux 2.0은 Kubernetes 버전 1.27에서 1.31로 기본값입니다. Azure Linux 3.0은 Kubernetes 버전 1.32 이상에 대한 기본값입니다.
AzureLinuxV3Preview AKS 1.31에서 기능 플래그를 사용하도록 설정하면 기본값은 --os-sku AzureLinux 3.0입니다. |
| Linux | AzureLinux3 | 이 OS SKU는 Kubernetes 1.28에서 1.36까지 지원됩니다. | Kubernetes 버전을 업그레이드하지 않고 새 OS 버전을 테스트하려는 경우 이 OS SKU를 사용하는 것이 좋습니다. 이 OS SKU를 사용하여 Azure Linux 2.0에서 Azure Linux 3.0으로 마이그레이션할 수도 있습니다. |
| Linux | AzureLinuxOSGuard | 이 OS SKU는 Kubernetes 버전 1.32 이상에서 지원됩니다. | OS Guard 버전이 있는 Azure Linux는 노드 이미지 업그레이드를 통해 업그레이드됩니다. 자세한 내용은 AKS용 OS Guard가 있는 Azure Linux 참조하세요. |
| Linux | 플랫카(Flatcar) | 이 OS SKU는 모든 Kubernetes 버전에서 지원됩니다. | 플랫카 버전은 노드 이미지 업그레이드를 통해 업그레이드됩니다. 자세한 내용은 AKS용 Flatcar Container Linux를 참조하세요. |
| Windows | Windows2019 | 1.14에서 1.32로 | Kubernetes 버전 1.14에서 1.24까지의 Windows OS 유형에 대한 기본값입니다. |
| Windows | Windows2022 | 1.23에서 1.34로 | Kubernetes 버전 1.25에서 1.34까지의 Windows OS 유형에 대한 기본값입니다. |
새 OS 버전으로 마이그레이션
AKS에서 새 OS 버전이 릴리스되면 처음에는 미리 보기에서 지원됩니다. 몇 달 동안 미리 보기에서 테스트한 후 AKS는 새 OS 버전을 GA(일반 공급)로 만들고 기본 OS SKU(Ubuntu 또는 AzureLinux)를 최신 GA OS 버전으로 업데이트합니다. 이 기본 업데이트는 새 Kubernetes 버전 릴리스에서 발생합니다.
미리 보기에서 사용할 수 있게 되면 새 OS 버전으로 비프로덕션 워크로드를 테스트하는 것이 좋습니다. 미리 보기 함수에 액세스하려면 미리 보기 확장이 설치되어 있는지 확인합니다.
az extension add --name aks-preview 명령어를 사용하여 확장을 설치할 수 있습니다.
새 OS 버전으로 마이그레이션하는 방법에는 두 가지가 있습니다.
-
기본 OS SKU: 같은
UbuntuAzureLinux기본 OS SKU를 사용하는 경우 Kubernetes 버전을 업그레이드할 때 자동으로 최신 GA 버전을 가져옵니다. 새 OS 버전으로 마이그레이션하는 데 필요한 수동 변경은 없습니다. OS SKU를 사용하는Ubuntu클러스터 및 노드 풀은 Kubernetes 버전을 1.35 이상으로 업그레이드할 때 자동으로 Ubuntu 24.04로 마이그레이션됩니다. -
버전이 지정된 OS SKU: 버전이 지정된 OS SKU(예:
Ubuntu2404AzureLinux3Windows2025또는)를 사용하는 경우 Kubernetes 업그레이드가 차단되지 않도록 새 OS 버전으로 수동으로 마이그레이션해야 합니다. Linux OS를 사용하는 경우 기존 노드 풀에서 OS SKU를 업데이트하여 수동으로 마이그레이션할 수 있습니다.
기존 노드 풀에서 OS SKU 업데이트
기존 노드 풀의 os-sku을(를) az aks nodepool update 명령을 사용하여 업데이트합니다. 미리 보기에서 사용할 수 있는 새 OS 버전이 있는 경우 이 기능을 사용하면 Kubernetes 버전을 업그레이드할 필요 없이 노드 풀을 새 OS 버전으로 마이그레이션할 수 있습니다.
비고
노드 풀 업데이트 명령에는 다음 값이 지원되지 않습니다.
--os-sku Windows2019--os-sku Windows2022--os-sku Windows2025
대신 사용하려는 해당 --os-sku 노드 풀을 클러스터에 추가해야 합니다.
az aks nodepool update \
--resource-group $RESOURCE_GROUP \
--cluster-name $CLUSTER_NAME \
--os-sku Ubuntu \
--name $NODE_POOL_NAME \
--node-count 1
이 az aks nodepool update 명령을 사용하여 지원되는 Linux os-sku간에 마이그레이션할 수 있습니다. 대상 OS에 Kubernetes 버전, VM 크기 또는 FIPS 사용 설정에 대해 지원되는 노드 이미지가 없는 경우 명령이 실패할 수 있습니다.
Ubuntu 24.04로 마이그레이션
Ubuntu 24.04는 Kubernetes 버전 1.35 이상에서 기본값 --os-sku Ubuntu 입니다. Ubuntu 24.04를 지정하여 사용할 수도 있습니다 --os-sku Ubuntu2404.
비고
--os-sku Ubuntu2404로 마이그레이션할 때 다음 정보를 유의하세요.
- FIPS 는 지원되지 않습니다.
- Ubuntu 24.04는 Kubernetes 버전 1.32에서 1.38까지 지원됩니다.
- AKS의 Ubuntu 24.04 노드 이미지는 기본적으로 컨테이너된 2.0을 사용합니다. 컨테이너 런타임 동작을 사용하는 워크로드는 Ubuntu 24.04로 마이그레이션할 때 컨테이너 2.0으로 유효성을 검사해야 합니다.
- Kubernetes 버전을 1.39 이상으로 업그레이드하기 전에 OS SKU를 지원되는 OS 옵션으로 업데이트해야 합니다.
--os-sku Ubuntu2404는 옵션이며 Kubernetes 버전을 업그레이드할 필요 없이 새 OS Linux 버전을 테스트하기 위한 것입니다. - 미리 보기 Azure CLI 버전 18.0.0b5 이상은 preview 및 GA 설치 및 구성용 버전 2.82.0이 필요합니다. CLI 버전을 찾으려면
az --version을 실행합니다. 설치하거나 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.
기존 노드 풀에서 --os-sku Ubuntu2404 명령을 사용하여 az aks nodepool update으로 업데이트합니다.
az aks nodepool update \
--resource-group $RESOURCE_GROUP \
--cluster-name $CLUSTER_NAME \
--os-sku Ubuntu2404 \
--kubernetes-version 1.32.0 \
--name $NODE_POOL_NAME \
--node-count 1
Azure Linux 3.0으로 마이그레이션
Azure Linux 3.0은 Kubernetes 버전 1.32에서 1.36까지의 --os-sku AzureLinux 기본값입니다.
--os-sku AzureLinux3 지정하여 Azure Linux 3.0을 사용할 수도 있습니다.
비고
--os-sku AzureLinux3로 마이그레이션할 때 다음 정보를 유의하세요.
-
--os-sku AzureLinux3는 Kubernetes 버전 1.28에서 1.36까지 지원됩니다. -
--os-sku AzureLinux3Kubernetes 버전을 업그레이드하지 않고 Azure Linux 3.0으로 마이그레이션하기 위한 것입니다. Kubernetes 버전을 1.37 이상으로 업그레이드하기 전에 OS SKU를 지원되는 OS 옵션으로 업데이트해야 합니다. - Azure CLI 버전 18.0.0b36 이상이 preview를 위해 필요하며, GA를 위해서는 버전 2.78.0 이상이 설치 및 구성되어야 합니다. CLI 버전을 찾으려면
az --version을 실행합니다. 설치하거나 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.
기존 노드 풀에서 --os-sku AzureLinux3 명령을 사용하여 az aks nodepool update으로 업데이트합니다.
az aks nodepool update \
--resource-group $RESOURCE_GROUP \
--cluster-name $CLUSTER_NAME \
--os-sku AzureLinux3 \
--kubernetes-version 1.30.0 \
--name $NODE_POOL_NAME \
--node-count 1
OS 버전 되돌리기
여러 OS 버전이 지원되는 Kubernetes 버전에서는 이 명령을 사용하여 az aks nodepool update 이전 OS 버전으로 롤백할 수 있습니다.
다음 시나리오에서 OS 버전을 롤백할 수 있습니다.
- 새 운영 체제 버전을 테스트할 때 문제가 발생할 경우.
- 새 OS 버전을 기본값으로 지원하는 Kubernetes 버전으로 업그레이드하면 기본
Ubuntu또는AzureLinuxOS SKU로 롤백할 수 있습니다. 이렇게 하면 노드 풀 업데이트를 요구하는 대신 Kubernetes 업그레이드의 일부로 향후 OS 버전을 가져올 수 있습니다.
OS 버전을 기본 OS SKU로 롤백
명령을 az aks nodepool update 사용하여 기존 노드 풀에서 os-sku 업데이트할 수 있습니다. Kubernetes 버전에서 지원되는 이전 OS 버전이 있는 경우 이 기능을 사용하여 OS 버전을 롤백할 수 있습니다.
비고
노드 풀 업데이트 명령에는 다음 값이 지원되지 않습니다.
--os-sku Windows2019--os-sku Windows2022--os-sku Windows2025
대신 사용하려는 해당 --os-sku 노드 풀을 클러스터에 추가해야 합니다.
| 운영 체제 SKU | 기본 OS 버전 |
|---|---|
| Ubuntu | OS SKU Ubuntu가 있는 경우 Kubernetes 버전이 1.25~1.34인 경우 Ubuntu 22.04가 기본 OS 버전입니다. Ubuntu 24.04는 Kubernetes 1.35에서 1.37까지의 Ubuntu에 대한 기본값입니다. |
| AzureLinux | OS SKU AzureLinux 있는 경우 Azure Linux 2.0은 Kubernetes 1.26에서 1.31까지 AzureLinux의 기본값입니다. Azure Linux 3.0은 Kubernetes 1.32에서 1.36까지 AzureLinux의 기본값입니다. |
기존 노드 풀에서 OS SKU를 Ubuntu로 업데이트
OS SKU Ubuntu를 사용하도록 노드 풀을 업데이트할 때 Kubernetes 버전에 따라 기본 OS 버전이 제공됩니다. 노드 풀 업데이트 명령 중에 OS 버전이 변경되면 자동 이미지 다시 설치가 트리거될 수 있습니다.
기존 노드 풀에서 --os-sku Ubuntu로 업데이트하려면 az aks nodepool update 명령을 사용하십시오.
az aks nodepool update \
--resource-group $RESOURCE_GROUP \
--cluster-name $CLUSTER_NAME \
--os-sku Ubuntu \
--name $NODE_POOL_NAME \
--node-count 1
이 az aks nodepool update 명령을 사용하여 지원되는 Linux os-sku간에 마이그레이션할 수 있습니다. 대상 OS에 Kubernetes 버전, VM 크기 또는 FIPS 사용 설정에 대해 지원되는 노드 이미지가 없는 경우 명령이 실패할 수 있습니다.
기존 노드 풀에서 OS SKU를 Azure Linux로 업데이트하세요.
OS SKU AzureLinux를 사용하도록 노드 풀을 업데이트할 때 Kubernetes 버전에 따라 기본 OS 버전이 제공됩니다. 노드 풀 업데이트 명령 중에 OS 버전이 변경되면 자동 이미지 다시 설치가 트리거될 수 있습니다.
기존 노드 풀에서 --os-sku AzureLinux 명령을 사용하여 az aks nodepool update으로 업데이트합니다.
az aks nodepool update \
--resource-group $RESOURCE_GROUP \
--cluster-name $CLUSTER_NAME \
--os-sku AzureLinux \
--name $NODE_POOL_NAME \
--node-count 1
Ubuntu 22.04로 롤백
비고
--os-sku Ubuntu2204로 마이그레이션할 때 다음 정보를 유의하세요.
기존 노드 풀에서 --os-sku Ubuntu2204로 롤백하려면 az aks nodepool update 명령을 사용하세요.
az aks nodepool update \
--resource-group $RESOURCE_GROUP \
--cluster-name $CLUSTER_NAME \
--os-sku Ubuntu2204 \
--kubernetes-version 1.32.0 \
--name $NODE_POOL_NAME \
--node-count 1
다음 단계
AKS의 노드 이미지, 노드 풀 업그레이드 및 노드 구성에 대한 자세한 내용은 다음 리소스를 참조하세요.
- 노드 및 노드 구성에 대해 알아보려면 AKS 핵심 개념을 참조하세요.
- 자동 노드 이미지 업그레이드를 구성하고 계획된 유지 관리를 사용하여 예약합니다.
- 사용자 지정 노드 구성을 적용하여 OS 또는 kubelet 설정을 수정합니다.
- 최신 노드 이미지에 대한 자세한 내용은 AKS 릴리스 정보 참조하세요.
- GitHub Actions 사용하여 클러스터 및 노드 풀 업그레이드를 적용합니다.
- AKS 패치 및 업그레이드 지침을 사용하여 모범 사례를 업그레이드하는 방법에 대해 알아봅니다.