[Camel in Action] 실전편 – Camel 마이그레이션 가이드 2.x에서 4.x까지

Table of Contents

Camel 버전별 주요 변경사항 요약

Apache Camel은 활발하게 발전하고 있습니다. 2.x에서 3.x, 4.x로의 마이그레이션은 상당한 변경이 있지만 자동화 도구가 많은 작업을 해결해 줍니다.

Camel 2.x → 3.x 주요 변경

Java 8 기준선: 람다와 스트림 API 적극 활용
모듈화: 하나의 거대한 JAR에서 컴포넌트별 개별 모듈로 분리
Spring Boot 2.x 지원: 자동 설정 대폭 개선
Reactive Camel: reactive streams 지원 추가
제거된 컴포넌트: 사용률 낮은 컴포넌트 정리 (일부는 camel-extra로 이동)

// Camel 2.x
CamelContext context = new DefaultCamelContext();
context.addRoutes(new RouteBuilder() { ... });
context.start();

// Camel 3.x - Spring Boot 자동 설정 활용
@SpringBootApplication
public class App {} // CamelContext 자동 생성됨

Camel 3.x → 4.x 주요 변경

Java 17 기준선: Record, sealed class, text block 활용
jakarta.* 패키지: javax.* → jakarta.* (가장 큰 변화)
Spring Boot 3.x 지원
camel-main 개선: standalone 실행 강화
성능 개선: 내부 데이터 구조 최적화

자동화 마이그레이션 도구 – OpenRewrite

# pom.xml에 OpenRewrite 플러그인 추가
<plugin>
  <groupId>org.openrewrite.maven</groupId>
  <artifactId>rewrite-maven-plugin</artifactId>
  <version>5.x.x</version>
  <configuration>
    <activeRecipes>
      <recipe>org.apache.camel.upgrade.camel40.CamelMigrationRecipe</recipe>
    </activeRecipes>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>org.apache.camel</groupId>
      <artifactId>camel-upgrade-recipes</artifactId>
      <version>LATEST</version>
    </dependency>
  </dependencies>
</plugin>

# 실행
mvn rewrite:run

마이그레이션 단계별 전략

테스트 커버리지 확보: 마이그레이션 전 라우트 테스트를 최대한 작성
의존성 업데이트: BOM을 사용해 일괄 업데이트
컴파일 오류 수정: 제거된 API와 변경된 시그니처 수정
테스트 실행: 모든 camel-test 기반 테스트 통과 확인
통합 테스트: 실제 외부 시스템과 연동 확인
성능 비교: 마이그레이션 전후 처리량 측정

점진적 마이그레이션 전략

큰 시스템은 한 번에 마이그레이션하기 어렵습니다. 라우트 단위로 점진적으로 이전하는 전략을 사용합니다.

// 새 버전 Camel을 별도 모듈에서 실행
// 트래픽을 점진적으로 새 버전으로 이전
from("activemq:queue:orders")
  .choice()
    .when(header("X-Camel-Version").isEqualTo("4"))
      .to("http4://camel4-service/process") // 새 버전으로
    .otherwise()
      .to("bean:legacyCamelService")         // 기존 버전으로
  .end();

zerg96