# Longhorn v1.12.2

> Storage & Data · 2026-11-09

데이터 손실 위험, 런타임 중단, 마운트 지연과 장치 상태 처리 문제를 다룬 안정성 중심의 유지보수 릴리스입니다. 네트워크와 Helm 차트 개선이 포함되며, 업그레이드 전 조건과 V2 운영 제약, 요청 로그의 비밀 정보 정제 문제도 함께 다뤄집니다.

## 조치 필요
- **[security]** `CSI` 요청 로그의 비밀 정보 정제 누락 수정
  - `CSI` 메서드 수준 요청 로그가 비밀 정보 정제를 우회하던 문제를 수정했습니다.

## 영향 확인
- **[breaking]** `V2 Data Engine` 실시간 업그레이드 제한
  - `v1.12.2`에서 `v1.13.0`으로 `V2 Data Engine`을 실시간 업그레이드하는 경우에 적용됩니다.
  - `v1.12.2`에서 `v1.13.0`으로 `V2 Data Engine`을 실시간 업그레이드하는 방식은 지원되지 않습니다.
- **[breaking]** 레거시 linked-clone 볼륨 작업 제한
  - `v1.12.1` 이상으로 업그레이드하는 경우에 적용됩니다.
  - `legacy linked-clone volumes`는 분리와 삭제 외에는 작업할 수 없습니다.
- **[breaking]** `V2 Data Engine` CPU 코어 최소 기준
  - `V2 Data Engine`에 CPU 코어를 2개보다 적게 설정하는 경우에 적용됩니다.
  - 안정성을 위해 `V2 Data Engine`에 CPU 코어를 2개 이상 설정해야 합니다. 다중 코어 마스크를 사용하면 한 코어가 `admin reactor`에 예약되어 입출력에 쓰이는 코어가 하나 줄어듭니다.
- **[breaking]** Longhorn 설치 전 `Kubernetes` 버전 조건
  - `Kubernetes`가 `v1.25`보다 이른 클러스터에 Longhorn `v1.12.2`를 설치하는 경우에 적용됩니다.
  - 설치 전에 클러스터가 `Kubernetes` `v1.25` 이상을 실행하고 있어야 합니다.

## 그 밖에 기록된 변경
- 74 (defect_corrected 60, value_changed 8, added 4, constraint_changed 2)

[분석 자세히 보기](https://ratatosk.io/ko/releases/longhorn/v1.12.2)

[원본 릴리스 노트](https://github.com/longhorn/longhorn/releases/tag/v1.12.2)