# Argo v3.1.12

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

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

## 업그레이드 전 확인

### 업그레이드 안내

- **마이너 버전 간 업그레이드 문서**
  > 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.

## 호환성 변경 (1)

### 헬스 체크 실패 로그 수정

- 영향 대상: `ServeHealthCheck`가 제공하는 헬스 체크. 여기에는 repo-server의 `/healthz?full=true` 라이브니스 체크가 포함됩니다

repo-server의 `/healthz?full=true` 라이브니스 체크가 실패하면, 로그에 유용한 헬스 체크 오류 대신 HTTP response writer의 표현이 포함되어 내용이 잘못되고 혼란스러웠습니다. 이제 실패 로그에 유용한 오류 메시지와 구조화된 `duration`, `component`, `error` 필드가 기록됩니다.

근거: “This PR fixes the error message and, additionally, it adds the "duration" field to the message that prints duration of the failed healthcheck: this can be useful for troubleshooting healthcheck failures.” https://github.com/argoproj/argo-cd/pull/26039

> * 1b7cfc0c0682118b04058419976d90152723a6d0: fix: invalid error message on health check failure (#26040) (cherry pick #26039 for 3.1) (#26071) (@dudinea)

## 중요 수정 (1)

### 하이드레이션된 애플리케이션의 소스별 새로고침 경로

- 영향 대상: `argocd.argoproj.io/manifest-generate-paths` 어노테이션을 사용하고 소스 하이드레이션을 활성화한 애플리케이션

이전에는 헬퍼가 앱 수준 경로를 각 소스에 동일하게 적용했습니다. 그 결과 하이드레이션된 애플리케이션에서 상대 어노테이션 경로가 `drySource`가 아닌 `syncSource`를 기준으로 계산되어 새로고침을 트리거하지 못할 수 있었습니다. 이제 `drySource`를 기준으로 하는 어노테이션 경로는 하이드레이션 새로고침을 트리거하고, `drySource`의 웹훅 변경은 하이드레이션을 트리거합니다. `syncSource` 변경은 하이드레이션 없이 새로고침합니다.

> * 28b618775d16e1259448b13414c5f789c1990afd: fix: cherry pick #25516 to release-3.1 (#26116) (@FourFifthsCode)

## 기타 (1)

- 필수 데이터가 있을 때만 표시되는 Hydrator 리비전 행

---

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