# Volcano v1.13.1

2025-12-23 · [릴리스 노트 원문](https://github.com/volcano-sh/volcano/releases/tag/v1.13.1) · [전체 정리](https://ratatosk.io/ko/releases/volcano/v1.13.1)

호환성 변경 1 · 중요 수정 6 · 기타 7

## 호환성 변경 (1)

### 리소스 차원 중 하나라도 충분할 때 Capacity 플러그인의 리클레임

- 영향 대상: 다차원 리소스 요청을 사용하는 Capacity 플러그인 설정 (추정)

테스트한 사례에서는 다른 큐의 파드 `ns1/p18`이 축출되고, 새 선점 결정이 반영되도록 큐 초과 사용 메트릭이 업데이트됩니다.

근거: “case5: Can reclaim from other queues when allocated + req <= deserved on one dimension” https://github.com/volcano-sh/volcano/pull/4830

> * [release-1.13] fix: capacity plugin's preemptivefn logic by @hajnalmt in https://github.com/volcano-sh/volcano/pull/4830

## 중요 수정 (6)

### ReplicaSet 업데이트 시 관련 PodGroup 정보 동기화

- 영향 대상: PodGroup과 연결된 ReplicaSet

이전에는 동기화가 필요한 경우 Deployment 또는 ReplicaSet 정보를 업데이트해도 관련 PodGroup 필드가 오래된 값으로 남을 수 있었습니다. 예를 들어, `scheduling.volcano.sh/group-min-member`를 `"2"`로 변경하면 이제 PodGroup의 `minMember`가 2로 업데이트됩니다.

> * Cherry-pick PR #4786 to release-1.13: Fix replicaSet podgroup update synchronization by @jiahuat in https://github.com/volcano-sh/volcano/pull/4799

### Capacity 플러그인의 큐 복제 패닉 수정

- 영향 대상: Capacity 플러그인이 처리하는 큐 리소스

부모 큐와 자식 큐의 리소스 사양이 일치하지 않으면 `realCapability`가 nil인 상태로 남아 `queueAttr.Clone()`에서 패닉이 발생할 수 있었습니다. `realCapability`를 초기화해 nil 포인터 패닉을 방지합니다.

> * [Cherry-pick 1.13] fix: Initialize realCapability field in newQueueAttr by @dafu-wu in https://github.com/volcano-sh/volcano/pull/4694

### 스케줄러 PreBind 잠금으로 인한 차단 및 타임아웃 수정

- 영향 대상: 등록된 `PreBinder`가 있는 스케줄러 구성 (추정)

PreBind 잠금이 해제되지 않으면 스케줄링 메인 루프가 차단되어 타임아웃이 발생할 수 있었습니다. 이제 PreBind 실행 및 바인딩 경로에서는 레지스트리 잠금을 보유하지 않은 채 등록된 `PreBinder`의 스냅샷을 사용합니다.

> * [cherry-pick 1.13]Scheduling main loop blocked and timeout due to un-released PreBind lock in Volcano by @guoqinwill in https://github.com/volcano-sh/volcano/pull/4700

### 초기화되지 않은 메트릭으로 인한 스케줄러 nil 포인터 패닉 수정

- 영향 대상: `--enable-metrics=true` 없이 시작한 스케줄러 설치 환경

프레임워크 플러그인이 초기화되지 않은 `k8smetrics.Goroutines`에 접근하면 nil 포인터 패닉이 발생할 수 있었습니다. 이제 메트릭 내보내기 활성화 여부와 관계없이 해당 메트릭을 초기화합니다.

> * [release-1.13] Fix scheduler panic when metrics are disabled by @Copilot in https://github.com/volcano-sh/volcano/pull/4770

### 어노테이션이 있는 ReplicaSet 파드의 PodGroup 생성 건너뜀

- 영향 대상: 값이 비어 있지 않은 `scheduling.KubeGroupNameAnnotationKey` 어노테이션이 있는 ReplicaSet 파드

이 파드에 대해서는 핸들러가 반환하며, PodGroup을 생성하거나 업데이트하는 단계로 진행하지 않습니다.

> * [release-1.13] fix: replicaset KubeGroupNameAnnotation handling by @hajnalmt in https://github.com/volcano-sh/volcano/pull/4826

### Volcano PodGroup 파싱 시 오래된 태스크 멤버 항목 제거

- 영향 대상: `Spec.MinTaskMember`를 사용하는 PodGroup (추정)

PodGroup의 태스크 멤버가 바뀌면 제거된 항목이 파싱된 맵에 남아 스케줄링 중 태스크 유효성 검사가 실패할 수 있었습니다. 이제 맵에는 현재 항목만 반영되며, 항목이 모두 없어져 맵이 비는 경우에도 이를 반영합니다.

> * [release-1.13] Fix: Changes to task members in a PodGroup caused task validity checks to fail during scheduling by @ouyangshengjia in https://github.com/volcano-sh/volcano/pull/4852

## 기타 (7)

- Ray 종단 간 테스트 기본 이미지 업데이트: `rayproject/ray:2.49.0`
- 모든 노드에서 미사용 이미지를 정리하는 Ray 플러그인 E2E 테스트
- PodGroup 컨트롤러 워커 시작 루프 변경
- 종료된 태스크의 노드 캐시 제거 누락
- 삭제 중 null `jobID`를 오류로 처리하지 않고 로그에 기록
- 스케줄러 작업 상세 정보와 캐시 진단 문구 업데이트
- E2E 워크플로에 디스크 공간 정리 추가

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
