ArgoCD Application 네임스페이스 Watch 범위

Thu, 02 Jul 2026 00:00:00 +0000

작성일: 2026-07-02 | 컴포넌트: argocd-server, argocd-application-controller, argocd-applicationset-controller

1. 핵심 사실

기본 설치 상태에서 ArgoCD는 자신이 설치된 네임스페이스(보통 argocd)에 있는 Application 커스텀 리소스만 list/watch함.
여러 네임스페이스(또는 전체)의 Application을 다루려면 argocd-cmd-params-cm ConfigMap의 application.namespaces 키를 명시적으로 설정해야 함. “Applications in any namespace” 기능 (v2.5+에서 지원).
AppProject는 이 설정과 무관하게 항상 ArgoCD 설치 네임스페이스에만 존재 가능. AppProject에는 네임스페이스 확장 기능 자체가 없음.

2. 설정 확인 방법

kubectl -n argocd get configmap argocd-cmd-params-cm -o jsonpath='{.data.application\.namespaces}'; echo

`data.application.namespaces` 상태	의미
키 없음	기본값 — 설치 네임스페이스만 watch
`"argocd"` (설치 네임스페이스와 동일 값)	명시적 지정, 결과는 기본값과 동일
`"*"`	전체 네임스페이스 watch
`"ns1,ns2"`, `"team-*"` (와일드카드 지원)	지정된 네임스페이스(들)만 watch

주의: ConfigMap 자체의 metadata.namespace: argocd는 이 ConfigMap 리소스가 어디 위치하는지를 나타낼 뿐 watch 범위와 무관함. 반드시 data 블록 안의 application.namespaces 키를 확인해야 함 — 헷갈리기 쉬운 포인트.

Gitops on homelab89

ArgoCD Application 네임스페이스 Watch 범위

1. 핵심 사실

2. 설정 확인 방법