Container > NHN Kubernetes Service(NKS) > 버전 가이드
클러스터 버전 관리
NKS 클러스터는 클러스터 컨트롤 플레인과 워커 노드 그룹별로 Kubernetes 버전과 플랫폼 버전을 관리합니다. 두 버전의 차이는 다음과 같습니다.
Kubernetes 버전
- 업스트림 Kubernetes에서 정의하는 버전입니다.
- NKS 클러스터를 구성하는 Kubernetes 주요 구성 요소의 버전을 결정합니다.
- 주요 구성 요소:
kube-apiserver, kube-controller-manager, kube-scheduler, kubelet, kube-proxy
플랫폼 버전
- NKS 서비스 수준에서 정의하는 버전입니다.
- 클러스터를 구성하는 여러 구성 요소를 하나의 버전으로 정의해 관리합니다.
- 주요 구성 요소:
containerd, etcd 등 컨트롤 플레인 및 워커 노드 주요 구성 요소, 각종 시스템 구성 요소 및 시스템 관리 도구 등
버전 상태에 따른 업그레이드 대상
| Kubernetes 버전의 최신 여부 |
플랫폼 버전의 최신 여부 |
업그레이드 대상 |
| X |
X |
Kubernetes 버전 및 플랫폼 버전 |
| X |
O |
Kubernetes 버전 |
| O |
X |
플랫폼 버전 |
| O |
O |
없음 |
컨트롤 플레인의 버전 정보는 클러스터 조회 화면에서, 워커 노드 그룹의 버전 정보는 각 워커 노드 그룹 조회 화면에서 확인할 수 있습니다.
Kubernetes 버전 지원 정책
클러스터 생성 가능 버전
- NKS에서 릴리스한 Kubernetes 버전 중 최신 3개 버전으로 신규 클러스터를 생성할 수 있습니다.
- 신규 버전이 릴리스되면, 기존 생성 가능 버전 목록 중 가장 낮은 버전은 자동으로 제거됩니다.
- Kubernetes 버전의 패치 버전은 내부 정책에 따라 업데이트될 수 있습니다.
서비스 지원 정책
안정적인 서비스 운영을 위해 Kubernetes 버전별 서비스 지원 정책을 적용합니다.
- NKS는 Kubernetes 버전을 기준으로 서비스 지원 여부가 결정됩니다.
- 서비스 지원 정책의 적용 기준은 NKS의 신규 Kubernetes 버전(
x.y) 릴리스 시점입니다.
- NKS는 최신 Kubernetes 버전을 지속적으로 제공하며, 사용 중인 클러스터는 업그레이드를 통해 최신 상태를 유지할 수 있습니다.
| 서비스 지원 정책 |
적용 기준 |
NKS 기능 동작 보장 |
클러스터 업그레이드 |
| 서비스 지원 |
Kubernetes 버전 릴리스 후 약 14개월 미만 |
보장 |
가능 |
| 서비스 미지원 |
Kubernetes 버전 릴리스 후 약 14개월 이상 |
보장 안 됨 |
단, 서비스 지원 종료 후 10개월간 업그레이드 지원 |
예시: 2025년 11월 릴리스된 v1.33 버전의 수명주기
| 구분 |
기간 |
주요 특징 |
| 서비스 지원 |
2025.11 ~ 2027.01.31 (약 14개월) |
- 모든 기능 정상 동작 및 기술 지원 제공 |
| 서비스 미지원 (업그레이드 지원) |
2027.02.1 ~ 2027.11.30 (약 10개월) |
- 업그레이드를 제외한 기술 지원 불가 |
| 서비스 미지원 (지원 종료 - EOS) |
2027.12.01 이후 |
- 업그레이드를 포함한 기술 지원 불가 - 신규 클러스터 생성 후 마이그레이션 필요 |
운영 팁
- 각 버전은 릴리스 후 최대 약 24개월간 관리됩니다.
- 서비스 미지원 단계에 진입하면 10개월 내 업그레이드를 완료하는 것이 좋습니다.
- 지원 종료(EOS - End of Support) 상태에서는 신규 클러스터 생성 및 워크로드 이전(Self-Migration)이 필요합니다.
Kubernetes 버전별 지원 일정
[안내] 2025년 11월부터 Kubernetes 버전 지원 정책이 변경됩니다.
- v1.32까지는 기존 일정과 정책이 적용됩니다.
- v1.33부터는 신규 정책이 적용됩니다.
- 표의 날짜는 UTC+00:00 기준입니다.
신규 정책 적용 버전 (v1.33 이상)
| 버전 |
릴리스 |
서비스 지원 종료(업그레이드 지원) |
서비스 지원 종료(EOS) |
| v1.33 |
2025.11 |
2027.01.31 |
2027.11.30 |
기존 정책 적용 버전 (v1.32 이하)
| 버전 |
릴리스 |
서비스 지원 종료(업그레이드 지원) |
서비스 지원 종료(EOS) |
| v1.28.3 |
2024.02 |
2025.11.30 |
2025.11.30 |
| v1.29.3 |
2024.05 |
2026.02.28 (예정) |
2026.02.28 (예정) |
| v1.30.3 |
2024.08 |
2026.05.31 (예정) |
2026.05.31 (예정) |
| v1.31.4 |
2025.02 |
2026.08.31 (예정) |
2026.08.31 (예정) |
| v1.32.3 |
2025.05 |
2027.02.28 (예정) |
2027.02.28 (예정) |
플랫폼 버전
플랫폼 버전별 정보
| 버전 |
릴리스 시점 |
Kubernetes 호환 버전 |
설명 |
| 1.202505.0 |
2025.11 |
v1.28–v1.32 |
플랫폼 버전이 적용되지 않은 클러스터를 나타냅니다. |
| 1.202511.0 |
2025.11 |
v1.28–v1.33 |
플랫폼 버전 초기 릴리스 |
| 1.202511.1 |
2025.12 |
v1.28–v1.33 |
헬스 체크 확인 포트 설정 오류 수정 |