Apache Karaf에서 Fuse 시작하기

Red Hat Fuse 7.11

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

Red Hat Fuse Documentation Team

초록

Apache Karaf에서 Fuse로 애플리케이션 빌드를 시작합니다.

머리말

Fuse를 시작하려면 Apache Karaf 컨테이너의 파일을 다운로드하여 설치해야 합니다. 여기에서는 첫 번째 Fuse 애플리케이션을 설치, 개발 및 빌드하는 방법을 안내합니다.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.

1장. Fuse on Karaf 시작하기

Fuse on Karaf에 대한 정보와 함께 Karaf 컨테이너에 첫 번째 Fuse 애플리케이션을 설치, 개발 및 구축하기 위해 다음과 같은 정보와 지침을 제공합니다. 자세한 내용은 다음 항목을 참조하십시오.

1.1. Fuse on Karaf 정보

Apache Karaf는 OSGi Alliance의 OSGi 표준을 기반으로 합니다. OSGi는 통신 업계에서 시작되었으며 서버를 종료하지 않고도 즉시 업그레이드할 수 있는 게이트웨이 서버를 개발하는 데 사용되었습니다. 결과적으로 OSGi 컨테이너 기술은 다양한 다른 용도로 사용되고 있으며 모듈형 애플리케이션(예: Eclipse IDE)에 널리 사용됩니다.

이 컨테이너 기술의 특징은 다음과 같습니다.

  • 독립 실행형 모드에서 실행하는 데 특히 적합합니다.
  • 정교한 클래스 로드를 지원하는 OSGi 번들(OSGi 번들)에 대한 강력한 지원.
  • 여러 버전의 종속성을 컨테이너에 나란히 배포할 수 있습니다(실제로 어느 정도 주의가 필요합니다).
  • 핫 코드 스왑을 통해 컨테이너를 종료하지 않고 모듈을 업그레이드하거나 교체할 수 있습니다. 이는 고유한 기능이지만 제대로 작동하려면 상당한 노력이 필요합니다.

참고: Spring Dynamic Modules (Spring-DM) (Apache Karaf의 OSGi 서비스 계층과 Spring XML 통합)는 지원되지 않습니다. 대신 블루프린트 프레임워크를 사용해야 합니다. 블루프린트 XML을 사용하면 Spring 프레임워크에서 Java 라이브러리를 사용할 수 없습니다. 최신 버전의 Spring은 블루프린트와 호환됩니다.

1.2. Karaf에 Fuse 설치

Karaf의 Fuse 7.11용 표준 설치 패키지는 Red Hat 고객 포털에서 다운로드할 수 있습니다. Karaf 컨테이너의 표준 어셈블리를 설치하고 전체 Fuse 기술 스택을 제공합니다.

사전 요구 사항

절차

  1. Apache Karaf에서 Fuse에 대해 다운로드한 .zip 아카이브 파일의 압축을 풀고 파일 시스템인 FUSE_INSTALL 의 편리한 위치에 압축을 풉니다.
  2. Fuse 런타임에 관리자 사용자를 추가합니다.

    1. 텍스트 편집기에서 FUSE_INSTALL/etc/users.properties 파일을 엽니다.
    2. # admin = admin 으로 시작하는 행 시작 시 # 문자를 삭제합니다.
    3. # _g_\:admingroup 으로 시작하는 행 시작 시 # 문자를 삭제합니다.
    4. 다음과 같은 사용자 항목 및 관리자 그룹 항목이 있도록 사용자 항목의 사용자 이름, USERNAME, password, PASSWORD 를 사용자 지정합니다.

      USERNAME = PASSWORD,_g_:admingroup
      _g_\:admingroup = group,admin,manager,viewer,systembundles,ssh
    5. etc/users.properties 파일을 저장합니다.
  3. 다음과 같이 CodeReady Studio 설치 프로그램을 실행합니다.

    java -jar DOWNLOAD_LOCATION/codereadystudio-12.21.3.GA-installer-standalone.jar
  4. 설치하는 동안:

    1. 이용 약관에 동의합니다.
    2. 선호하는 설치 경로를 선택합니다.
    3. Java 8 JVM을 선택합니다.
    4. 플랫폼 및 서버 선택 단계에서 추가 를 클릭하고 FUSE_INSTALL 디렉터리의 위치를 검색하여 Karaf 런타임에서 Fuse를 구성합니다.
    5. Select additional features to Install 단계에서 Red Hat Fuse Tooling 을 선택합니다.
  5. CodeReady Studio가 시작됩니다. 런타임 검색 대화 상자가 표시되면 OK 를 클릭하여 Karaf 런타임에서 Fuse를 만듭니다.
  6. (선택 사항) 명령줄에서 Apache Maven을 사용하려면 Maven 설정에 로컬로 설명된 대로 Maven을 설치하고 구성해야 합니다.

    참고

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

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

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

