# Volcano v1.12.2

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

호환성 변경 2 · 중요 수정 4 · 기능·개선 1 · 의존성 갱신 1 · 기타 3

## 호환성 변경 (2)

### HyperNode `NodeCount`의 일치하는 고유 Node 집계

- 영향 대상: HyperNode 리소스를 조정하는 설치 환경

이전에는 기존 Node와 일치하지 않는 항목까지 `HyperNode.Spec.Members`의 모든 항목을 집계했습니다. Node 목록 조회에 실패하면 컨트롤러가 오류를 로그에 남기고 0을 보고합니다.

근거: “+ nodes, err := hn.nodeLister.List(labels.Everything())” https://github.com/volcano-sh/volcano/pull/4488

> * Automated cherry pick of #4473: fix node count reconcile by @Monokaix in https://github.com/volcano-sh/volcano/pull/4488

### Hypernode 컨트롤러의 릴리스 이름 키를 `HELM_RELEASE_NAME`으로 변경

- 영향 대상: 릴리스 이름 환경 변수를 사용하는 Hypernode 컨트롤러 구성 (추정)

이전에는 `ReleaseNameEnvKey`가 `RELEASE_NAME`으로 정의되어 있었습니다.

근거: “- ReleaseNameEnvKey = "RELEASE_NAME"” https://github.com/volcano-sh/volcano/pull/4490

> * [cherry-pick for 1.12]Fix incorrect definition of ReleaseNameEnvKey by @ouyangshengjia in https://github.com/volcano-sh/volcano/pull/4490

## 중요 수정 (4)

### `SelectBestNodeAndScore` 및 `SelectBestHyperNode`의 음수 점수 선택 수정

- 영향 대상: 노드 및 하이퍼노드 플러그인 스코어링 (추정)

이제 선택기는 점수가 `-1`보다 낮더라도 사용 가능한 후보 가운데 점수가 가장 높은 후보를 선택할 수 있습니다.

> * [cherry-pick for 1.12]Fix the issue where SelectBestNode returns nil when plugin scores are negative by @guoqinwill in https://github.com/volcano-sh/volcano/pull/4472

### 계층형 큐 capacity 메트릭 갱신

- 영향 대상: 계층형 큐와 큐 메트릭 모니터링을 사용하는 capacity 플러그인 구성 (추정)

capacity 플러그인이 계층형 큐의 어트리뷰트를 생성할 때 capacity 및 real-capacity 메트릭이 누락됐습니다. 이제 처리 과정에서 각 큐의 capability 및 real-capability 리소스를 반영해 해당 메트릭 시계열을 갱신합니다.

> * Automated cherry pick of #4487: Add missing capacity metrics in hierarchical queues by @JesseStutler in https://github.com/volcano-sh/volcano/pull/4494

### `StatefulSet` `PodGroup` 동기화 수정

- 영향 대상: 복제본 수가 0보다 크고 설정된 Volcano 스케줄러로 스케줄링된 일치하는 파드가 있는 StatefulSet (추정)

StatefulSet이 추가되거나 업데이트될 때 파드 템플릿이 변경되면, 컨트롤러가 누락된 `PodGroup`을 생성하거나 기존 `PodGroup`의 spec, 레이블, 어노테이션을 해당 파드와 일치하도록 업데이트합니다.

> * [Cherry-pick] fix: update podGroup when statefulSet update by @Poor12 in https://github.com/volcano-sh/volcano/pull/4522

### Kube-scheduler `Goroutines` 메트릭 초기화 누락으로 인한 패닉 수정

- 영향 대상: `EnableMetrics` 또는 `EnablePprof`를 활성화한 Volcano 스케줄러 구성

kube-scheduler 관련 플러그인을 호출하면 `server.go`에서 `Goroutines` 메트릭을 초기화하지 않아 패닉이 발생할 수 있었습니다. 이제 스케줄러는 메트릭 서버를 시작하기 전에 서버 시작 경로에서 메트릭을 초기화합니다.

> * Automated cherry pick of #4422: Move kube-scheduler related metrics initilization to server.go to avoid panic by @JesseStutler in https://github.com/volcano-sh/volcano/pull/4461

## 기능·개선 (1)

- README 모니터링 설치를 설치 프로그램 매니페스트로 전환

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `* Automated: Bump version to v1.12.2 by @JesseStutler in https://github.com/volcano-sh/volcano/pull/4518`

## 기타 (3)

- 릴리스 워크플로와 빌드 기본값에 버전 설정 적용
- Job 컨트롤러의 `PodGroup` 업데이트 시 깊은 복사
- Volcano Helm 차트 및 개발 이미지 참조를 v1.12.2로 업데이트

---

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