JBoss EAP에서 Fuse 시작하기


Red Hat Fuse 7.10

Red Hat Fuse on EAP를 사용하여 빠르게 시작

Red Hat Fuse Documentation Team

초록

Fuse on JBoss Enterprise Application Platform으로 애플리케이션 빌드를 시작하십시오.

머리말

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 FoundationJakarta 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 기술 스택을 제공합니다.

사전 요구 사항

절차

  1. 다음과 같이 쉘 프롬프트에서 JBoss EAP 설치 프로그램을 실행합니다.

    java -jar DOWNLOAD_LOCATION/jboss-eap-7.4.0-installer.jar
    Copy to Clipboard Toggle word wrap
  2. 설치하는 동안:

    1. 이용 약관에 동의합니다.
    2. JBoss EAP 런타임으로 선호하는 설치 경로 EAP_INSTALL 을 선택합니다.
    3. 관리 사용자를 만들고 나중에 이러한 관리 사용자 자격 증명을 주의 깊게 기록해 두십시오.
    4. 나머지 화면에서 기본 설정을 허용할 수 있습니다.
  3. 쉘 프롬프트를 열고 디렉터리를 EAP_INSTALL 으로 변경합니다.
  4. EAP_INSTALL 디렉터리에서 다음과 같이 EAP 설치 프로그램에서 Fuse를 실행합니다.

    java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.10.0.jar
    Copy to Clipboard Toggle word wrap
  5. 다음과 같이 CodeReady Studio 설치 프로그램을 실행합니다.

    java -jar DOWNLOAD_LOCATION/codereadystudio-12.21.0.GA-installer-standalone.jar
    Copy to Clipboard Toggle word wrap
  6. 설치하는 동안:

    1. 이용 약관에 동의합니다.
    2. 선호하는 설치 경로를 선택합니다.
    3. Java 8 JVM을 선택합니다.
    4. Select Platforms and Servers 단계에서 Add 를 클릭하고 EAP_INSTALL 디렉터리의 위치를 검색하여 JBoss EAP 런타임을 구성합니다.
    5. Select additional features to Install 단계에서 Red Hat Fuse Tooling 을 선택합니다.
  7. CodeReady Studio가 시작됩니다. 런타임 검색 대화 상자가 표시되면 OK 를 클릭하여 JBoss EAP 런타임을 생성합니다.
  8. (선택 사항) 명령줄에서 Apache Maven을 사용하려면 에 설명된 대로 Maven을 설치하고 구성해야 합니다.

    참고

    CodeReady Studio만 사용하는 경우 CodeReady Studio에 Maven이 사전 설치되어 구성되어 있으므로 Maven을 설치할 필요가 없습니다. 그러나 명령줄에서 Maven을 호출하려면 이 단계를 수행해야 합니다.

1.3. JBoss EAP에서 첫 번째 Fuse 애플리케이션 빌드

이 지침에서는 JBoss EAP에서 첫 번째 Fuse 애플리케이션을 빌드하는 데 도움이 됩니다.

사전 요구 사항