사전 요구 사항

절차

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

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

      • 배포 플랫폼으로 Standalone 을 선택합니다.
      • 런타임 환경으로 Karaf/Fuse 를 선택하고 런타임 (선택 사항) 드롭다운 메뉴를 사용하여 fuse-karaf-7.11.1.fuse-7_11_1-00013-redhat-00003 런타임 서버를 대상 런타임으로 선택합니다.
    5. 대상 런타임을 선택하면 Camel 버전이 자동으로 선택되고 필드가 회색으로 표시됩니다.
    6. 다음을 클릭합니다.
    7. Advanced Project Setup 창에서 Beginner CryostatContent Based Router - 블루프린트 DSL 템플릿을 선택합니다.
    8. 완료를 클릭합니다.
    9. 연결된 Fuse 통합 화면을 열라는 메시지가 표시되면 예를 클릭합니다.
    10. CodeReady Studio가 필요한 아티팩트를 다운로드하고 백그라운드에서 프로젝트를 빌드하는 동안 기다립니다.

      중요

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

  2. 다음과 같이 서버에 프로젝트를 배포합니다.

    1. 서버 보기( Fuse 통합 화면 왼쪽)에서 서버가 아직 시작되지 않은 경우 fuse-karaf-7.11.1.fuse-7_11_1-00013-redhat-00003 Runtime Server 서버를 선택하고 녹색 화살표를 클릭하여 시작합니다.

      참고

      대화 상자가 표시되면 경고: 'localhost' 호스트의 진위를 설정할 수 없습니다. 를 클릭하여 서버에 연결하고 Karaf 콘솔에 액세스합니다.

    2. 콘솔 보기에 다음과 같은 메시지가 표시될 때까지 기다립니다.

      Karaf started in 1s. Bundle stats: 12 active, 12 total
    3. 서버가 시작되면 서버 보기로 다시 전환하고 서버 를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가 및 제거를 선택합니다.
    4. 추가 및 제거 대화 상자에서 fuse-camel-cbr 프로젝트를 선택하고 Add > 버튼을 클릭합니다.
    5. 완료를 클릭합니다.
    6. 터미널 보기로 이동하여 bundle:list | tail 을 입력하여 프로젝트의 OSGi 번들이 시작되었는지 확인할 수 있습니다. 다음과 같은 몇 가지 출력이 표시됩니다.

      ...
      228 │ Active │  80 │ 1.0.0.201505202023          │ org.osgi:org.osgi.service.j
      232 │ Active │  80 │ 1.0.0.SNAPSHOT              │ Fuse CBR Quickstart
      참고

      Camel 경로가 시작되는 즉시 Fuse 설치에 디렉터리, work/cbr/input 가 생성됩니다( fuse-camel-cbr 프로젝트에없음 ).

  3. 프로젝트의 src/main/data 디렉토리에서 찾은 파일을 FUSE_INSTALL/work/cbr/input 디렉터리에 복사합니다. 시스템 파일 브라우저(Eclipse 제외)에서 이 작업을 수행할 수 있습니다.
  4. 잠시 기다린 다음 FUSE_INSTALL/work/cbr/output 디렉토리에서 국가별로 구성된 동일한 파일을 확인합니다.

    1. work/cbr/output/othersorder1.xml
    2. work/cbr/output/ukorder2.xmlorder4.xml
    3. work/cbr/output/usorder3.xmlorder5.xml
  5. 다음과 같이 프로젝트 배포를 취소합니다.

    1. 서버 보기에서 Red Hat Fuse 7+ Runtime Server 서버를 선택합니다.
    2. 서버를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 추가 및 제거를 선택합니다.
    3. 추가 및 제거 대화 상자에서 fuse-camel-cbr 프로젝트를 선택하고 < 제거 버튼을 클릭합니다.
    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>

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

    이 예에서는 프로젝트를 빌드하는 데 필요한 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>

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

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

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 요소를 사용할 수 있습니다.

법적 공지

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.