본문으로 건너뛰기

알림 관리

빌드가 완료되었는지, 배포가 성공했는지 매번 직접 확인하러 가기는 번거롭습니다. KIWI의 알림 시스템을 활용하면 중요한 이벤트가 발생했을 때 바로 알 수 있습니다.

알림을 활용하면 좋은 점
  • 빌드/배포가 끝날 때까지 기다릴 필요가 없습니다.
  • 문제가 발생하면 즉시 알 수 있어 빠르게 대응할 수 있습니다.
  • 보안 취약점이 발견되면 바로 조치할 수 있습니다.

알림 시스템 개요​

KIWI는 화면 우측 상단의 종 모양 아이콘을 통해 알림을 제공합니다.

  • 알림 아이콘: 헤더 우측에 위치한 종 모양 아이콘을 클릭하면 알림 드로어가 열립니다.

  • 읽지 않은 알림 배지: 확인하지 않은 알림이 있으면 아이콘 위에 빨간색 숫자 배지가 표시됩니다.

    • 숫자가 클수록 확인해야 할 알림이 많다는 뜻입니다.

  • 알림 드로어: 아이콘을 클릭하면 화면 우측에서 최근 알림 목록이 슬라이드되어 나타납니다.

알림 유형​

KIWI에서 제공하는 알림의 종류를 알아보겠습니다. 색상으로 중요도를 빠르게 파악할 수 있습니다.

빌드 알림​

빌드 과정에서 발생하는 알림입니다.

  • 빌드 시작: Docker 이미지 빌드가 시작되었습니다. 완료까지 기다리세요.
  • 빌드 성공: 빌드가 완료되었습니다. 배포를 진행할 수 있습니다.
  • 빌드 실패: 빌드 중 오류가 발생했습니다. 로그를 확인하여 원인을 파악하세요.

배포 알림​

배포 과정에서 발생하는 알림입니다.

  • 배포 시작: 선택한 환경으로 배포가 시작되었습니다. 완료까지 기다리세요.
  • 배포 성공: 배포가 완료되었습니다. 서비스가 정상 작동하는지 확인하세요.
  • 배포 실패: 배포 중 오류가 발생했습니다. 설정과 리소스 상태를 확인하세요.
  • 롤백 완료: 이전 버전으로 롤백이 완료되었습니다. 원인을 분석하고 수정 후 재배포하세요.

보안 알림​

보안 스캔 결과에 따른 알림입니다.

  • Critical 취약점: 치명적인 취약점이 발견되었습니다. 즉시 조치가 필요합니다.
  • High 취약점: 높은 위험도의 취약점이 발견되었습니다. 가능한 빨리 조치하세요.
  • 스캔 완료: 보안 스캔이 완료되었습니다. 결과를 확인하세요.
Critical 취약점 알림을 받으면

Critical 취약점은 실제 공격에 사용될 수 있는 심각한 보안 문제입니다. 발견 즉시 해당 서비스의 보안 분석 결과를 확인하고 조치하세요.

시스템 알림​

시스템 전반에 관한 알림입니다.

  • 인시던트 발생: 서비스 장애가 발생했습니다. 즉시 확인이 필요합니다.
  • 인시던트 해결: 장애 복구가 완료되었습니다. 안심하세요, 문제가 해결되었습니다.
  • 시스템 점검: 예정된 점검 안내입니다. 점검 시간을 미리 확인하세요.

알림 확인하기​

알림을 확인하고 대응하는 방법을 단계별로 알아보겠습니다.

Step 1: 알림 드로어 열기​

  1. 화면 우측 상단의 종 아이콘을 찾습니다.
  2. 읽지 않은 알림이 있으면 빨간색 배지로 개수가 표시됩니다.
    • 숫자가 보이면 확인이 필요하다는 신호입니다.
  3. 아이콘을 클릭하면 알림 드로어가 우측에서 슬라이드되어 열립니다.

Step 2: 알림 목록 확인​

