JBoss EAP에서 Fuse 시작하기
Red Hat Fuse on EAP를 사용하여 빠르게 시작
초록
머리말 링크 복사링크가 클립보드에 복사되었습니다!
Fuse를 시작하려면 JBoss EAP 컨테이너용 파일을 다운로드하여 설치해야 합니다. 여기에서는 첫 번째 Fuse 애플리케이션을 설치, 개발 및 빌드하는 방법을 안내합니다.
보다 포괄적 수용을 위한 오픈 소스 용어 교체 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.
1장. JBoss EAP에서 Fuse 시작하기 링크 복사링크가 클립보드에 복사되었습니다!
이 장에서는 Fuse on JBoss EAP를 소개하고 JBoss EAP 컨테이너에서 첫 번째 Fuse 애플리케이션을 설치, 개발 및 빌드하는 방법을 설명합니다.
자세한 내용은 다음 항목을 참조하십시오.
1.1. JBoss EAP의 Fuse 정보 링크 복사링크가 클립보드에 복사되었습니다!
Eclipse Foundation 의 Jakarta EE 기술(이전에는 Java EE)을 기반으로 하는 JBoss EAP(Enterprise Application Platform)는 엔터프라이즈 애플리케이션 개발을 위한 사용 사례를 해결하기 위해 원래 생성되었습니다. JBoss EAP는 서비스 및 표준화된 Java API(예: 지속성, 메시징, 보안 등)를 구현하기 위한 잘 정의된 패턴이 특징입니다. 최근 몇 년 동안 이 기술은 보다 경량화되었으며 엔터프라이즈 Java 빈을 위한 종속성 주입 및 단순화된 주석을 위한 CDI가 도입되었습니다.
이 컨테이너 기술의 특징은 다음과 같습니다.
- 독립 실행형 모드에서 실행하는 데 특히 적합합니다.
- 많은 표준 서비스(예: 지속성, 메시징, 보안 등) 사전 구성되어 즉시 제공됩니다.
- 애플리케이션 WAR는 일반적으로 작고 경량(많은 종속성이 컨테이너에 사전 설치됨)입니다.
- 표준화된 이전 호환 Java API.
1.2. JBoss EAP에 Fuse 설치 링크 복사링크가 클립보드에 복사되었습니다!
JBoss EAP의 Fuse 7.10용 표준 설치 패키지는 Red Hat 고객 포털에서 다운로드할 수 있습니다. JBoss EAP 컨테이너의 표준 어셈블리를 설치하고 전체 Fuse 기술 스택을 제공합니다.
사전 요구 사항
- Red Hat 고객 포털에 는 전체 서브스크립션 계정이 있어야 합니다.
- 고객 포털에 로그인해야 합니다.
- JBoss EAP 를 다운로드해야 합니다.
- Fuse on JBoss EAP 를 다운로드해야 합니다.
- CodeReady Studio 설치 관리자를 다운로드해야 합니다.
절차
다음과 같이 쉘 프롬프트에서 JBoss EAP 설치 프로그램을 실행합니다.
java -jar DOWNLOAD_LOCATION/jboss-eap-7.4.0-installer.jar
java -jar DOWNLOAD_LOCATION/jboss-eap-7.4.0-installer.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow 설치하는 동안:
- 이용 약관에 동의합니다.
-
JBoss EAP 런타임으로 선호하는 설치 경로
EAP_INSTALL을 선택합니다. - 관리 사용자를 만들고 나중에 이러한 관리 사용자 자격 증명을 주의 깊게 기록해 두십시오.
- 나머지 화면에서 기본 설정을 허용할 수 있습니다.
-
쉘 프롬프트를 열고 디렉터리를
EAP_INSTALL으로 변경합니다. EAP_INSTALL디렉터리에서 다음과 같이 EAP 설치 프로그램에서 Fuse를 실행합니다.java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.10.0.jar
java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.10.0.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같이 CodeReady Studio 설치 프로그램을 실행합니다.
java -jar DOWNLOAD_LOCATION/codereadystudio-12.21.0.GA-installer-standalone.jar
java -jar DOWNLOAD_LOCATION/codereadystudio-12.21.0.GA-installer-standalone.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow 설치하는 동안:
- 이용 약관에 동의합니다.
- 선호하는 설치 경로를 선택합니다.
- Java 8 JVM을 선택합니다.
-
Select Platforms and Servers 단계에서 Add 를 클릭하고
EAP_INSTALL디렉터리의 위치를 검색하여 JBoss EAP 런타임을 구성합니다. - Select additional features to Install 단계에서 Red Hat Fuse Tooling 을 선택합니다.
- CodeReady Studio가 시작됩니다. 런타임 검색 대화 상자가 표시되면 OK 를 클릭하여 JBoss EAP 런타임을 생성합니다.
(선택 사항) 명령줄에서 Apache Maven을 사용하려면 에 설명된 대로 Maven을 설치하고 구성해야 합니다.
참고CodeReady Studio만 사용하는 경우 CodeReady Studio에 Maven이 사전 설치되어 구성되어 있으므로 Maven을 설치할 필요가 없습니다. 그러나 명령줄에서 Maven을 호출하려면 이 단계를 수행해야 합니다.
1.3. JBoss EAP에서 첫 번째 Fuse 애플리케이션 빌드 링크 복사링크가 클립보드에 복사되었습니다!
이 지침에서는 JBoss EAP에서 첫 번째 Fuse 애플리케이션을 빌드하는 데 도움이 됩니다.
사전 요구 사항
- Red Hat 고객 포털에 는 전체 서브스크립션 계정이 필요합니다.
- 고객 포털에 로그인해야 합니다.
- JBoss EAP에 Fuse 를 다운로드하여 성공적으로 설치해야 합니다.
- CodeReady Studio 설치 프로그램을 다운로드하여 성공적으로 설치해야합니다.
절차
CodeReady Studio에서 다음과 같이 새 프로젝트를 생성합니다.
- File(파일)NewNew Cryostat Integration Project 를 선택합니다.
-
프로젝트 이름 필드에 192.0.2.
-camel을 입력합니다. - 다음을 클릭합니다.
대상 환경 선택 창에서 다음 설정을 선택합니다.
- 배포 플랫폼으로 Standalone 을 선택합니다.
-
EAP에서 런타임 환경으로 Wildfly/Fuse 를 선택하고 런타임 (선택 사항) 드롭다운 메뉴를 사용하여
JBoss EAP 7.x 런타임서버를 대상 런타임으로 선택합니다.
- 대상 런타임을 선택하면 Camel 버전이 자동으로 선택되고 필드가 회색으로 표시됩니다.
- 다음을 클릭합니다.
- Advanced Project Setup 창에서 Spring Cryostat - Spring DSL 템플릿을 선택합니다.
완료를 클릭합니다.
중요CodeReady Studio에서 Fuse 프로젝트를 처음 빌드하는 경우 마법사가 프로젝트 생성을 완료하는 데 몇 분이 걸립니다. 이는 원격 Maven 리포지토리에서 종속성을 다운로드하기 때문입니다. 프로젝트가 백그라운드에서 빌드하는 동안 마법사를 중단하거나 CodeReady Studio를 종료하지 마십시오.
- 연결된 Fuse 통합 화면을 열라는 메시지가 표시되면 예를 클릭합니다.
- CodeReady Studio가 필요한 아티팩트를 다운로드하고 백그라운드에서 프로젝트를 빌드하는 동안 기다립니다.
다음과 같이 서버에 프로젝트를 배포합니다.
-
서버 보기( Fuse Integration 관점의 오른쪽 위 모서리)에서 서버가 아직 시작되지 않은 경우
Red Hat JBoss EAP 7.3 런타임서버를 선택하고 녹색 화살표를 클릭하여 시작합니다. 콘솔 보기에 다음과 같은 메시지가 표시될 때까지 기다립니다.
14:47:07,283 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.3.2.GA (WildFly Core 10.1.11.Final-redhat-00001) started in 3301ms - Started 314 of 576 services (369 services are lazy, passive or on-demand)
14:47:07,283 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.3.2.GA (WildFly Core 10.1.11.Final-redhat-00001) started in 3301ms - Started 314 of 576 services (369 services are lazy, passive or on-demand)Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 서버가 시작된 후 서버 보기로 다시 전환한 후 서버 를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가 및 제거를 선택합니다.
-
추가 및 제거 대화 상자에서 Cryostat
-camel프로젝트를 선택하고 Add > 를 클릭합니다. - 완료를 클릭합니다.
-
서버 보기( Fuse Integration 관점의 오른쪽 위 모서리)에서 서버가 아직 시작되지 않은 경우
다음과 같이 프로젝트가 작동하는지 확인합니다.
-
다음 URL로 이동하여 ExternalIP
-camel프로젝트에서 실행되는 서비스에 액세스합니다. http://localhost:8080/camel-test-spring?name=Kermit -
브라우저 창에
Hello Kermit이 표시되어야 합니다.
-
다음 URL로 이동하여 ExternalIP
다음과 같이 프로젝트 배포를 취소합니다.
-
서버 보기에서
Red Hat JBoss EAP 7.3 런타임 서버를선택합니다. - 서버를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가 및 제거를 선택합니다.
-
추가 및 제거 대화 상자에서 Cryostat
-camel프로젝트를 선택하고 < 제거를 클릭합니다. - 완료를 클릭합니다.
-
서버 보기에서
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 리포지토리의 리포지토리 요소를 추가합니다.
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
mvn org.apache.maven.plugins:maven-dependency-plugin:3.1.0:go-offline -Dmaven.repo.local=/tmp/my-projectCopy to Clipboard Copied! Toggle word wrap Toggle overflow 이 예에서는 프로젝트를 빌드하는 데 필요한 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>
<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
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, 패키징 및 버전을 정의합니다.
이전 아티팩트에 대한 종속성을 정의하려면 POM 파일에 다음 종속성 요소를 추가합니다.
번 들은 특정 종류의 JAR 파일일 뿐이고, Cryostat는 기본 Maven 패키지 유형이므로 이전 종속성에서 번들 패키지 유형을 지정할 필요가 없습니다. 종속성에서 명시적으로 패키징 유형을 지정해야 하는 경우 type 요소를 사용할 수 있습니다.