Spring Boot에 배포

독립 실행형 배포 모드에서 Spring Boot 애플리케이션은 Jar 파일로 패키지되고 JVM(Java Virtual Machine) 내에서 직접 실행됩니다. 즉, Spring Boot 애플리케이션은 -jar 옵션으로 java 명령을 사용하여 직접 실행할 수 있습니다. 예를 들면 다음과 같습니다.

java -jar SpringBootApplication.jar

여기서 Spring Boot는 실행 가능한 Jar의 기본 클래스를 제공합니다.

애플리케이션 패키징 및 실행에 대한 이러한 접근 방식은 서비스가 최소 요구 사항 세트로 패키지되는 마이크로 서비스 철학과 일치합니다. 컨테이너도 최소화되며 JVM 자체도 마찬가지입니다.

Fuse에서 Spring Boot 독립 실행형 애플리케이션을 빌드하는 데 필요한 요소는 다음과 같습니다.

부스터 데모를 빌드하고 실행하려면 다음 사전 요구 사항을 설치합니다.

개발자가 독립 실행형 애플리케이션을 실행할 수 있도록 Fuse booster 프로젝트가 있습니다. 여기에 제공된 지침은 부스터 프로젝트 인 회로 차단기 부스터 중 하나를 생성하는 방법을 안내합니다. 이 실습에서는 Spring Boot에서 Fuse의 유용한 구성 요소를 보여줍니다.

넷플릭스/Hystrix 회로 차단기를 사용하면 분산 애플리케이션이 네트워크 연결 및 백엔드 서비스의 임시 사용할 수 없는 중단을 처리할 수 있습니다. 회로 차단기 패턴의 기본 개념은 종속 서비스의 손실이 자동으로 감지되고 백엔드 서비스를 일시적으로 사용할 수 없는 경우 대체 동작이 프로그램될 수 있다는 것입니다.

Fuse 회로 차단기 부스터는 두 가지 관련 서비스로 구성됩니다.

이 부스터 데모에서 Hystrix 회로 차단기는 인사말 서비스와 이름 서비스 사이에 삽입됩니다. 백엔드 이름 서비스를 사용할 수 없게 되면 인사말 서비스가 대체 동작으로 대체되고, 이름 서비스가 재시작될 때까지 기다리는 동안 차단되는 대신 즉시 클라이언트에 응답할 수 있습니다.

Fuse는 Spring Boot 애플리케이션의 초기 Maven 프로젝트를 생성하는 데 사용할 수 있는 Maven archetypes를 기반으로 다양한 빠른 시작을 제공합니다. 다양한 Maven archetypes의 위치 정보와 버전을 기억할 필요가 없도록 Fuse는 독립 실행형 Spring Boot 프로젝트에 대한 Maven 프로젝트를 생성하는 데 도움이 되는 툴링을 제공합니다.

