# Argo v3.0.21

2026-01-01 · [릴리스 노트 원문](https://github.com/argoproj/argo-cd/releases/tag/v3.0.21) · [전체 정리](https://ratatosk.io/ko/releases/argo/v3.0.21)

중요 수정 5 · 의존성 갱신 1 · 기타 3

## 업그레이드 전 확인

### 업그레이드 안내

- **다른 마이너 버전에서 업그레이드**
  > ## Upgrading
  > If upgrading from a different minor version, be sure to read the [upgrading](https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/overview/) documentation.

## 중요 수정 (5)

### ApplicationSet 조정 시 `AnnotationKeyHydrate` 보존

- 영향 대상: `AnnotationKeyHydrate`를 사용하는 ApplicationSet 생성 Application (추정)

이 어노테이션이 있는 기존 생성 Application에 대해 hydrate가 요청되면, 조정 과정에서 어노테이션을 보존합니다.

> * 8910d47425d352a37604c4d461abb5afbd0b877b: fix(hydrator): appset should preserve annotation when hydration is requested (cherry-pick #25644 for 3.0) (#25652) (@argo-cd-cherry-pick-bot[bot])

### KServe `InferenceService` 중지 조건에 따른 상태 분류 수정

- 영향 대상: KServe `InferenceService` 리소스

status가 `False`인 `Stopped` 조건은 정상 상태로 처리합니다. status가 `True`이면 리소스를 `Suspended`로 보고하고, `InferenceService is Stopped` 메시지를 표시합니다.

> * a9a7868dc4e18cda89c8ccea7746a2eea7621859: fix: Allow the ISVC to be healthy when the Stopped Condition is False (cherry-pick #25312 for 3.0) (#25316) (@argo-cd-cherry-pick-bot[bot])

### Repo 서버의 annotated Git 태그 커밋 해시 해석

- 영향 대상: annotated Git 태그를 대상으로 하는 Application (추정)

> * b53d2a244325ca48a3dc520b4c7453afcc43f413: fix: handle annotated git tags correctly in repo server cache (cherry-pick #21771 for 3.0) (#25241) (@argo-cd-cherry-pick-bot[bot])

### sync-window 상태 표시의 null 안전 처리

- 영향 대상: sync-window 상태 표시 (추정)

애플리케이션 상태 패널과 sync-window 상태 아이콘은 `assignedWindows` 값이 없는 경우도 처리합니다.

> * ad1eacbe93c2e6163ff989702dcddfbe8cd8ab95: fix(ui): add null-safe handling for assignedWindows in status panel (cherry-pick #25128 for 3.0) (#25182) (@argo-cd-cherry-pick-bot[bot])

### `ApplyOutOfSyncOnly` 사용 시 클러스터 범위 리소스 업데이트 수정

- 영향 대상: `ApplyOutOfSyncOnly=true`를 사용하고 클러스터 범위 리소스에 `ignoreDifferences`를 설정한 애플리케이션

이전에는 애플리케이션 컨트롤러가 동기화 중 업데이트하면 안 되는 클러스터 범위 리소스를 업데이트할 수 있었습니다.

> * 38b108e2553c5ec962899040ee8ec2eb1ccd7123: chore(deps): bump gitops-engine to include fix for #24242 (#25548) (@anandf)

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `* 73b21ff4f2fa7f134ffe0c03cc0d9332eb1ef556: chore(deps): bump golang.org/x/crypto from 0.38.0 to 0.46.0 (#25821) (@anandf)`

## 기타 (3)

- 패널 표시 여부에 따른 `ApplicationSelector` 렌더링
- 옵셔널 체이닝 적용에 따른 알림 트리거 예시 업데이트
- Argo CD 추적 어노테이션 표시 시점을 명확히 한 업그레이드 문서

---

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