[Camel in Action] 8-1. 실전 Camel 프로젝트 구조와 Maven 멀티모듈 설계

Camel 프로젝트, 어떻게 구성해야 할까?

작은 프로토타입은 단일 모듈로 충분합니다. 하지만 여러 팀이 협업하고 독립적으로 배포해야 하는 실제 프로젝트에서는 체계적인 구조가 필요합니다. “Camel in Action” 8장에서는 엔터프라이즈급 프로젝트 구성 방법을 설명합니다.

Maven 멀티모듈 프로젝트 구조

기능별로 모듈을 분리하면 각 팀이 독립적으로 작업하고 필요한 모듈만 의존성으로 추가할 수 있습니다.

camel-enterprise/
├── pom.xml (부모 POM)
├── camel-model/          # 도메인 모델, DTO
├── camel-services/       # 비즈니스 서비스 빈
├── camel-routes/         # Camel 라우트 정의
├── camel-test/          # 공통 테스트 유틸리티
└── camel-app/           # 실행 가능한 애플리케이션

부모 POM에서 공통 의존성과 버전을 관리하고, 각 모듈은 필요한 것만 선택합니다.

라우트 분리 전략

단순히 파일 하나에 모든 라우트를 넣으면 관리가 불가능해집니다. 기능별, 팀별로 RouteBuilder를 분리하는 것이 핵심입니다.

// 주문 처리 라우트
public class OrderRoutes extends RouteBuilder {
  @Override
  public void configure() throws Exception {
    from("activemq:queue:orders")
      .routeId("order-processor")
      .to("bean:orderService");
  }
}

// 재고 관리 라우트
public class InventoryRoutes extends RouteBuilder {
  @Override
  public void configure() throws Exception {
    from("kafka:inventory-events")
      .routeId("inventory-updater")
      .to("bean:inventoryService");
  }
}

각 RouteBuilder는 Spring Bean으로 등록하면 CamelContext가 자동으로 감지해 등록합니다.

설정 외부화 – 프로파일별 설정

개발/스테이징/운영 환경마다 다른 설정이 필요합니다. Spring Boot의 프로파일 기능과 Camel의 PropertiesComponent를 조합합니다.

# application-dev.properties
broker.url=tcp://localhost:61616
db.url=jdbc:h2:mem:testdb

# application-prod.properties
broker.url=tcp://mq.production.com:61616
db.url=jdbc:postgresql://db.production.com/enterprise

실행 시 --spring.profiles.active=prod로 프로파일을 선택합니다. 비밀번호 같은 민감한 정보는 환경변수나 Vault 같은 시크릿 매니저를 활용합니다.

모니터링과 관측가능성

운영 환경에서는 라우트 상태를 지속적으로 모니터링해야 합니다. Camel은 JMX, Prometheus, Micrometer 통합을 지원합니다.

// Micrometer로 라우트 메트릭 자동 수집
camelContext.addRoutePolicyFactory(new MicrometerRoutePolicyFactory());

이렇게 하면 Prometheus + Grafana 대시보드에서 각 라우트의 처리량, 오류율, 처리 시간을 실시간으로 확인할 수 있습니다.