ClearOps

Spring Boot 마이크로서비스를 위한 공통 운영 기능 라이브러리

설정만으로 즉시 사용 가능한 운영 라이브러리.
Java 25, Spring Boot 4.0 기반의 최신 기술 스택.

Java 25

최신 버전 지원

Java 17 ~ 25

Spring Boot 4.0

프레임워크

최신 기술 스택

100%

설정 기반

코드 수정 없이 즉시 사용

핵심 가치

설정만으로 완성되는 공통 운영 기능

모듈형 아키텍처

필요한 라이브러리만 선택하여 사용할 수 있습니다. 각 라이브러리는 독립적으로 동작하며, Spring Boot Auto-Configuration으로 즉시 사용 가능합니다.

AOP

감사 로깅

AspectJ 기반 선언적 로깅, 민감 정보 자동 마스킹

JWT

인증/권한

Spring Security 통합, 역할 기반 접근 제어

Multi

다채널 알림

Email, Slack 등 확장 가능한 알림 시스템

주요 구조와 장점

각 라이브러리의 아키텍처와 핵심 장점

ClearOps-Core

공통 운영 기능 라이브러리

주요 구조

  • • AOP 기반 감사 로깅 - AspectJ를 활용한 선언적 로깅
  • • Repository 패턴 - 로그 저장소 추상화
  • • Strategy 패턴 - 다채널 알림 전송
  • • Auto-Configuration - Spring Boot 자동 설정

핵심 장점

  • • 민감 정보 자동 마스킹으로 보안 강화
  • • 설정만으로 즉시 사용 가능
  • • 확장 가능한 인터페이스 설계
  • • MDC 기반 로그 추적

Clear-Ops-Authorization

JWT 기반 인증 및 권한 관리

주요 구조

  • • 레이어드 아키텍처 - Domain/Application/Infrastructure
  • • JWT Provider - 토큰 생성 및 검증
  • • Security Filter Chain - Spring Security 통합
  • • JPA 영속성 - 사용자 및 권한 관리

핵심 장점

  • • BCrypt 기반 안전한 비밀번호 암호화
  • • Spring Security와 완벽 통합
  • • 역할 기반 접근 제어 (RBAC)
  • • Swagger UI를 통한 API 문서화

ClearOps Notification

다채널 알림 전송 시스템

주요 구조

  • • 플러그인 아키텍처 - 채널 독립적 설계
  • • NotificationSender 인터페이스 - 제네릭 타입 안전성
  • • Discovery 패턴 - supports() 메서드로 런타임 선택
  • • Spring Mail 통합 - 이메일 기본 구현

핵심 장점

  • • 새로운 채널 추가 용이 (SMS, Push 등)
  • • 컴파일 타임 타입 검증
  • • HTML 이메일 지원
  • • 다중 수신자 일괄 전송

ClearOps Notification-Slack

Slack 알림 확장 모듈

주요 구조

  • • NotificationSender 확장 - 공통 인터페이스 구현
  • • Slack Web API - chat.postMessage 엔드포인트
  • • Bot Token 인증 - OAuth 기반 보안
  • • Property 기반 설정 - application.yml 통합

핵심 장점

  • • 최소한의 설정으로 즉시 사용
  • • 기존 Notification 시스템과 통합
  • • 채널별 메시지 라우팅
  • • 실시간 팀 협업 알림

ClearOps Log Rolling Policy - MinIO

MinIO 기반 로그 롤링 및 자동 업로드

주요 구조

  • • Logback 확장 - RollingFileAppender 커스터마이징
  • • ObjectStorageRollingPolicy - 롤오버 이벤트 가로채기
  • • MinIO Async Client - 비동기 파일 업로드
  • • 시간/크기 기반 롤링 - SizeAndTimeBasedRollingPolicy

핵심 장점

  • • 자동 업로드로 디스크 공간 절약
  • • 애플리케이션 성능 영향 최소화
  • • 중앙 집중식 로그 관리
  • • 기존 Logback 설정과 호환

ClearOps-Log-Amqp

RabbitMQ 기반 실시간 로그 전송

주요 구조

  • • Logback Appender - 실시간 로그 캡처
  • • Spring AMQP - RabbitMQ 메시지 전송
  • • MessageQueuePublisher - 로그 메시지 변환 및 전송
  • • Exchange/Routing Key - 유연한 메시지 라우팅

핵심 장점

  • • 실시간 로그 스트리밍
  • • JSON 구조화로 검색 및 분석 용이
  • • 감사 로그 자동 통합
  • • 중앙 로그 수집 시스템 구축

라이브러리

6개의 독립적인 모듈로 구성된 운영 라이브러리 세트

ClearOps-Core

0.0.16-SNAPSHOT

Spring Boot 애플리케이션을 위한 공통 운영 기능 라이브러리

  • REST API 요청/응답 자동 감사 로깅
  • 민감 정보 자동 마스킹
  • 로그 롤오버 및 외부 저장소 연동
문서 보기 →

Clear-Ops-Authorization

0.0.2-SNAPSHOT

JWT 기반 인증 및 권한 관리 라이브러리

  • JWT 토큰 생성 및 검증
  • 사용자 계정 관리
  • 역할 기반 권한 관리
문서 보기 →

ClearOps Notification

0.0.1-SNAPSHOT

다양한 채널을 통한 알림 전송 기능 제공

  • 채널 독립적 설계
  • Spring Mail 기반 이메일 전송
  • 확장 가능한 아키텍처
문서 보기 →

ClearOps Notification - Slack

0.0.1-SNAPSHOT

Slack 채널 알림 전송 확장 모듈

  • Slack Web API 통합
  • Bot Token 기반 인증
  • 채널별 메시지 전송
문서 보기 →

ClearOps Log Rolling Policy - MinIO

0.1.1-SNAPSHOT

MinIO 기반 로그 롤링 및 자동 업로드

  • 자동 로그 업로드
  • 원본 파일 자동 삭제
  • 비동기 처리
문서 보기 →

ClearOps-Log-Amqp

0.0.4-SNAPSHOT

RabbitMQ 기반 실시간 로그 전송

  • Logback Appender 기반 로그 전송
  • RabbitMQ 메시지 큐 연동
  • JSON 구조화 로그 메시지
문서 보기 →

기술 스택

최신 기술로 구성된 안정적인 라이브러리

☕
Java
17 - 25
🍃
Spring Boot
4.0.0
🔒
Spring Security
6.x
🗄️
JPA
Hibernate