애플리케이션 알림

애플리케이션 알림 (Application Notice)

Argo CD는 애플리케이션 세부 정보 페이지에 컨텍스트 배너로, 애플리케이션 목록과 타일 보기에는 호버 아이콘으로 애플리케이션별 알림을 표시할 수 있습니다. 이는 단일 Application에 국한된 폐기 경고, 예정된 유지보수, 운영 지침을 관련 없는 앱에 영향을 주지 않고 표시하는 데 유용합니다. 알림은 Application 리소스의 어노테이션으로만 구성되며, Argo CD 재시작이나 ConfigMap 변경이 필요하지 않습니다.

출처: 문서

본문

애플리케이션 알림

Argo CD는 애플리케이션 세부 정보 페이지에 컨텍스트 배너로, 애플리케이션 목록과 타일 보기에는 호버 아이콘으로 애플리케이션별 알림을 표시할 수 있습니다. 이는 관련 없는 앱에 영향을 주지 않으면서 단일 Application에 국한된 폐기 경고, 예정된 유지보수, 운영 지침을 표시하는 데 유용합니다.

알림은 Application 리소스의 어노테이션으로 완전히 구성됩니다 — Argo CD 재시작이나 ConfigMap 변경이 필요하지 않습니다.

참고: argocd-cm의 ui.bannercontent로 구성된 인스턴스 수준 배너는 변경되지 않으며 모든 UI 페이지에 계속 적용됩니다. 여기서 설명하는 앱별 알림은 독립적이며 세부 정보 페이지 콘텐츠 위에 쌓입니다.

어노테이션

모든 알림 어노테이션은 notice.argocd.argoproj.io/ 접두사를 사용합니다.

심각도 기본값

허용 목록 아이콘

icon 어노테이션으로 설정할 수 있는 FontAwesome 클래스 조각은 다음과 같습니다:

fa-info-circle, fa-exclamation-triangle, fa-exclamation-circle, fa-bell, fa-wrench, fa-clock, fa-bullhorn, fa-life-ring, fa-shield-alt.

예시

최소 알림 — info 심각도, 닫기 가능, 배너 + 아이콘:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: guestbook
  namespace: argocd
  annotations:
    notice.argocd.argoproj.io/content: "Scheduled DB maintenance on 2026-06-01 02:00 UTC"
spec:
  # ...

런북 링크가 있는 폐기 알림, 영구(permanent)로 표시:

metadata:
  annotations:
    notice.argocd.argoproj.io/content:   "Deprecated — migrate to v2 by 2026-08-01"
    notice.argocd.argoproj.io/severity:  "warning"
    notice.argocd.argoproj.io/url:       "https://wiki.example.com/v2-migration"
    notice.argocd.argoproj.io/permanent: "true"

목록 아이콘 전용 힌트(페이지 배너 없음):

metadata:
  annotations:
    notice.argocd.argoproj.io/content:  "Owned by team-payments"
    notice.argocd.argoproj.io/severity: "info"
    notice.argocd.argoproj.io/scope:    "icon"
    notice.argocd.argoproj.io/icon:     "fa-life-ring"

표시되는 위치

• 배너는 애플리케이션 세부 정보 페이지의 헬스 및 동기화 상태 패널과 애플리케이션의 리소스 트리 사이에 표시됩니다.
• 아이콘은 애플리케이션 페이지의 타일 및 목록 보기 모두에서 애플리케이션 이름 옆에 표시됩니다. 호버하면 알림 내용이 드러납니다.
• 기본적으로 배너는 현재 사용자가 닫을 수 있습니다. notice.argocd.argoproj.io/permanent를 "true"로 설정하면 닫기 컨트롤이 제거되어 배너가 계속 표시됩니다. 목록/타일 아이콘은 알림이 존재하는 동안 항상 표시됩니다.

더 알아보기 (Learn more)

• 어노테이션과 라벨
• 사용자 가이드 개요