마이그레이션 가이드

절차

1. 프로젝트의 pom.xml 파일을 엽니다.

2. 다음 예와 같이 프로젝트의 pom.xml 파일(또는 상위 pom.xml 파일)에 dependencyManagement 요소를 추가합니다.

   <?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>

   참고

   Spring Boot 버전도 업데이트해야 합니다. 일반적으로 pom.xml 파일의 Fuse 버전에서 찾을 수 있습니다.

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

3. pom.xml 파일을 저장합니다.

절차

1. 프로젝트의 pom.xml 파일을 엽니다.

2. 다음 예와 같이 프로젝트의 pom.xml 파일(또는 상위 pom.xml 파일)에 dependencyManagement 요소를 추가합니다.

   <?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-eap-bom</artifactId>
           <version>${fuse.version}</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>
     ...
   </project>

3. pom.xml 파일을 저장합니다.

절차

1. 프로젝트의 pom.xml 파일을 엽니다.

2. 다음 예와 같이 프로젝트의 pom.xml 파일(또는 상위 pom.xml 파일)에 dependencyManagement 요소를 추가합니다.

   <?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-karaf-bom</artifactId>
           <version>${fuse.version}</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>
     ...
   </project>

3. pom.xml 파일을 저장합니다.

절차

1. patch:update 명령을 실행합니다. 컨테이너를 다시 시작할 필요가 없습니다.

   karaf@root()> patch:update
   Current patch mechanism version: 7.1.0.fuse-710023-redhat-00001
   New patch mechanism version detected: 7.2.0.fuse-720035-redhat-00001
   Uninstalling patch features in version 7.1.0.fuse-710023-redhat-00001
   Installing patch features in version 7.2.0.fuse-720035-redhat-00001

2. patch:list 명령을 호출하여 업그레이드 설치 프로그램 목록을 표시합니다. 이 목록에서 [name] 제목 아래의 항목은 업그레이드 ID입니다. 예를 들면 다음과 같습니다.

   karaf@root()> patch:list
   [name]                                    [installed] [rollup] [description]
   fuse-karaf-7.2.0.fuse-720035-redhat-00001 false       true     fuse-karaf-7.2.0.fuse-720035-redhat-00001

3. patch:simulate 명령을 호출하고 적용할 업그레이드 ID를 다음과 같이 지정하여 업그레이드를 시뮬레이션합니다.

   karaf@root()> patch:simulate fuse-karaf-7.2.0.fuse-720035-redhat-00001
   INFO : org.jboss.fuse.modules.patch.patch-management (226): Installing rollup patch "fuse-karaf-7.2.0.fuse-720035-redhat-00001"
   ========== Repositories to remove (9):
    - mvn:io.hawt/hawtio-karaf/2.0.0.fuse-710018-redhat-00002/xml/features
   ...
   ========== Repositories to add (9):
    - mvn:io.hawt/hawtio-karaf/2.0.0.fuse-720044-redhat-00001/xml/features
   ...
   ========== Repositories to keep (10):
    - mvn:org.apache.activemq/artemis-features/2.4.0.amq-711002-redhat-1/xml/features
   ...
   ========== Features to update (100):
   [name]                         [version]                         [new version]
   aries-blueprint                4.2.0.fuse-710024-redhat-00002    4.2.0.fuse-720061-redhat-00001
   ...
   ========== Bundles to update as part of features or core bundles (100):
   [symbolic name]                                                [version]                         [new location]
   io.hawt.hawtio-log                                             2.0.0.fuse-710018-redhat-00002    mvn:io.hawt/hawtio-log/2.0.0.fuse-720044-redhat-00001
   ...
   ========== Bundles to reinstall as part of features or core bundles (123):
   [symbolic name]                                                [version]                         [location]
   com.fasterxml.jackson.core.jackson-annotations                 2.8.11                            mvn:com.fasterxml.jackson.core/jackson-annotations/2.8.11
   ...
   Simulation only - no files and runtime data will be modified.
   karaf@root()>

   이렇게 하면 업그레이드가 수행되지만 컨테이너를 실제로 변경하지 않는 경우 컨테이너에 대한 변경 로그가 생성됩니다. 시뮬레이션 로그를 검토하여 컨테이너에 적용할 변경 사항을 파악합니다.

4. patch:install 명령을 호출하여 컨테이너를 업그레이드하고 적용할 업그레이드 ID를 지정합니다. 예를 들면 다음과 같습니다.

   karaf@root()> patch:install fuse-karaf-7.5.0.fuse-750035-redhat-00001

5. 업그레이드 아티팩트 중 하나를 검색하여 업그레이드를 확인합니다. 예를 들어 Fuse 7.1.0을 Fuse 7.2.0으로 업그레이드한 경우 다음과 같이 빌드 번호 750035로 번들을 검색할 수 있습니다.

   karaf@root()> bundle:list -l | grep 750035
    22 │ Active │  80 │ 7.5.0.fuse-750035-redhat-00001  │ mvn:org.jboss.fuse.modules/fuse-pax-transx-tm-narayana/7.5.0.fuse-750035-redhat-00001
   188 │ Active │  80 │ 7.5.0.fuse-750035-redhat-00001  │ mvn:org.jboss.fuse.modules.patch/patch-commands/7.5.0.fuse-750035-redhat-00001

절차

1. patch:list 명령을 호출하여 가장 최근에 설치된 패치의 업그레이드 ID UPGRADE_ID 를 가져옵니다.

2. 다음과 같이 patch:rollback 명령을 호출합니다.

   patch:rollback UPGRADE_ID

   참고

   경우에 따라 업그레이드를 롤백하기 위해 컨테이너를 다시 시작해야 합니다. 이 경우 컨테이너가 자동으로 다시 시작됩니다. OSGi 런타임의 매우 동적인 특성으로 인해 재시작 중에 호환되지 않는 클래스와 관련된 일부 오류가 표시될 수 있습니다. 이러한 오류는 방금 시작하거나 중지하여 무시해도 되는 OSGi 서비스와 관련이 있습니다.