# Longhorn v1.13.0

> Storage & Data · 2026-09-29

V2 Data Engine, 스케줄링, 스냅샷, 메트릭, 운영 기능을 넓히고 볼륨, 백업, 네트워킹, 복원력, 안정성 관련 문제를 폭넓게 수정한 릴리스입니다. 업그레이드 전 사전 조건을 확인해야 하며, 기존 기본값을 바꾸지 않는 선택적 복원력 및 CPU 관리 개선과 보안 수정이 포함되어 있습니다.

## 조치 필요
- **[security]** CSI 요청 로그의 비밀값 정제 우회 수정
  - `CSI` 메서드 수준 요청 로그가 비밀값 정제를 우회하던 보안 문제가 수정되었습니다. 관련 이슈는 `13613`입니다.

## 영향 확인
- **[breaking]** Kubernetes 최소 버전 변경
  - Longhorn `v1.13.0`을 설치하거나 업그레이드할 때 적용됩니다.
  - `CSI external-provisioner`가 `v6.3.0`으로 업그레이드되므로, 모든 클러스터가 Kubernetes `v1.34` 이상을 실행해야 합니다.
- **[breaking]** 이전 V2 연결 복제 볼륨의 작업 제한
  - Longhorn `v1.12.0` 이하에서 생성된 `V2 linked-clone volumes`를 사용하는 경우에 적용됩니다.
  - `v1.12.0` 이하에서 생성된 `V2 linked-clone volumes`는 `v1.12.1`부터 분리하거나 삭제하는 작업만 지원합니다.
- **[breaking]** V2 실시간 업그레이드 경로 제한
  - 적용 대상이 릴리스 노트에 명시되지 않았습니다.
  - `V2 live upgrade`는 Longhorn `v1.12.2`에서만 `v1.13.0`으로 직접 지원됩니다. `v1.12.0` 또는 `v1.12.1`에서 업그레이드하거나 사전 조건을 충족하지 못한 경우에는 업그레이드 전에 모든 V2 볼륨을 분리하고 해당 복제본을 중지해야 합니다.
- **[breaking]** `longhorn-global-manager Deployment`의 기본 복제본 수 변경
  - 적용 대상이 릴리스 노트에 명시되지 않았습니다.
  - 설치와 업그레이드 과정에서 `longhorn-global-manager Deployment`가 기본적으로 복제본 세 개로 생성됩니다. 업그레이드 전에 해당 파드 중 하나 이상을 스케줄링할 수 있어야 합니다.
- **[breaking]** 인스턴스 관리자 gRPC 서비스의 mTLS 적용 범위 확대
  - `longhorn-grpc-tls` 시크릿을 설정한 경우에 적용됩니다.
  - `longhorn-grpc-tls` 시크릿이 설정되면 모든 `instance manager gRPC services`에 mTLS가 적용됩니다. 따라서 모든 gRPC 포트에서 유효한 클라이언트 인증서를 요구합니다.

## 그 밖에 기록된 변경
- 118 (defect_corrected 78, added 28, value_changed 9, constraint_changed 2, default_changed 1)

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

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