설명서Experience Cloud KCS

AEMaaCS에서 Java 21로 마이그레이션하는 동안 Java 8 및 Java 11 사용 중단 문제

마지막 업데이트: 2026년 7월 15일

Adobe Experience Manager(AEM) as a Cloud Service은 런타임 시 더 이상 Java 8 또는 Java 11을 지원하지 않으며 Java 21로 마이그레이션해야 합니다. 이 문제는 빌드 시간 Java 버전, 런타임 Java 버전, 타사 종속성 또는 마이그레이션 타임라인이 호환성 문제 및 필수 작업에 대한 불확실성을 만들 때 발생합니다. 이 문제를 해결하려면 런타임을 확인하고 호환성을 확인하고 빌드를 업데이트합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • Cloud Manager 빌드 알림은 더 이상 사용되지 않는 Java API의 사용을 나타냅니다.
  • 빌드가 여전히 Java 11을 사용하는 동안 환경은 런타임 시 Java 21을 실행합니다.
  • 팀은 Java 21 런타임 롤아웃 후에도 Java 11 빌드가 계속 지원되는지 여부가 확실하지 않습니다.
  • 작업 센터 알림은 Java 사용 중단 또는 마이그레이션 요구 사항을 참조합니다.
  • 런타임 및 빌드 시간 Java 버전은 여러 환경에서 일관성이 없는 것처럼 보입니다.

근본 원인

이 문제는 AEM as a Cloud Service이 런타임 환경을 Java 21로 업그레이드하고 고객 프로젝트가 빌드 프로세스에 Java 11을 계속 사용할 수 있기 때문에 발생합니다. 런타임 Java는 Adobe에서 관리하는 반면, 빌드 시간 Java는 프로젝트 구성에 의해 제어됩니다. 더 이상 사용되지 않는 API 및 종속성 비호환성과 함께 이러한 분리를 오해하면 마이그레이션 문제가 발생하고 빌드 유효성 검사 문제가 발생합니다.

해결 방법 resolution

다음 단계에 따라 Java 런타임 사용을 확인하고 Java 21 호환성을 위해 애플리케이션을 준비합니다.

  1. Cloud Manager에서 Developer Console을 열고 보고된 Java 버전을 검토하여 런타임 Java 버전을 확인합니다.
  2. 런타임 버전이 Developer Console에 표시되지 않을 때 System.getProperty("java.version") 값을 기록하여 사용자 지정 OSGi 구성 요소를 통해 런타임 Java 버전을 기록합니다.
  3. .cloudmanager/java-version 파일을 검토하여 프로젝트가 Java 11, 17 또는 21로 빌드되는지 확인하십시오.
  4. 환경이 AEM 릴리스 17098 이상에 있는지, 로컬 SDK을 Java 21과 함께 실행하고, 애플리케이션을 로컬로 배포하고, 클래스 로드 또는 종속성 문제가 발생하지 않는지 확인하여 Java 21 호환성을 확인합니다.
  5. .cloudmanager/java-version을(를) 21로 설정하는 개발 분기를 만들고 개발 파이프라인을 실행하여 Java 21에서 응용 프로그램 동작의 유효성을 검사합니다.
  6. 작업 센터 알림이 표시될 때 더 이상 사용되지 않는 API 사용을 검토하고 제거된 Sling, Felix 또는 Jetty API와 같은 더 이상 사용되지 않거나 제거된 패키지를 참조하는 코드를 업데이트합니다.
  7. 호환성 유효성 검사가 성공하면 .cloudmanager/java-version 파일을 21로 만들거나 수정하고 비프로덕션 파이프라인을 실행하여 빌드 버전을 Java 21로 업데이트합니다.
  8. Java 21 마이그레이션 알림 이메일을 검토하고 종속성 분석에서 식별된 지원되지 않는 라이브러리 또는 종속성을 업데이트합니다. 예를 들어, 식별되면 Groovy 또는 Logback과 같은 지원되지 않는 버전의 라이브러리를 바꾸거나 업그레이드합니다.
  9. 런타임 보고서 Java 21, Cloud Manager 빌드가 성공하고, 사용 중단 알림이 더 이상 표시되지 않으며, 기능 테스트가 정상적으로 통과되었는지 확인하여 해결 방법을 확인합니다.

에스컬레이션 시기

  • 권한이 확인되면 Developer Console에 액세스할 수 없습니다.
  • Java 21 유효성 검사 후에도 응용 프로그램에서 종속성 비호환성을 계속 표시합니다.
  • 빌드 버전을 Java 21로 업데이트한 후 Cloud Manager 빌드가 실패합니다.
  • 지원되지 않는 종속성은 마이그레이션 분석 및 수정 후에도 해결되지 않은 상태로 유지됩니다.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles