Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

JBoss EAP XP 5.0 업그레이드 및 마이그레이션 가이드

Red Hat JBoss Enterprise Application Platform 8.0

JBoss EAP XP 4.0.x에서 JBoss EAP XP 5.0으로 업그레이드 및 마이그레이션하기 위한 지침

Red Hat Customer Content Services

초록

이 문서에서는 JBoss EAP XP 4.0.x를 JBoss EAP XP 5.0 및 필요한 애플리케이션 마이그레이션으로 업그레이드하는 방법에 대해 설명합니다.

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

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

JBoss EAP 문서에 대한 피드백 제공
링크 복사

오류를 보고하거나 문서를 개선하기 위해 Red Hat Jira 계정에 로그인하여 문제를 제출하십시오. Red Hat Jira 계정이 없는 경우 계정을 생성하라는 메시지가 표시됩니다.

프로세스

  1. 티켓을 생성하려면 다음 링크를 클릭하십시오.
  2. 요약 에 문제에 대한 간략한 설명을 입력합니다.
  3. 설명에서 문제 또는 개선 사항에 대한 자세한 설명을 제공합니다. 문서에서 문제가 발생한 위치에 URL을 포함합니다.
  4. Submit 을 클릭하고 문제를 적절한 문서 팀으로 라우팅합니다.

1장. JBoss EAP XP 업그레이드
링크 복사

1.1. 업그레이드 및 마이그레이션
링크 복사

JBoss EAP XP 5.0 업그레이드 및 마이그레이션 가이드에 설명된 단계를 사용하여 JBoss EAP XP 3.0 또는 4.0 제품을 JBoss EAP XP 5.0 제품으로 준비, 업그레이드 및 마이그레이션합니다. JBoss EAP XP 5.0은 JBoss EAP 8.0과만 호환됩니다. JBoss EAP 7.4에서 서버를 운영하고 JBoss EAP XP 5.0을 설치하려면 먼저 JBoss EAP 7.4 인스턴스를 JBoss EAP 8.0으로 업그레이드해야 합니다.

이 가이드에서는 업그레이드 및 마이그레이션 프로세스에 사용할 수 있는 툴을 참조합니다. 이러한 도구는 다음과 같습니다.

  • MTA(Migration Toolkit for Applications)
  • JBoss Server 마이그레이션 툴

JBoss EAP XP 3.0 또는 4.0 릴리스를 JBoss EAP XP 5.0으로 업그레이드 및 마이그레이션한 후 JBoss EAP 8.0 인스턴스에 대한 애플리케이션 마이그레이션을 구현할 수 있습니다.

1.2. 업그레이드 및 마이그레이션 준비
링크 복사

JBoss EAP 확장 팩을 업그레이드한 후 애플리케이션 코드를 업데이트해야 할 수 있습니다.

JBoss EAP XP 5.0의 경우 JBoss EAP XP 3.0 또는 4.0 애플리케이션에 대해 일부 이전 버전과의 호환성이 존재할 수 있습니다. 그러나 애플리케이션이 더 이상 사용되지 않는 기능 또는 JBoss EAP XP 5.0에서 제거된 기능을 사용하는 경우 애플리케이션 코드를 변경해야 할 수 있습니다.

마이그레이션 프로세스를 시작하기 전에 다음 새 항목을 검토합니다.

  • JBoss EAP XP 5.0 릴리스에 추가된 JBoss EAP XP 기능.
  • MicroProfile 기능이 JBoss EAP XP 5.0 릴리스에 추가되었습니다.
  • 기존 MicroProfile 기능 개선
  • JBoss EAP XP 5.0에서 더 이상 사용되지 않는 기능 및 기능.
  • JBoss EAP XP 5.0에서 제거된 기능 및 기능.
  • 한 EAP XP 릴리스에서 다른 릴리스로 마이그레이션하는 데 사용할 수 있는 툴입니다.

나열된 항목을 검토한 후 환경을 분석하고 업그레이드 프로세스 및 마이그레이션 프로세스를 계획합니다. JBoss EAP XP 5.0으로 마이그레이션할 모든 애플리케이션을 백업하십시오.

이제 현재 JBoss EAP XP 3.0 또는 4.0 릴리스를 JBoss EAP XP 5.0으로 업그레이드할 수 있습니다. 업그레이드 프로세스 후 애플리케이션 마이그레이션을 구현할 수 있습니다.

1.3. MicroProfile 기능 개선
링크 복사

JBoss EAP XP 5.0 릴리스에는 다음 MicroProfile 6.1 구성 요소를 지원합니다.

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile OpenAPI
  • MicroProfile Telemetry
  • MicroProfile REST Client

1.4. 더 이상 사용되지 않거나 지원되지 않는 MicroProfile 기능
링크 복사

애플리케이션을 JBoss EAP XP 5.0으로 마이그레이션하기 전에 JBoss EAP XP 4.0.x에서 사용 가능한 일부 기능은 더 이상 사용되지 않거나 더 이상 지원되지 않을 수 있습니다.

Red Hat은 높은 유지 관리 비용, 낮은 커뮤니티 관심 및 훨씬 더 나은 대체 솔루션으로 인해 일부 기술에 대한 지원을 제거했습니다.

지원되지 않는 모든 기능에 대해 Red Hat JBoss EAP XP 5.0 릴리스 노트 와 Red Hat JBoss Enterprise Application Platform 8.0의 릴리스 노트 를 검토하십시오.

다음 툴 중 하나를 선택하여 JBoss EAP XP 3.0 또는 4.0 제품을 JBoss EAP XP 5.0 제품으로 업그레이드하고 마이그레이션할 수 있습니다.

  • MTA(Migration Toolkit for Applications)
  • JBoss Server 마이그레이션 툴

2.1. JBoss Server 마이그레이션 툴을 사용하여 서버 구성 마이그레이션
링크 복사

JBoss EAP XP 5.0의 새로운 기능 및 설정을 포함하도록 서버 구성을 업데이트할 때 JBoss Server 마이그레이션 도구를 사용하십시오. JBoss EAP XP 5.0에서 구성을 지원하는 경우 기존 JBoss EAP XP 3.0 또는 4.0 서버 구성을 유지할 수 있습니다.

JBoss Server 마이그레이션 도구는 기존 JBoss EAP XP 3.0 또는 4.0 서버 구성 파일을 읽고 이러한 파일에 새로운 필요한 하위 시스템을 추가합니다. 이 툴은 기존 하위 시스템 구성도 새 기능으로 업데이트하고 더 이상 사용되지 않는 하위 시스템 구성을 제거합니다.

JBoss Server Migration Tool을 사용하여 JBoss EAP XP 5.0 구성을 위한 독립형 서버를 마이그레이션할 수 있습니다.

JBoss EAP XP 5.0에는 JBoss Server 마이그레이션 도구가 포함되어 있지 않으므로 JBoss EAP XP 다운로드 페이지에서 툴을 다운로드해야 합니다.

MTA(Migration Toolkit for Applications)에는 Jakarta 애플리케이션의 마이그레이션을 단순화하는 확장 가능하고 사용자 지정 가능한 규칙 기반 툴이 포함되어 있습니다. 툴킷을 사용하여 애플리케이션의 API, 기술 및 아키텍처를 분석할 수 있습니다. 툴킷은 JBoss EAP XP 3.0 또는 4.0에서 JBoss EAP XP 5.0으로 마이그레이션하려는 애플리케이션에 대한 보고서를 제공합니다.

MTA 보고서는 다음 정보를 출력합니다.

  • 필요한 모든 마이그레이션 변경에 대한 자세한 설명입니다.
  • 변경이 필수 또는 선택 사항인지 여부입니다.
  • 변경이 복잡하거나 단순하든지 여부입니다.
  • 마이그레이션 업데이트가 필요한 코드에 대한 링크입니다.
  • 필요한 마이그레이션 변경 사항을 완료하는 데 도움이 되는 정보에 대한 팁과 링크입니다.
  • 각 마이그레이션 문제에 대한 노력의 추정치와 애플리케이션을 마이그레이션하기 위한 총 예상 노력입니다.

또한 MTA를 사용하여 JBoss EAP XP 3.0 또는 4.0 애플리케이션의 코드 및 아키텍처를 JBoss EAP XP 5.0으로 마이그레이션하기 전에 분석할 수 있습니다. JBoss EAP XP 3.0 또는 4.0에서 JBoss EAP XP 5.0으로 애플리케이션을 마이그레이션하기 위한 MTA 규칙 세트는 JBoss EAP XP 5.0으로 마이그레이션할 때 대체 구성으로 교체해야 하는 XML 설명자, 특정 애플리케이션 코드 및 매개변수에 대한 보고서입니다.

3장. 애플리케이션 마이그레이션
링크 복사

JBoss EAP XP의 이전 릴리스용으로 생성된 애플리케이션을 JBoss EAP XP 5.0으로 마이그레이션할 수 있습니다.

3.1. MicroProfile 애플리케이션 마이그레이션
링크 복사

MicroProfile 6.1은 자카르타 EE 10 Core Profile과 일치하며 MicroProfile Telemetry를 도입하여 MicroProfile OpenTracing을 대체합니다.

MicroProfile 6.1에는 모든 주요 MicroProfile 사양에 대한 업데이트가 포함되어 있습니다.

다음 사양에는 MicroProfile 6.1의 API 호환되지 않는 변경 사항이 포함될 수 있습니다.

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile OpenAPI

이 사양을 사용하는 애플리케이션을 최신 자카르타 EE 10 사양으로 업데이트해야 합니다.

다음 방법 중 하나를 선택하여 MicroProfile 6.1로 애플리케이션을 업데이트할 수 있습니다.

  • 프로젝트의 pom.xml 파일에 MicroProfile 6.1 종속성 추가
  • JBoss EAP XP BOMs를 사용하여 지원되는 아티팩트를 프로젝트의 pom.xml 파일의 JBoss EAP XP 종속성 관리로 가져옵니다.

3.2. MicroProfile OpenTracing에서 OpenTelemetry 추적으로 마이그레이션
링크 복사

MicroProfile OpenTracing은 JBoss EAP XP 5.0에서 지원되지 않으며 OpenTelemetry 추적으로 교체됩니다.

MicroProfile OpenTracing을 OpenTelemetry Tracing으로 교체하려면 다음 단계를 따르십시오.

  • org.eclipse.microprofile.opentracing:microprofile-opentracing-api 종속성을 io.opentelemetry:opentelemetry-api 및 io.opentelemetry:opentelemetry-context.
  • org.eclipse.microprofile.opentracing Java 패키지를 io.opentelemetry Java 패키지로 교체합니다. 이러한 교체에는 클래스 및 메서드에 대한 추가 변경이 포함될 수 있습니다.

3.3. MicroProfile Metrics에서 Micrometer로 마이그레이션
링크 복사

MicroProfile Metrics는 JBoss EAP XP 5.0에서 지원되지 않으며 Micrometer로 교체됩니다.

MicroProfile Metrics를 Micrometer로 교체하려면 다음 단계를 따르십시오.

  • org.eclipse.microprofile.metrics:microprofile-metrics-api 종속성을 io.micrometer:micrometer-core 로 바꿉니다.
  • org.eclipse.microprofile.metric Java 패키지를 io.micrometer Java 패키지로 교체합니다. 이러한 교체에는 클래스 및 메서드에 대한 추가 변경이 포함될 수 있습니다.

법적 공지
링크 복사

Copyright © 2024 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맨 위로 이동