알림 목록에서 확인할 수 있는 정보입니다.

  • 제목: 어떤 이벤트인지 요약합니다. 예: "빌드 실패", "Critical 취약점 발견"
  • 내용: 이벤트의 상세 설명입니다. 예: "my-service 빌드 중 오류 발생"
  • 시간: 알림이 발생한 시간입니다. 예: "5분 전", "오늘 오후 2:30"
  • 서비스: 관련된 서비스 이름입니다. 예: "my-service", "api-gateway"

Step 3: 알림에 대응하기​

알림을 확인한 후 취할 수 있는 액션입니다.

  • 상세 이동: 알림을 클릭하면 관련 페이지로 바로 이동합니다.

    • 빌드 실패 알림을 클릭하면 해당 서비스의 빌드 로그 페이지로 이동합니다.

  • 읽음 처리: 알림 우측의 체크 아이콘을 클릭하면 읽음으로 표시됩니다.

    • 확인한 알림은 읽음 처리하여 정리하세요

  • 모두 읽음: 드로어 상단의 "모두 읽음" 버튼으로 모든 알림을 한 번에 읽음 처리합니다.

    • 알림이 많이 쌓였을 때 유용합니다.
효율적인 알림 확인 습관

알림을 확인한 후에는 바로 읽음 처리하세요. 읽지 않은 알림이 쌓이면 정작 중요한 알림을 놓칠 수 있습니다.

알림 관리​

알림을 효과적으로 관리하는 방법을 알아보겠습니다.

읽음 상태 구분하기​

알림은 읽음 여부에 따라 다르게 표시됩니다.

  • 읽지 않음: 굵은 글씨와 강조 배경으로 표시됩니다. 아직 확인하지 않은 알림입니다.
  • 읽음: 일반 글씨와 기본 배경으로 표시됩니다. 이미 확인한 알림입니다.

알림 정리​

알림이 너무 많아지면 관리가 어려워집니다. KIWI는 자동으로 정리해 주지만, 직접 정리할 수도 있습니다.

  • 자동 삭제: 오래된 알림은 일정 기간이 지나면 자동으로 정리됩니다.

    • 중요한 알림은 미리 확인해 두세요

  • 수동 삭제: 필요한 경우 개별 알림을 삭제할 수 있습니다.

    • 더 이상 필요 없는 알림은 삭제하여 깔끔하게 유지하세요

실제 사용 시나리오​

실제로 알림을 받았을 때 어떻게 대응하는지 시나리오별로 알아보겠습니다.

시나리오 1: 빌드 실패 대응​

상황

코드를 푸시한 후 다른 작업을 하고 있었는데, 알림 아이콘에 빨간색 배지가 나타났습니다.

대응 순서:

  1. 알림 아이콘에 빨간색 배지가 표시됩니다.
  2. 아이콘을 클릭하여 알림 드로어를 엽니다.
  3. "빌드 실패: my-service" 알림을 확인합니다.
  4. 알림을 클릭하여 해당 서비스 페이지로 이동합니다.
  5. 빌드 로그에서 에러 원인을 확인합니다.
    • 대부분 컴파일 에러, 의존성 문제, Dockerfile 오류 등입니다.
  6. 코드를 수정한 후 재빌드를 실행합니다.

시나리오 2: 보안 취약점 대응​

상황

보안 스캔이 완료되었는데, "Critical 취약점 발견" 알림이 왔습니다.

대응 순서:

  1. "Critical 취약점 발견" 알림을 클릭합니다.
  2. 보안 분석 결과 페이지로 이동합니다.
  3. 취약점의 상세 정보를 확인합니다.
    • CVE 번호, 영향받는 패키지, 심각도 등
  4. 해당 패키지를 안전한 버전으로 업데이트합니다.
  5. 재스캔을 실행하여 취약점이 해결되었는지 확인합니다.
CVE란?

CVE(Common Vulnerabilities and Exposures)는 알려진 보안 취약점에 부여되는 고유 식별자입니다. CVE 번호로 검색하면 해당 취약점에 대한 자세한 정보와 해결 방법을 찾을 수 있습니다.