첫 번째 Spring Boot 프로젝트를 생성하고 빌드한 후 곧 더 많은 구성 요소를 추가하려고 합니다. 그러나 프로젝트에 추가할 Maven 종속 항목의 버전을 어떻게 알 수 있습니까? 가장 간단한(및 권장) 접근 방식은 관련 BOM(Bod of material) 파일을 사용하는 것입니다. 이 파일은 모든 버전 종속 항목을 자동으로 정의하는 것입니다.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project ...>
  ...
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <!-- configure the versions you want to use here -->
    <fuse.version>7.5.0.fuse-sb2-750029-redhat-00003</fuse.version>
  </properties>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.jboss.redhat-fuse</groupId>
        <artifactId>fuse-springboot-bom</artifactId>
        <version>${fuse.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  ...
</project>

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project ...>
  ...
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <!-- configure the versions you want to use here -->
    <fuse.version>7.5.0.fuse-750029-redhat-00002</fuse.version>
  </properties>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.jboss.redhat-fuse</groupId>
        <artifactId>fuse-springboot-bom</artifactId>
        <version>${fuse.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  ...
</project>

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-hystrix-starter</artifactId>
</dependency>

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project ...>
  ...
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <!-- configure the versions you want to use here -->
    <fuse.version>7.5.0.fuse-750029-redhat-00002</fuse.version>

  </properties>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.jboss.redhat-fuse</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>${fuse.version}</version>
        <executions>
          <execution>
            <goals>
              <goal>repackage</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  ...
</project>

Camel Spring Boot 구성 요소는 Apache Camel에 대한 자동 구성을 제공합니다. Camel 컨텍스트의 자동 구성에서는 Spring 컨텍스트에서 사용할 수 있는 Camel 경로를 자동으로 감지하고 생산자 템플릿, 소비자 템플릿 및 유형 변환기와 같은 주요 Camel 유틸리티를 빈으로 등록합니다.

모든 Camel Spring Boot 애플리케이션은 제품화된 버전으로 dependencyManagement 를 사용해야 합니다. 빠른 시작 시를 참조하십시오. 나중에 태그된 버전은 BOM의 버전을 덮어쓰지 않도록 생략할 수 있습니다.

<dependencyManagement>
	<dependencies>
		<dependency>
			<groupId>org.jboss.redhat-fuse</groupId>
			<artifactId>fuse-springboot-bom</artifactId>
			<version>${fuse.version}</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
	</dependencies>
</dependencyManagement>

Apache Camel에는 시작자를 사용하여 Spring Boot 애플리케이션을 개발할 수 있는 Spring Boot Starter 모듈이 포함되어 있습니다.

시작자를 사용하려면 Spring Boot pom.xml 파일에 다음 스니펫을 추가합니다.

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-spring-boot-starter</artifactId>
</dependency>

시작자를 사용하면 아래 코드 조각에 표시된 것처럼 Camel 경로가 포함된 클래스를 추가할 수 있습니다. 이러한 경로가 클래스 경로에 추가되면 경로가 자동으로 시작됩니다.

package com.example;

import org.apache.camel.builder.RouteBuilder;
import org.springframework.stereotype.Component;

@Component
public class MyRoute extends RouteBuilder {

    @Override
    public void configure() throws Exception {
        from("timer:foo").to("log:bar");
    }
}

application.properties 또는 application.yml 파일에서 Camel 애플리케이션을 사용자 지정할 수 있습니다.

Camel Spring Boot는 이제 Camel 시작 구성 요소 중 하나를 구성할 때 구성 파일(application.properties 또는 yaml 파일)에서 id 이름으로 8080을 참조할 수 있습니다. src/main/resources/application.properties (또는 yaml) 파일에서 빈 ID 이름을 참조하여 다른 빈을 참조하는 Camel에서 옵션을 쉽게 구성할 수 있습니다. 예를 들어 xslt 구성 요소는 다음과 같이 8080 ID를 사용하여 사용자 지정 빈을 참조할 수 있습니다.

다음과 같이 ID myExtensionFactory에 의해 사용자 지정 8080을 참조하십시오.

camel.component.xslt.saxon-extension-functions=myExtensionFactory

Spring Boot @Bean 주석을 사용하여 다음과 같이 생성할 수 있는 것은 다음과 같습니다.

@Bean(name = "myExtensionFactory")
public ExtensionFunctionDefinition myExtensionFactory() {
    }

또는 camel-jackson 데이터 형식의 jackson ObjectMapper의 경우:

camel.dataformat.json-jackson.object-mapper=myJacksonMapper

Camel 자동 구성에서는 CamelContext 인스턴스를 제공하고 SpringCamelContext 를 생성합니다. 또한 해당 컨텍스트의 종료를 초기화하고 수행합니다. 이 Camel 컨텍스트는 camelContext 8080 이름 아래에 Spring 애플리케이션 컨텍스트에 등록되며 다른 Spring 8080과 마찬가지로 액세스할 수 있습니다.

예를 들어 다음과 같이 camelContext 에 액세스할 수 있습니다.

@Configuration
public class MyAppConfig {

  @Autowired
  CamelContext camelContext;

  @Bean
  MyService myService() {
    return new DefaultMyService(camelContext);
  }

}

Camel 자동 구성은 Spring 컨텍스트에서 모든 RouteBuilder 인스턴스를 수집하고 CamelContext 에 자동으로 삽입합니다. Spring Boot 시작기를 사용하여 새 Camel 경로를 생성하는 프로세스를 단순화합니다. 클래스 경로에 @Component 주석이 달린 클래스를 추가하여 경로를 생성할 수 있습니다.

@Component
public class MyRouter extends RouteBuilder {

  @Override
  public void configure() throws Exception {
    from("jms:invoices").to("file:/invoices");
  }

}

@Configuration 클래스에 새 경로 RouteBuilder 8080을 생성하려면 아래를 참조하십시오.

@Configuration
public class MyRouterConfiguration {

  @Bean
  RoutesBuilder myRouter() {
    return new RouteBuilder() {

      @Override
      public void configure() throws Exception {
        from("jms:invoices").to("file:/invoices");
      }

    };
  }

}

Spring Boot 자동 구성은 속성 자리 표시자, OS 환경 변수 또는 Camel 속성을 지원하는 시스템 속성과 같은 Spring Boot 외부 구성에 자동으로 연결됩니다.

이러한 속성은 application.properties 파일에 정의되어 있습니다.

route.from = jms:invoices

시스템 속성으로 사용

java -Droute.to=jms:processed.invoices -jar mySpringApp.jar

Camel 경로에서 자리 표시자로 사용합니다.

@Component
public class MyRouter extends RouteBuilder {

  @Override
  public void configure() throws Exception {
    from("{{route.from}}").to("{{route.to}}");
  }

}

Camel 자동 구성으로 생성한 CamelContext 8080에서 작업을 수행하려면 다음과 같이 Spring 컨텍스트에서 CamelContextConfiguration 인스턴스를 등록해야 합니다.

@Configuration
public class MyAppConfig {

  ...

  @Bean
  CamelContextConfiguration contextConfiguration() {
    return new CamelContextConfiguration() {
      @Override
      void beforeApplicationStart(CamelContext context) {
        // your custom configuration goes here
      }
    };
  }

}

auto-configured CamelContext use camel.springboot.jmxEnabled 속성을 비활성화하려면 기본적으로 활성화되어 있습니다.

예를 들어 application.properties 파일에 다음 속성을 추가할 수 있습니다.

camel.springboot.jmxEnabled = false

Camel 자동 구성은 사전 구성된 ConsumerTemplate 및 ProducerTemplate 인스턴스를 제공합니다. 이를 Spring 관리 빈에 삽입할 수 있습니다.

@Component
public class InvoiceProcessor {

  @Autowired
  private ProducerTemplate producerTemplate;

  @Autowired
  private ConsumerTemplate consumerTemplate;
  public void processNextInvoice() {
    Invoice invoice = consumerTemplate.receiveBody("jms:invoices", Invoice.class);
    ...
    producerTemplate.sendBody("netty-http:http://invoicing.com/received/" + invoice.id());
  }

}

기본적으로 소비자 템플릿 및 생산자 템플릿에는 엔드포인트 캐시 크기가 1000으로 설정되어 있습니다. 다음 Spring 속성을 사용하여 해당 값을 변경할 수 있습니다.

camel.springboot.consumerTemplateCacheSize = 100
camel.springboot.producerTemplateCacheSize = 200

Camel 자동 구성에서는 Spring 컨텍스트에서 typeConverter 라는 TypeConverter 인스턴스를 등록합니다.

@Component
public class InvoiceProcessor {

  @Autowired
  private TypeConverter typeConverter;

  public long parseInvoiceValue(Invoice invoice) {
    String invoiceValue = invoice.grossValue();
    return typeConverter.convertTo(Long.class, invoiceValue);
  }

}

Spring은 유형 변환 API 로 구성됩니다. Spring API는 Camel 유형 변환기 API 와 유사합니다. 두 API Camel Spring Boot 간의 유사점으로 인해 Spring 변환 API에 위임하는 브리지 변환기(SpringTypeConverter)가 자동으로 등록됩니다. 즉, 즉시 사용 가능한 Camel은 Camel과 유사한 Spring Cryostat를 처리합니다.

이를 통해 다음과 같이 Camel TypeConverter API를 사용하여 Camel 및 Spring 컨버터에 모두 액세스할 수 있습니다.

@Component
public class InvoiceProcessor {

  @Autowired
  private TypeConverter typeConverter;

  public UUID parseInvoiceId(Invoice invoice) {
    // Using Spring's StringToUUIDConverter
    UUID id = invoice.typeConverter.convertTo(UUID.class, invoice.getId());
  }

}

여기에서 Spring Boot는 애플리케이션 컨텍스트에서 사용할 수 있는 Spring의 ConversionService 인스턴스로 변환을 위임합니다. ConversionService 인스턴스를 사용할 수 없는 경우 Camel Spring Boot 자동 구성으로 ConversionService 인스턴스가 생성됩니다.

TypeConverter 인스턴스 또는 Spring 브리지와 같은 Camel Spring Boot의 유형 변환 기능을 비활성화하려면 다음과 같이 camel.springboot.typeConversion 속성을 false 로 설정합니다.

camel.springboot.typeConversion = false

기본적으로 Camel XML 경로를 classpath에 배치하면 camel-spring-boot 가 자동으로 탐지되고 포함됩니다. Camel 버전 2.17 이상에서 다음과 같이 구성 옵션을 사용하여 디렉터리 이름을 구성하거나 이 기능을 비활성화할 수 있습니다.

// turn off
camel.springboot.xmlRoutes = false
// scan in the com/foo/routes classpath
camel.springboot.xmlRoutes = classpath:com/foo/routes/*.xml

   <routes xmlns="http://camel.apache.org/schema/spring">
        <route id="test">
            <from uri="timer://trigger"/>
            <transform>
                <simple>ref:myBean</simple>
            </transform>
            <to uri="log:out"/>
        </route>
    </routes>

<camelContext>와 함께 Spring XML 파일을 사용하는 경우 Spring XML 파일 및 application.properties 파일에서 Camel을 구성할 수 있습니다. 예를 들어 Camel에 이름을 설정하고 스트림 캐싱을 켜려면 다음을 추가합니다.

camel.springboot.name = MyCamel
camel.springboot.stream-caching-enabled=true

기본적으로 Camel Rest-DSL XML 경로를 클래스 경로의 camel-rest 디렉토리에 배치할 수 있으며, camel-spring-boot 는 자동으로 감지되고 포함됩니다. 다음과 같이 구성 옵션을 사용하여 디렉터리 이름을 구성하거나 이 기능을 비활성화할 수 있습니다.

// turn off
camel.springboot.xmlRests = false
// scan in the com/foo/routes classpath
camel.springboot.xmlRests = classpath:com/foo/rests/*.xml

   <rests xmlns="http://camel.apache.org/schema/spring">
      <rest>
         <post uri="/persons">
            <to uri="direct:postPersons"/>
         </post>
         <get uri="/persons">
            <to uri="direct:getPersons"/>
         </get>
         <get uri="/persons/{personId}">
             <to uri="direct:getPersionId"/>
         </get>
         <put uri="/persons/{personId}">
             <to uri="direct:putPersionId"/>
         </put>
         <delete uri="/persons/{personId}">
             <to uri="direct:deletePersionId"/>
         </delete>
      </rest>
    </rests>

Spring Boot에서 실행되는 Camel의 경우 Spring Boot는 @Component 로 주석이 추가된 Camel 및 모든 경로를 자동으로 포함합니다. Spring 부팅으로 테스트할 때 @ContextConfiguration 대신 @SpringBootTest 를 사용하여 사용할 구성 클래스를 지정합니다.

다른 RouteBuilder 클래스에 Camel 경로가 여러 개인 경우 Camel Spring Boot에 이러한 경로가 모두 포함됩니다. 따라서 하나의 RouteBuilder 클래스에서만 경로를 테스트하려면 다음 패턴을 사용하여 활성화할 RouteBuilders를 포함하거나 제외할 수 있습니다.

다음과 같이 단위 테스트 클래스에서 이러한 패턴을 @SpringBootTest 주석의 속성으로 지정할 수 있습니다.

@RunWith(CamelSpringBootRunner.class)
@SpringBootTest(classes = {MyApplication.class);
   properties = {"camel.springboot.java-routes-include-pattern=**/Foo*"})
public class FooTest {

FooTest 클래스에서 포함 패턴은 **/Foo* 이며, 이는 Cryostat 스타일 패턴을 나타냅니다. 여기에서 패턴은 선행 패키지 이름과 일치하는 이중 별표로 시작됩니다. /foo* 는 클래스 이름이 FooRoute로 시작해야 함을 의미합니다. 다음 maven 명령을 사용하여 테스트를 실행할 수 있습니다.

mvn test -Dtest=FooTest