절차

  1. CodeReady Studio에서 다음과 같이 새 프로젝트를 생성합니다.

    1. File(파일)NewNew Cryostat Integration Project 를 선택합니다.
    2. 프로젝트 이름 필드에 192.0.2. -camel 을 입력합니다.
    3. 다음을 클릭합니다.
    4. 대상 환경 선택 창에서 다음 설정을 선택합니다.

      • 배포 플랫폼으로 Standalone 을 선택합니다.
      • EAP에서 런타임 환경으로 Wildfly/Fuse 를 선택하고 런타임 (선택 사항) 드롭다운 메뉴를 사용하여 JBoss EAP 7.x 런타임 서버를 대상 런타임으로 선택합니다.
    5. 대상 런타임을 선택하면 Camel 버전이 자동으로 선택되고 필드가 회색으로 표시됩니다.
    6. 다음을 클릭합니다.
    7. Advanced Project Setup 창에서 Spring Cryostat - Spring DSL 템플릿을 선택합니다.
    8. 완료를 클릭합니다.

      중요

      CodeReady Studio에서 Fuse 프로젝트를 처음 빌드하는 경우 마법사가 프로젝트 생성을 완료하는 데 몇 분이 걸립니다. 이는 원격 Maven 리포지토리에서 종속성을 다운로드하기 때문입니다. 프로젝트가 백그라운드에서 빌드하는 동안 마법사를 중단하거나 CodeReady Studio를 종료하지 마십시오.

    9. 연결된 Fuse 통합 화면을 열라는 메시지가 표시되면 예를 클릭합니다.
    10. CodeReady Studio가 필요한 아티팩트를 다운로드하고 백그라운드에서 프로젝트를 빌드하는 동안 기다립니다.
  2. 다음과 같이 서버에 프로젝트를 배포합니다.

    1. 서버 보기( Fuse Integration 관점의 오른쪽 위 모서리)에서 서버가 아직 시작되지 않은 경우 Red Hat JBoss EAP 7.3 런타임 서버를 선택하고 녹색 화살표를 클릭하여 시작합니다.
    2. 콘솔 보기에 다음과 같은 메시지가 표시될 때까지 기다립니다.

      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 Toggle word wrap
    3. 서버가 시작된 후 서버 보기로 다시 전환한 후 서버 를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가 및 제거를 선택합니다.
    4. 추가 및 제거 대화 상자에서 Cryostat -camel 프로젝트를 선택하고 Add > 를 클릭합니다.
    5. 완료를 클릭합니다.
  3. 다음과 같이 프로젝트가 작동하는지 확인합니다.

    1. 다음 URL로 이동하여 ExternalIP -camel 프로젝트에서 실행되는 서비스에 액세스합니다. http://localhost:8080/camel-test-spring?name=Kermit
    2. 브라우저 창에 Hello Kermit 이 표시되어야 합니다.
  4. 다음과 같이 프로젝트 배포를 취소합니다.

    1. 서버 보기에서 Red Hat JBoss EAP 7.3 런타임 서버를 선택합니다.
    2. 서버를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가 및 제거를 선택합니다.
    3. 추가 및 제거 대화 상자에서 Cryostat -camel 프로젝트를 선택하고 < 제거를 클릭합니다.
    4. 완료를 클릭합니다.

2장. Maven을 로컬로 설정

일반적인 Fuse 애플리케이션 개발에서는 Maven을 사용하여 프로젝트를 빌드하고 관리합니다.

다음 주제는 Maven을 로컬로 설정하는 방법을 설명합니다.

2.1. Maven 설정 준비

Maven은 Apache의 무료 오픈 소스 빌드 툴입니다. 일반적으로 Maven을 사용하여 Fuse 애플리케이션을 빌드합니다.

절차

  1. Maven 다운로드 페이지에서 Maven의 최신 버전을 다운로드합니다.
  2. 시스템이 인터넷에 연결되어 있는지 확인합니다.

    프로젝트를 빌드하는 동안 기본 동작은 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>
Copy to Clipboard Toggle word wrap

2.3. 로컬 Maven 리포지토리 사용

인터넷 연결 없이 컨테이너를 실행 중이고 오프라인에서 사용할 수 없는 종속성이 있는 애플리케이션을 배포해야 하는 경우 Maven 종속성 플러그인을 사용하여 애플리케이션의 종속 항목을 Maven 오프라인 리포지토리로 다운로드할 수 있습니다. 그런 다음 이 사용자 지정 Maven 오프라인 리포지토리를 인터넷 연결이 없는 시스템에 배포할 수 있습니다.

절차

  1. pom.xml 파일이 포함된 프로젝트 디렉터리에서 다음과 같은 명령을 실행하여 Maven 프로젝트의 리포지토리를 다운로드합니다.

    mvn org.apache.maven.plugins:maven-dependency-plugin:3.1.0:go-offline -Dmaven.repo.local=/tmp/my-project
    Copy to Clipboard Toggle word wrap

    이 예에서는 프로젝트를 빌드하는 데 필요한 Maven 종속 항목 및 플러그인이 /tmp/my-project 디렉터리로 다운로드됩니다.

  2. 이 사용자 지정 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>
Copy to Clipboard Toggle word wrap

위 섹션이 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::mirrorUrl

    for example, -DmavenMirrorUrl=my-mirror::http://mirror.net/repository

  • -DmavenMirrorUrl=mirrorUrl

    for 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
Copy to Clipboard Toggle word wrap

값에 대한 설명은 다음과 같습니다.

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>
Copy to Clipboard Toggle word wrap

이전 아티팩트에 대한 종속성을 정의하려면 POM 파일에 다음 종속성 요소를 추가합니다.

<project ... >
  ...
  <dependencies>
    <dependency>
      <groupId>org.fusesource.example</groupId>
      <artifactId>bundle-demo</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
  </dependencies>
  ...
</project>
Copy to Clipboard Toggle word wrap
참고

들은 특정 종류의 JAR 파일일 뿐이고, Cryostat는 기본 Maven 패키지 유형이므로 이전 종속성에서 번들 패키지 유형을 지정할 필요가 없습니다. 종속성에서 명시적으로 패키징 유형을 지정해야 하는 경우 type 요소를 사용할 수 있습니다.

법적 공지

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동