Argo CD가 사용하는 어노테이션과 라벨
Argo CD가 사용하는 어노테이션과 라벨 (Annotations and Labels)
Argo CD는 애플리케이션과 리소스의 동작을 제어하고 추적하기 위해 다양한 어노테이션과 라벨을 사용합니다. 이 문서는 Argo CD가 사용하는 어노테이션 키와 라벨 키를 표로 정리합니다.
출처: 문서
본문
Argo CD가 사용하는 어노테이션과 라벨
어노테이션(Annotations)
| 어노테이션 키 | 대상 리소스 | 가능한 값 | 설명 |
|---|---|---|---|
| argocd.argoproj.io/application-set-refresh | ApplicationSet | "true" | 웹훅에 의해 ApplicationSet이 새로고침되도록 요청되었을 때 추가됩니다. ApplicationSet 컨트롤러는 조정(reconciliation)이 끝나면 이 어노테이션을 제거합니다. |
| argocd.argoproj.io/compare-options | any | compare options 문서 참조 | 앱의 현재 상태가 원하는 상태와 어떻게 비교되는지 구성합니다. |
| argocd.argoproj.io/hook | any | hooks 문서 참조 | 리소스 훅을 구성하는 데 사용됩니다. |
| argocd.argoproj.io/hook-delete-policy | any | sync waves 문서 참조 | 리소스 훅의 삭제 정책을 설정하는 데 사용됩니다. |
| argocd.argoproj.io/manifest-generate-paths | Application | scaling 문서 참조 | 특히 모노레포에서 불필요한 Application 새로고침을 피하는 데 사용됩니다. |
| argocd.argoproj.io/managed-by-url | Application | 유효한 http(s) URL | 애플리케이션을 관리하는 Argo CD 인스턴스의 URL을 지정합니다. 다른 Argo CD 인스턴스가 관리하는 애플리케이션에 올바르게 연결하는 데 사용됩니다. 자세한 내용은 managed-by-url 문서 참조. |
| argocd.argoproj.io/refresh | Application | normal, hard | 앱을 새로고침해야 함을 나타냅니다. 앱이 새로고침된 후 애플리케이션 컨트롤러가 제거합니다. 값 "hard"는 새로고침 전에 매니페스트 캐시와 대상 클러스터 상태 캐시를 무효화해야 함을 의미합니다. |
| argocd.argoproj.io/skip-reconcile | Application, Cluster Secret | "true" | Application에서 해당 앱의 조정을 건너뜁니다. 클러스터 시크릿에서 해당 클러스터를 대상으로 하는 모든 앱의 조정을 건너뜁니다. skip reconcile 문서 참조. |
| argocd.argoproj.io/sync-options | any | sync options 문서 참조 | Application의 리소스가 어떻게 동기화되는지 결정하는 다양한 설정을 제공합니다. |
| argocd.argoproj.io/sync-wave | any | sync waves 문서 참조 | |
| argocd.argoproj.io/tracking-id | any | any | Argo CD가 관리하는 리소스를 추적하는 데 사용됩니다. 자세한 내용은 resource tracking 문서 참조. |
| argocd.argoproj.io/ignore-default-links | any | "true", false | 이 리소스에서 ArgoCD UI에 자동 생성 링크를 추가하지 않습니다. 자세한 내용은 external URL 문서 참조. |
| argocd.argoproj.io/ignore-resource-updates | any | "true", false | Argo CD가 리소스 업데이트를 무시하는 데 사용됩니다. 자세한 내용은 reconcile 문서(reconcile_docs) 참조. |
| link.argocd.argoproj.io/{some link name} | any | http(s) URL | 리소스에 대해 Argo CD UI에 링크를 추가합니다. 자세한 내용은 external URL 문서 참조. |
| notice.argocd.argoproj.io/content | Application | 일반 텍스트(500자에서 잘림) | 세부 정보 페이지의 앱별 알림 배너와 애플리케이션 목록/타일의 아이콘을 활성화합니다. application notice 문서 참조. |
| notice.argocd.argoproj.io/severity | Application | info, warning, critical (기본값 info) | 알림의 사전 정의된 배너/아이콘 스타일을 선택합니다. |
| notice.argocd.argoproj.io/url | Application | http(s) URL | 설정하면 알림 배너 텍스트와 아이콘이 이 URL로 연결됩니다. |
| notice.argocd.argoproj.io/permanent | Application | "true", "false" (기본값 false) | true일 때 알림 배너를 사용자가 닫을 수 없습니다. |
| notice.argocd.argoproj.io/icon | Application | 허용 목록에 있는 FontAwesome 클래스(예: fa-bell) | 심각도에서 파생된 기본 아이콘을 재정의합니다. 알 수 없는 값은 심각도 기본값으로 돌아갑니다. |
| notice.argocd.argoproj.io/scope | Application | banner, icon, both (기본값 both) | 알림이 표시되는 곳을 제한합니다: 세부 페이지 배너만, 목록/타일 아이콘만, 또는 둘 다. |
| pref.argocd.argoproj.io/default-pod-sort | Application | UI customization 문서 참조 | Application의 기본 그룹화 메커니즘을 설정합니다. |
| pref.argocd.argoproj.io/default-view | Application | UI customization 문서 참조 | Application의 기본 보기 모드(예: "tree" 또는 "list")를 설정합니다. |
라벨(Labels)
| 라벨 키 | 대상 리소스 | 가능한 값 | 설명 |
|---|---|---|---|
| argocd.argoproj.io/instance | Application | any | app.kubernetes.io/instance를 사용하는 다른 도구와의 충돌을 피하기 위한 권장 추적 라벨. |
| argocd.argoproj.io/secret-type | Secret | cluster, repository, repo-creds, scm-creds | Argo CD가 사용하는 특정 유형의 Secrets를 식별합니다. 처음 세 가지에 대한 자세한 내용은 Declarative Setup 문서, 마지막 하나는 AppSet-in-any-namespace 문서 참조. |