시나리오 3: 배포 진행 모니터링​

상황

배포를 시작했는데, 다른 작업을 하면서도 진행 상황을 알고 싶습니다.

모니터링 순서:

  1. 배포를 시작하면 "배포 시작" 알림이 표시됩니다.
  2. 다른 작업을 하면서 기다립니다.
  3. 배포가 완료되면 "배포 성공" 알림이 표시됩니다.
  4. 알림을 클릭하여 서비스 페이지로 이동합니다.
  5. Operate 모달을 열어 Pod/컨테이너가 정상 실행 중인지 확인합니다.
배포 실패 알림이 오면

"배포 실패" 알림이 오면 당황하지 마세요. 로그를 확인하여 원인을 파악하고, 필요하면 이전 버전으로 롤백할 수 있습니다.

알림 우선순위​

모든 알림이 똑같이 중요한 것은 아닙니다. 알림의 우선순위를 이해하면 더 효과적으로 대응할 수 있습니다.

  • Critical: 빌드/배포 실패, Critical 취약점 등입니다. 즉시 조치가 필요합니다.
  • High: High 취약점, 인시던트 등입니다. 가능한 빨리 확인하세요.
  • Normal: 빌드/배포 성공, 스캔 완료 등입니다. 정해진 시간에 확인하면 됩니다.
  • Info: 시스템 정보, 점검 안내 등입니다. 편한 시간에 확인하세요.
우선순위별 대응 전략
  • Critical/High: 다른 작업을 중단하고 바로 확인하세요
  • Normal: 아침, 점심, 퇴근 전 등 정해진 시간에 확인하세요
  • Info: 시간 여유가 있을 때 확인하세요

베스트 프랙티스​

알림을 효과적으로 활용하기 위한 권장 사항입니다.

효율적인 알림 관리​

  • 즉시 확인: Critical이나 High 우선순위의 알림은 즉시 확인하고 대응하세요

    • 이 알림들은 서비스에 직접적인 영향을 줄 수 있습니다.

  • 정기 확인: Normal 알림은 아침, 점심, 퇴근 전 등 정해진 시간에 확인하세요

    • 하루 세 번 정도면 충분합니다.

  • 읽음 처리: 확인하고 처리가 완료된 알림은 바로 읽음 처리하여 관리하세요

    • 읽지 않은 알림이 쌓이면 중요한 알림을 놓칠 수 있습니다.

팀 협업​

팀으로 알림 관리하기

알림은 개인이 아닌 팀 전체가 관리해야 합니다. 누군가 휴가 중이어도 알림이 확인되지 않는 상황이 없어야 합니다.

  • 담당자가 알림을 확인하면 읽음 처리하여 중복 확인을 방지하세요
  • 중요한 알림은 팀 채널(Slack 등)에 공유하여 함께 대응하세요
  • 알림 확인 담당을 로테이션으로 정해두는 것도 좋은 방법입니다.

문제 해결​

알림이 제대로 작동하지 않을 때 확인해 볼 사항입니다.

알림이 오지 않는 경우​

가능한 원인: 브라우저의 알림 권한이 차단되어 있을 수 있습니다.

해결 방법: 브라우저 설정에서 KIWI 사이트의 알림을 허용해 주세요.

  • Chrome: 주소창 왼쪽의 자물쇠 아이콘 클릭 > 사이트 설정 > 알림 허용

알림 배지가 표시되지 않는 경우​

가능한 원인: 브라우저 캐시 문제일 수 있습니다.

해결 방법:

  • 페이지 새로고침 (F5)
  • 강력 새로고침 (Ctrl+Shift+R)

알림 드로어가 열리지 않는 경우​

가능한 원인: 일시적인 UI 문제일 수 있습니다.

해결 방법:

  • 페이지를 새로고침해 주세요
  • 문제가 지속되면 다른 브라우저에서 시도해 보세요
  • 그래도 안 되면 관리자에게 문의하세요

관련 가이드​