# Argo v3.6.2

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

보안 2 · 중요 수정 7 · 의존성 갱신 2 · 기타 10

## 업그레이드 전 확인

### 업그레이드 안내

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

## 보안 (2)

### Argo CD 정규식 메모리 증폭 문제 수정

- 영향 대상: `spec.sourceNamespaces`에 정규식 패턴이 있는 AppProject
- [CVE-2026-77299](https://www.cve.org/CVERecord?id=CVE-2026-77299), GHSA-wq9v-j77v-qr26

0폭 서브표현식에 큰 고정 횟수 수량자를 적용한 패턴을 매칭하면 메모리가 제한 없이 할당되어 애플리케이션 컨트롤러와 API 서버에서 OOM이 발생할 수 있었습니다. 업데이트된 엔진은 백트래킹에 한도를 설정하므로, 한도를 초과하는 매칭은 일치하지 않는 것으로 처리됩니다.

> * 4650371b518108674d90f686c58e3b864bcfb90f: fix(deps): upgrade dlclark/regexp2 from v1.12.0 to v2.13.0 (CVE-2026-77299) (cherry-pick #31005 for 3.6) (#31039) (@chengfang)

### AppProject 목적지 거부 패턴 우선순위 수정

- 영향 대상: `!name` 또는 `!server` 목적지 거부 패턴을 사용하는 AppProject

이전에는 네임스페이스가 일치하면 서버나 이름의 일치가 다른 식별자에 설정된 거부 패턴보다 우선해 목적지를 허용할 수 있었습니다. 이제 거부 패턴 내부의 glob이 일치하면 허용 규칙을 평가하기 전에 목적지를 차단합니다. 관련 없는 클러스터에 대한 거부 패턴은 그 외 조건에서 허용되는 목적지를 차단하지 않습니다.

> * 4eb468d287f0afb4cfbd6f0e43374eac954599b9: fix: AppProject destination deny (!name / !server) vetoes when it positively matches (cherry-pick #30884 for 3.6) (#30896) (@argo-cd-cherry-pick-bot[bot])

## 중요 수정 (7)

### `ApplicationSet` refresh 업데이트에서 refresh 어노테이션만 변경

- 영향 대상: `ApplicationSet` refresh 요청 및 컨트롤러가 지우는 refresh 어노테이션 (추정)

이전에는 객체 전체를 다시 작성하면서 비어 있는 제너레이터 `template` 블록이 추가되거나 `directory.recurse: false`처럼 명시적으로 설정한 0 값이 사라질 수 있었습니다. 그 결과 Git으로 관리되는 도구가 드리프트를 감지해 객체를 다시 적용할 수 있었습니다.

> * 931f5be6f905516c8e2c9f16c8ac3039c1cefe45: fix(appset): patch only the refresh annotation instead of rewriting the ApplicationSet (#24378, #24647) (cherry-pick #31023 for 3.6) (#31029) (@argo-cd-cherry-pick-bot[bot])

### `ApplicationSet` 파이널라이저 추가에 패치 사용

- 영향 대상: 점진적 동기화가 활성화된 `ApplicationSet` 리소스 (추정)

컨트롤러가 역순 삭제 파이널라이저를 추가할 때, 이전에는 전체 오브젝트를 업데이트해 spec의 동시 변경 사항을 덮어쓸 수 있었습니다. 패치를 사용하면 해당 변경 사항을 다시 쓰지 않습니다.

> * 931f5be6f905516c8e2c9f16c8ac3039c1cefe45: fix(appset): patch only the refresh annotation instead of rewriting the ApplicationSet (#24378, #24647) (cherry-pick #31023 for 3.6) (#31029) (@argo-cd-cherry-pick-bot[bot])

### 이전 동기화 상태가 `Unknown`일 때 오래된 diff 캐시 우회

- 영향 대상: 이전 동기화 상태가 `Unknown`인 애플리케이션

서버 측 diff를 사용하면 드라이런 비교가 실패한 뒤 다음 비교에서 캐시된 플레이스홀더인 “diff 없음” 결과를 재사용해, 새 커밋이 적용되지 않았는데도 `Synced`로 보고할 수 있었습니다. 이제 이전 동기화 상태가 `Unknown`이면 다음 비교에서 diff 캐시를 건너뜁니다.

> * f3e083acd6a58c1058c0317af2d1ec37b4210688: fix(controller): skip the diff cache after an Unknown sync status (#28722) (cherry-pick #30893 for 3.6) (#30898) (@argo-cd-cherry-pick-bot[bot])

### [드러나지 않던 결함] 누락된 컴포넌트를 무시할 때 기존 컴포넌트 모두 렌더링

- 영향 대상: `ignoreMissingComponents`가 활성화되어 있고 구성된 컴포넌트 경로가 여러 개이며, 그중 둘 이상의 컴포넌트가 존재하는 Kustomize 소스

이전에는 kustomization 파일이 있는 첫 번째 컴포넌트만 렌더링되어 뒤에 나열된 컴포넌트의 리소스와 패치가 알림 없이 누락되었습니다. 이제 나열된 컴포넌트 중 존재하는 항목을 모두 렌더링하며, 존재하지 않는 컴포넌트는 계속 무시합니다.

> * 8ec580f0509cdc509d1a5b19f12f78f42d2e0bed: fix(kustomize): add every existing component when ignoreMissingComponents is set (#30909) (cherry-pick #30910 for 3.6) (#30922) (@argo-cd-cherry-pick-bot[bot])

### 컴팩트 트리에서 그룹화된 Pod 아래 리소스 유지

- 영향 대상: Group Nodes를 켠 컴팩트 리소스 트리 뷰

상위 항목이 그룹화된 Pod인 리소스는 트리에 표시되지 않았습니다. 이제 트리에 표시되는 가장 가까운 상위 항목 아래에 나타납니다. Pod 그룹화 방식은 그대로이며, Group Nodes를 끈 경우의 동작도 바뀌지 않았습니다.

> * 0e02a401a010e24d03835456696af63b8a7f4355: fix(ui): show resources owned by grouped pods in compact tree view (#30278) (cherry-pick #30478 for 3.6) (#30879) (@argo-cd-cherry-pick-bot[bot])

### 웹 터미널 컨테이너 전환 문제 수정

- 영향 대상: 컨테이너가 두 개 이상인 파드의 웹 터미널

v3.6.0부터 다른 컨테이너로 전환하면 웹 터미널에 “Terminal Connection Error”가 표시되고 연결이 끊겼습니다. 전환 후에는 새 컨테이너의 터미널 세션이 연결된 상태로 유지되고, 이전 세션은 별도 알림 없이 종료됩니다.

> * c14134fbcf5f20e3aecf00f5ad3ca59bbb81be81: fix(ui): keep the terminal connected when switching container in a pod (#30881) (cherry-pick #30882 for 3.6) (#30912) (@argo-cd-cherry-pick-bot[bot])

### 애플리케이션 컨트롤러의 디코딩된 OpenAPI 문서 메모리 해제

- 영향 대상: 캐시된 OpenAPI 스키마가 있는 클러스터를 관리하는 애플리케이션 컨트롤러

관리 대상 클러스터가 캐시에 있는 동안 컨트롤러는 Argo CD가 읽지 않는 디코딩된 OpenAPI v2 문서를 계속 보유했습니다. 이제 파싱된 리소스와 GVK 파서는 계속 사용하면서 해당 문서를 가비지 컬렉션할 수 있습니다. 인용된 테스트에서는 클러스터당 유지되는 힙 메모리가 24.1 MB에서 8.7 MB로 줄었습니다.

> * c62adfbc0857de42ff4f0583195475289a51bd54: fix(gitops-engine): stop retaining the decoded OpenAPI document per cluster (#30810) (cherry-pick #30811 for 3.6) (#30830) (@argo-cd-cherry-pick-bot[bot])

## 의존성 갱신 (2)

그 외 2건 · 보안 언급 없음

- `* ed3d8e24555e70756c9bca84239c2207afa078c0: chore(deps): update dependency helm/helm to v4.3.2 (release-3.6) (#30986) (@argoproj-renovate[bot])`
- `* 7e4c259f4eddfd310bd432606dcac21f80ca2cd0: chore(deps): update group golang to v1.27.4 (release-3.6) (#30915) (@argoproj-renovate[bot])`

## 기타 (10)

- 변경 사항이 없는 리비전의 서버 사이드 diff 캐시 유지
- 멀티 소스 패널 기본 확장
- 좁은 창에서 상단 바의 브레드크럼과 제목 겹침 방지
- 알림 템플릿 리소스 상태 동작 문서화
- `argocd-cm` 참조 문서의 `globalProjects` 설정 상속 설명
- `argocd-cmd-params-cm` 참조 문서의 기존 설정 키 15개 설명 추가
- 사이드카가 받은 파일을 확인하는 CMP 문서
- kubectl sync 문서의 operation sync 옵션 안내 명확화
- Argo CD 설치 매니페스트와 `gitops-engine/v3`를 v3.6.2로 업데이트
- 캐시된 압축 매니페스트의 초과 용량 축소

---

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