Spring Boot에서 Fuse 시작하기
Red Hat Fuse on Spring Boot를 사용하여 빠르게 시작
초록
머리말
Fuse를 시작하려면 Spring Boot 컨테이너용 파일을 다운로드하여 설치해야 합니다. 여기에서는 첫 번째 Fuse 애플리케이션을 설치, 개발 및 빌드하는 방법을 안내합니다.
보다 포괄적 수용을 위한 오픈 소스 용어 교체
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.
1장. Fuse on Spring Boot 시작하기
Spring Boot에서 Fuse 애플리케이션을 개발하려면 Spring Boot에서 실행되는 Fuse 샘플 부스터 프로젝트를 생성하고 빌드하여 시작하십시오. 다음 주제에서는 세부 정보를 제공합니다.
1.1. Fuse on Spring Boot 정보
Spring Boot 는 잘 알려진 Spring 컨테이너의 진화입니다. Spring Boot 컨테이너의 고유한 품질은 컨테이너 기능이 작은 청크로 분할되어 독립적으로 배포할 수 있다는 것입니다. 이 품질을 사용하면 특정 종류의 서비스에 특수화된 작은 풋프린트가 있는 컨테이너를 배포할 수 있으며, 이 기능은 마이크로 서비스 아키텍처 의 패러다임에 맞게 정확히 필요한 것입니다.
이 컨테이너 기술의 특징은 다음과 같습니다.
- 확장 가능한 클라우드 플랫폼(Kubernetes 및 OpenShift)에서 실행하는 데 특히 적합합니다.
- 작은 풋프린트(마이크로 서비스 아키텍처의 경우)입니다.
- 구성에 대한 규칙에 최적화되어 있습니다.
- 애플리케이션 서버가 필요하지 않습니다. JVM에서 직접 Spring Boot 애플리케이션 Jar를 실행할 수 있습니다.
1.2. 부스터 프로젝트 생성
개발자가 독립 실행형 애플리케이션을 실행할 수 있도록 Fuse booster 프로젝트가 있습니다. 여기에 제공된 지침은 부스터 프로젝트 인 회로 차단기 부스터 중 하나를 생성하는 방법을 안내합니다. 이 실습에서는 Spring Boot에서 Fuse의 유용한 구성 요소를 보여줍니다.
넷플릭스/Hystrix 회로 차단기를 사용하면 분산 애플리케이션이 네트워크 연결 및 백엔드 서비스의 임시 사용할 수 없는 중단을 처리할 수 있습니다. 회로 차단기 패턴의 기본 개념은 종속 서비스의 손실이 자동으로 감지되고 백엔드 서비스를 일시적으로 사용할 수 없는 경우 대체 동작이 프로그램될 수 있다는 것입니다.
Fuse 회로 차단기 부스터는 두 가지 관련 서비스로 구성됩니다.
-
이름서비스인 백엔드 서비스는 이름을 Cryostat로 반환합니다. -
인사말서비스인 frontend 서비스는name서비스를 호출하여 이름을 가져온 다음 문자열Hello, NAME을 반환합니다.
이 부스터 데모에서 Hystrix 회로 차단기는 인사말 서비스와 이름 서비스 사이에 삽입됩니다. 백엔드 이름 서비스를 사용할 수 없게 되면 인사말 서비스가 대체 동작으로 대체되고, 이름 서비스가 재시작될 때까지 기다리는 동안 차단되는 대신 즉시 클라이언트에 응답할 수 있습니다.
사전 요구 사항
- {NameDevelopersPlatform} 에 액세스할 수 있어야 합니다.
- 지원되는 JDK(Java Developer Kit) 버전이 있어야 합니다. 자세한 내용은 지원되는 구성 페이지를 참조하십시오.
- Maven 설정에 설명된 대로 Apache Maven 3.3.x 이상을 설치하고 구성해야 합니다. https://access.redhat.com/documentation/en-us/red_hat_fuse/7.11/html-single/getting_started_with_fuse_on_spring_boot#set-up-maven-locally
절차
- https://developers.redhat.com/launch 로 이동합니다.
START 를 클릭합니다.
시작 관리자 마법사에서 Red Hat 계정에 로그인하라는 메시지가 표시됩니다.
- 로그인 또는 등록 버튼을 클릭한 다음 로그인합니다.
- 시작 관리자 페이지에서 예제 애플리케이션 배포 버튼을 클릭합니다.
- Create Example Application 페이지에서 Create Example Application에 name, fuse-circuit-breaker 를 입력합니다.
- Select an Example 을 클릭합니다.
예제 대화 상자에서 회로 차단기 옵션을 선택합니다. 런타임 선택 드롭다운 메뉴가 표시됩니다.
- Select a Runtime 드롭다운에서 Fuse 를 선택합니다.
-
버전 드롭다운 메뉴에서 7.11(Red Hat Fuse) 을 선택합니다(
2.21.2(Community)버전을 선택하지 마십시오. - 저장을 클릭합니다.
- 예제 애플리케이션 생성 페이지에서 다운로드를 클릭합니다.
-
애플리케이션 준비 상태 대화 상자가 표시되면
Download.zip을 클릭합니다. 브라우저에서 생성된 booster 프로젝트를 다운로드합니다( ZIP 파일로 패키징됨). - 아카이브 유틸리티를 사용하여 생성된 프로젝트를 로컬 파일 시스템의 편리한 위치로 추출합니다.
1.3. 부스터 프로젝트 빌드
이 지침에서는 Spring Boot에서 Fuse on Spring Boot를 사용하여 회로 차단기를 빌드하는 방법을 안내합니다.
사전 요구 사항
- Red Hat 개발자 포털 을 통해 booster 프로젝트를 생성하고 다운로드해야 합니다.
- 지원되는 JDK(Java Developer Kit) 버전이 있어야 합니다. 자세한 내용은 지원되는 구성 페이지를 참조하십시오.
- Maven 설정에 설명된 대로 Apache Maven 3.3.x 이상을 설치하고 구성해야 합니다. https://access.redhat.com/documentation/en-us/red_hat_fuse/7.11/html-single/getting_started_with_fuse_on_spring_boot#set-up-maven-locally
절차
쉘 프롬프트를 열고 Maven을 사용하여 명령줄에서 프로젝트를 빌드합니다.
cd fuse-circuit-breaker
mvn clean package
Maven이 프로젝트를 빌드하면 Build Success (빌드 성공) 메시지가 표시됩니다.
다음과 같이 새 쉘 프롬프트를 열고 name 서비스를 시작합니다.
cd name-service
mvn spring-boot:run -DskipTests -Dspring-boot.run.arguments="--server.port=8081"
Spring Boot가 시작되면 다음과 유사한 출력이 표시됩니다.
... 2019-05-06 20:19:59.401 INFO 9553 --- [ main] o.a.camel.spring.SpringCamelContext : Route: route1 started and consuming from: servlet:/name?httpMethodRestrict=GET 2019-05-06 20:19:59.402 INFO 9553 --- [ main] o.a.camel.spring.SpringCamelContext : Total 1 routes, of which 1 are started 2019-05-06 20:19:59.403 INFO 9553 --- [ main] o.a.camel.spring.SpringCamelContext : Apache Camel 2.21.0.fuse-730078-redhat-00001 (CamelContext: camel-1) started in 0.287 seconds 2019-05-06 20:19:59.406 INFO 9553 --- [ main] o.a.c.c.s.CamelHttpTransportServlet : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=] 2019-05-06 20:19:59.473 INFO 9553 --- [ main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8081 (http) 2019-05-06 20:19:59.479 INFO 9553 --- [ main] com.redhat.fuse.boosters.cb.Application : Started Application in 5.485 seconds (JVM running for 9.841)
다음과 같이 새 쉘 프롬프트를 열고 인사말 서비스를 시작합니다.
cd greetings-service
mvn spring-boot:run -DskipTests
Spring Boot가 시작되면 다음과 유사한 출력이 표시됩니다.
... 2019-05-06 20:22:19.051 INFO 9729 --- [ main] o.a.c.c.s.CamelHttpTransportServlet : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=] 2019-05-06 20:22:19.115 INFO 9729 --- [ main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8080 (http) 2019-05-06 20:22:19.123 INFO 9729 --- [ main] com.redhat.fuse.boosters.cb.Application : Started Application in 7.68 seconds (JVM running for 12.66)
인사말 서비스는
http://localhost:8080/camel/greetingsURL에 REST 끝점을 노출합니다.웹 브라우저에서 URL을 열거나 다른 쉘 프롬프트를 열고 다음
curl명령을 입력하여 REST 끝점을 호출합니다.curl http://localhost:8080/camel/greetings
응답은 다음과 같습니다.
{"greetings":"Hello, Jacopo"}Camel Hystrix에서 제공하는 회로 차단기 기능을 설명하기 위해 이름 서비스가 실행 중인 쉘 프롬프트 창에서 Ctrl-C 를 입력하여 백엔드 이름 서비스를 종료합니다.
이제 이름 서비스를 사용할 수 없으므로 회로 차단기가 시작되어 인사말 서비스가 호출될 때 중단되지 않도록 합니다.
웹 브라우저에서
http://localhost:8080/camel/greetings를 열거나 다른 쉘 프롬프트 창에 다음curl명령을 입력하여 인사말 REST 끝점을 호출합니다.curl http://localhost:8080/camel/greetings
응답은 다음과 같습니다.
{"greetings":"Hello, default fallback"}인사말 서비스가 실행 중인 창에서 로그에 다음과 같은 메시지 시퀀스가 표시됩니다.
2019-05-06 20:24:16.952 INFO 9729 --- [-CamelHystrix-2] route2 : Try to call name Service 2019-05-06 20:24:16.956 INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused) 2019-05-06 20:24:16.956 INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector : Retrying request 2019-05-06 20:24:16.957 INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused) 2019-05-06 20:24:16.957 INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector : Retrying request 2019-05-06 20:24:16.957 INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused) 2019-05-06 20:24:16.957 INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector : Retrying request 2019-05-06 20:24:16.964 INFO 9729 --- [-CamelHystrix-2] route2 : We are falling back!!!!
-
이 예제에 대한 자세한 내용은 http://localhost:8080/ 에서 Circuit Breaker - Red Hat Fuse 페이지를 엽니다.
이 페이지에는 회로 차단기의 상태를 모니터링하는 Hystrix 대시보드에 대한 링크가 포함되어 있습니다.
2장. Maven을 로컬로 설정
일반적인 Fuse 애플리케이션 개발에서는 Maven을 사용하여 프로젝트를 빌드하고 관리합니다.
다음 주제는 Maven을 로컬로 설정하는 방법을 설명합니다.
2.1. Maven 설정 준비
Maven은 Apache의 무료 오픈 소스 빌드 툴입니다. 일반적으로 Maven을 사용하여 Fuse 애플리케이션을 빌드합니다.
절차
- Maven 다운로드 페이지에서 Maven의 최신 버전을 다운로드합니다.
시스템이 인터넷에 연결되어 있는지 확인합니다.
프로젝트를 빌드하는 동안 기본 동작은 Maven이 외부 리포지토리를 검색하고 필요한 아티팩트를 다운로드하는 것입니다. Maven은 인터넷을 통해 액세스할 수 있는 리포지토리를 찾습니다.
Maven이 로컬 네트워크에 있는 리포지토리만 검색하도록 이 동작을 변경할 수 있습니다. 즉 Maven은 오프라인 모드에서 실행할 수 있습니다. 오프라인 모드에서 Maven은 로컬 리포지토리에서 아티팩트를 찾습니다. 2.3절. “로컬 Maven 리포지토리 사용”을 참조하십시오.
2.2. Maven에 Red Hat 리포지토리 추가
Red Hat Maven 리포지토리에 있는 아티팩트에 액세스하려면 해당 리포지토리를 Maven의 settings.xml 파일에 추가해야 합니다. Maven은 사용자의 홈 디렉터리의 .m2 디렉터리에서 settings.xml 파일을 찾습니다. 사용자가 settings.xml 파일이 지정되지 않은 경우 Maven은 M2_HOME/conf/ 에서 시스템 수준 settings.xml 파일을 사용합니다.
settings.xml
사전 요구 사항
Red Hat 리포지토리를 추가할 settings.xml 파일의 위치를 알고 있습니다.
절차
settings.xml 파일에서 다음 예와 같이 Red Hat 리포지토리의 리포지토리 요소를 추가합니다.
<?xml version="1.0"?>
<settings>
<profiles>
<profile>
<id>extra-repos</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<repositories>
<repository>
<id>redhat-ga-repository</id>
<url>https://maven.repository.redhat.com/ga</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
<repository>
<id>redhat-ea-repository</id>
<url>https://maven.repository.redhat.com/earlyaccess/all</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
<repository>
<id>jboss-public</id>
<name>JBoss Public Repository Group</name>
<url>https://repository.jboss.org/nexus/content/groups/public/</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>redhat-ga-repository</id>
<url>https://maven.repository.redhat.com/ga</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>redhat-ea-repository</id>
<url>https://maven.repository.redhat.com/earlyaccess/all</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>jboss-public</id>
<name>JBoss Public Repository Group</name>
<url>https://repository.jboss.org/nexus/content/groups/public</url>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<activeProfiles>
<activeProfile>extra-repos</activeProfile>
</activeProfiles>
</settings>2.3. 로컬 Maven 리포지토리 사용
인터넷 연결 없이 컨테이너를 실행 중이고 오프라인에서 사용할 수 없는 종속성이 있는 애플리케이션을 배포해야 하는 경우 Maven 종속성 플러그인을 사용하여 애플리케이션의 종속 항목을 Maven 오프라인 리포지토리로 다운로드할 수 있습니다. 그런 다음 이 사용자 지정 Maven 오프라인 리포지토리를 인터넷 연결이 없는 시스템에 배포할 수 있습니다.
절차
pom.xml파일이 포함된 프로젝트 디렉터리에서 다음과 같은 명령을 실행하여 Maven 프로젝트의 리포지토리를 다운로드합니다.mvn org.apache.maven.plugins:maven-dependency-plugin:3.1.0:go-offline -Dmaven.repo.local=/tmp/my-project
이 예에서는 프로젝트를 빌드하는 데 필요한 Maven 종속 항목 및 플러그인이
/tmp/my-project디렉터리로 다운로드됩니다.- 이 사용자 지정 Maven 오프라인 리포지토리를 인터넷 연결이 없는 모든 시스템에 내부적으로 배포합니다.
2.4. 환경 변수 또는 시스템 속성을 사용하여 Maven 미러 설정
애플리케이션을 실행하는 경우 Red Hat Maven 리포지토리에 있는 아티팩트에 액세스해야 합니다. 이러한 리포지토리는 Maven의 settings.xml 파일에 추가됩니다. Maven은 다음 위치에서 settings.xml 파일을 확인합니다.
- 지정된 URL을 찾습니다.
-
if not found looks for
${user.home}/.m2/settings.xml -
if not found looks for
${maven.home}/conf/settings.xml -
찾을 수 없는 경우
${M2_HOME}/conf/settings.xml -
위치를 찾을 수 없는 경우 비어 있는
org.apache.maven.settings.Settings인스턴스가 생성됩니다.
2.4.1. Maven 미러 정보
Maven은 원격 리포지토리 세트를 사용하여 현재 로컬 리포지토리에서 사용할 수 없는 아티팩트에 액세스합니다. 리포지토리 목록에는 거의 항상 Maven Central 리포지토리가 포함되어 있지만 Red Hat Fuse의 경우 Maven Red Hat 리포지토리도 포함되어 있습니다. 불가능하거나 다른 원격 리포지토리에 액세스할 수 없는 경우 Maven 미러 메커니즘을 사용할 수 있습니다. 미러는 특정 저장소 URL을 다른 저장소 URL로 대체하므로 원격 아티팩트를 검색할 때 모든 HTTP 트래픽을 단일 URL로 전달할 수 있습니다.
2.4.2. settings.xml에 Maven 미러 추가
Maven 미러를 설정하려면 Maven의 settings.xml:에 다음 섹션을 추가합니다.
<mirror>
<id>all</id>
<mirrorOf>*</mirrorOf>
<url>http://host:port/path</url>
</mirror>
위 섹션이 settings.xml 파일에 없는 경우 미러가 사용되지 않습니다. XML 구성을 제공하지 않고 글로벌 미러를 지정하려면 시스템 속성 또는 환경 변수를 사용할 수 있습니다.
2.4.3. 환경 변수 또는 시스템 속성을 사용하여 Maven 미러 설정
환경 변수 또는 시스템 속성을 사용하여 Maven 미러를 설정하려면 다음을 추가할 수 있습니다.
-
MAVEN_MIRROR_URL 이라는 환경 변수
bin/setenv파일 -
mavenMirrorUrl 이라는 시스템 속성
etc/system.properties파일
2.4.4. Maven 옵션을 사용하여 Maven 미러 URL 지정
환경 변수 또는 시스템 속성에 지정된 대체 Maven 미러 URL을 사용하려면 애플리케이션을 실행할 때 다음 maven 옵션을 사용합니다.
-DmavenMirrorUrl=mirrorId::mirrorUrlfor example,
-DmavenMirrorUrl=my-mirror::http://mirror.net/repository-DmavenMirrorUrl=mirrorUrlfor example,
-DmavenMirrorUrl=http://mirror.net/repository. 이 예에서 <mirror>의 <id>는 단지 미러일 뿐입니다.
2.5. Maven 아티팩트 및 좌표 정보
Maven 빌드 시스템에서 기본 빌딩 블록은 아티팩트 입니다. 빌드 후 아티팩트의 출력은 일반적으로 JAR 또는 WAR 파일과 같은 아카이브입니다.
Maven의 핵심 측면은 아티팩트를 찾고 해당 아티팩트 간의 종속성을 관리하는 기능입니다. Maven 좌표는 특정 아티팩트의 위치를 식별하는 값 집합입니다. 기본 조정에는 다음과 같은 세 가지 값이 있습니다.
groupId:artifactId:version
Maven은 패키지 값으로 기본 조정을 늘리거나 패키징 값과 분류자 값을 모두 사용하는 경우가 있습니다. Maven 조정에는 다음 양식 중 하나가 있을 수 있습니다.
groupId:artifactId:version groupId:artifactId:packaging:version groupId:artifactId:packaging:classifier:version
값에 대한 설명은 다음과 같습니다.
- groupdId
-
아티팩트 이름의 범위를 정의합니다. 일반적으로 패키지 이름의 전체 또는 일부를 그룹 ID로 사용합니다. 예:
org.fusesource.example. - artifactId
- 그룹 ID를 기준으로 아티팩트 이름을 정의합니다.
- 버전
-
아티팩트의 버전을 지정합니다. 버전 번호는 최대 4개의 부분(
n.n.n.n.n)을 가질 수 있습니다. 여기서 버전 번호의 마지막 부분은 숫자가 아닌 문자를 포함할 수 있습니다. 예를 들어1.0-SNAPSHOT의 마지막 부분은 영숫자 하위 문자열인0-SNAPSHOT입니다. - 패키지
-
프로젝트를 빌드할 때 생성되는 패키지 엔터티를 정의합니다. OSGi 프로젝트의 경우 패키지는
번들입니다. 기본값은 Cryostat입니다. - 분류자
- 동일한 POM에서 빌드되었지만 콘텐츠가 다른 아티팩트를 구분할 수 있습니다.
아티팩트의 POM 파일의 요소는 다음과 같이 아티팩트의 그룹 ID, 아티팩트 ID, 패키징 및 버전을 정의합니다.
<project ... > ... <groupId>org.fusesource.example</groupId> <artifactId>bundle-demo</artifactId> <packaging>bundle</packaging> <version>1.0-SNAPSHOT</version> ... </project>
이전 아티팩트에 대한 종속성을 정의하려면 POM 파일에 다음 종속성 요소를 추가합니다.
<project ... >
...
<dependencies>
<dependency>
<groupId>org.fusesource.example</groupId>
<artifactId>bundle-demo</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
</dependencies>
...
</project>
번 들은 특정 종류의 JAR 파일일 뿐이고, Cryostat는 기본 Maven 패키지 유형이므로 이전 종속성에서 번들 패키지 유형을 지정할 필요가 없습니다. 종속성에서 명시적으로 패키징 유형을 지정해야 하는 경우 type 요소를 사용할 수 있습니다.