Cloud Manager FAQ

다음 섹션에서는 Cloud Services에 대한 Cloud Manager와 관련된 질문과 답변을 제공합니다.

Cloud Manager 빌드에 Java 11을 사용할 수 있습니까?

Java 8에서 11로 빌드를 전환할 때 AEM Cloud Manager 빌드가 실패합니다. 이 문제는 많은 원인을 가질 수 있으며 가장 일반적인 원인은 아래에 설명되어 있습니다.

  • 문서화된 여기에 Java 11에 대한 올바른 설정으로 maven-toolchain-plugin을 추가합니다. 예를 들어 샘플 프로젝트 코드를 참조하십시오.

  • 아래 오류가 발생하면 maven-scr-plugin 사용을 제거하고 모든 OSGi 주석을 OSGi R6 주석으로 변환해야 합니다. 자세한 내용은 여기를 참조하십시오.

    [main] [ERROR] Failed to execute goal org.apache.felix:maven-scr-plugin:1.26.4:scr (generate-scr-scrdescriptor) on project helloworld.core: /build_root/build/testsite/src/main/java/com/adobe/HelloWorldServiceImpl.java : Unable to load compiled class: com.adobe.HelloWorldServiceImpl: com/adobe/HelloWorldServiceImpl has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0 -> [Help 1]

  • Cloud Manager 빌드의 경우, 마비성 enforcer 플러그인이 오류 "[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion" 때문에 실패합니다. 코드 컴파일 외에 maven 명령을 실행하기 위해 다른 버전의 Java를 사용하는 클라우드 관리자로 인해 알려진 문제입니다. 이제 maven-enforcer-plugin 구성에서 requireJavaVersion을(를) 생략합니다.

코드 품질 검사가 실패하여 배포가 중단됩니다. 이 수표를 우회할 방법이 있습니까?

보안 등급​을 제외한 모든 코드 품질 오류는 중요하지 않은 지표이므로 결과 UI에서 항목을 확장하여 무시할 수 있습니다.

배포 관리자, 프로젝트 관리자 또는 비즈니스 소유자 역할을 가진 사용자는 파이프라인이 진행되거나 문제가 수락될 수 있는 문제를 무시할 수 있습니다. 이 경우 파이프라인이 실패로 중단됩니다. 자세한 내용은 파이프라인 실행 중 3계층 게이츠를 참조하십시오.

Maven 프로젝트 버전에서 SNAPSHOT을 사용할 수 있습니까? 스테이지 및 프로덕션 배포에서 패키지 및 번들 jar 파일의 버전 관리가 어떻게 작동합니까?

스테이지 및 프로덕션 배포에 대한 패키지 및 번들 jar 파일의 버전 관리에 대해 알아보려면 다음 시나리오를 참조하십시오.

  1. 개발자 배포의 경우 Git 분기 pom.xml 파일은 <version> 값의 끝에 -SNAPSHOT을(를) 포함해야 합니다. 따라서 버전이 변경되지 않고 계속 설치되도록 후속 배포가 가능합니다. 개발자 배포에서는 maven 빌드에 대해 자동 버전이 추가되거나 생성되지 않습니다.

  2. 스테이지 및 프로덕션 배포에서는 자동 버전이 문서화된 여기로 생성됩니다.

  3. 스테이지 및 프로덕션 배포에서 사용자 정의 버전 매기기를 사용하려면 1.0.0과 같은 3개 부분 적합한 마스터 버전을 설정하십시오. 다른 제작 배포 작업을 수행할 때마다 버전을 늘립니다.

  4. Cloud Manager는 해당 버전을 스테이지 및 프로덕션 빌드에 자동으로 추가하고 Git 분기까지 만듭니다. 특별한 구성이 필요하지 않습니다. 위의 3단계를 건너뛸 경우 배포는 여전히 정상적으로 작동하며 버전은 자동으로 설정됩니다.

  5. 스테이지 및 프로덕션 빌드 또는 배포에 대해 -SNAPSHOT으로 버전을 유지하는 경우에는 문제가 없습니다. Cloud Manager는 적합한 버전 번호를 자동으로 설정하고 Git에서 자동으로 태그를 만듭니다. 필요한 경우 이 태그를 나중에 참조할 수 있습니다.

  6. 개발 환경에서 몇 가지 실험적인 코드를 시도하려는 경우 새 Git 분기를 만들고 이 다른 분기를 사용하도록 파이프라인을 설정할 수 있습니다. 이 기능은 배포가 실패할 때 이전 버전의 코드를 테스트하여 언제 중단했는지 확인할 때 유용합니다.

    아래의 Git 명령은 기존 특정 커밋 485548e4fbafbc83b11c3cb12b035c9d26b6532b에 대해 testbranch1​이라는 이름의 원격 분기를 만듭니다. 이 특수 분기는 다른 분기에는 영향을 주지 않고 Cloud Manager에서 사용할 수 있습니다.

    git push origin 485548e4fbafbc83b11c3cb12b035c9d26b6532b:refs/heads/testbranch1

    자세한 내용은 Git 설명서를 참조하십시오.

    나중에 테스트 분기를 삭제하려면 삭제 명령을 사용합니다.

    git push origin --delete testbranch1

Cloud Manager에서 전문적인 빌드가 배포되지 않지만 오류 없이 로컬에 빌드됩니다. 디버깅하는 방법

자세한 내용은 Git 리소스를 참조하십시오.

AEM의 배포 단계에서 Cloud Service 환경으로 Cloud Manager 배포가 실패하는 경우 어떻게 해야 합니까?

배포가 실패하는 가장 일반적인 이유는 sling-distribution-importer 사용자에 대한 권한이 부족하기 때문입니다.
문제, 원인 및 솔루션을 이해하려면 아래 예를 참조하십시오.

문제
Cloud Service 환경으로 Cloud Manager를 AEM에 배포하는 동안 배포 단계가 실패하고 아래 오류와 같은 오류가 관찰됩니다.

[Queue Processor for Subscriber agent forwardPublisherSubscriber] org.apache.jackrabbit.vault.fs.io.Importer Error while committing changes. Retrying import from checkpoint at /. Retries 4/10
[Queue Processor for Subscriber agent forwardPublisherSubscriber] org.apache.sling.distribution.journal.impl.subscriber DistributionSubscriber Error processing queue item
org.apache.sling.distribution.common.DistributionException: Error processing distribution package
dstrpck-1583514457813-c81e7751-2da6-4d00-9814-434187f08d32. Retry attempts 162/infinite.
Caused by: org.apache.sling.api.resource.PersistenceException: Unable to commit changes to session.
Caused by: javax.jcr.AccessDeniedException: OakAccess0000: Access denied [EventAdminAsyncThread #7] org.apache.sling.distribution.journal.impl.publisher.DistributionPublisher [null] Error processing distribution package dstrpck-1583514457813-c81e7751-2da6-4d00-9814-434187f08d32. Retry attempts 344/infinite. Message: Error trying to extract package at path /etc/packages/com.myapp/myapp-base.ui.content-5.1.0-SNAPSHOT.

원인

sling-distribution-importer 사용자는 ui.content 패키지에 정의된 컨텐츠 경로에 따라 추가 권한이 필요합니다. 이는 일반적으로 /conf 및 /var 모두에 대한 권한을 추가해야 함을 의미합니다.

해결책
이 해결책은 RepositoryInitializer OSGi 구성 스크립트를 앱 배포 패키지에 추가하여 sling-distribution-importer 사용자에 대한 ACL을 추가하는 것입니다.
위의 예제 오류에서 패키지 myapp-base.ui.content-*.zip은 /conf/var/workflow 아래의 콘텐트를 포함합니다. 배포가 실패하지 않도록 이러한 경로 아래에 sling-distribution-importer에 대한 권한을 추가해야 합니다.
다음은 sling-distribution-importer 사용자에 대한 추가 권한을 추가하는 이러한 OSGi 구성 중 하나의 예 org.apache.sling.jcr.repoinit.RepositoryInitializer-DistributionService.config입니다. 이 구성은 /var 아래에 권한을 추가합니다. [1] 아래의 이 xml 파일을 /apps/myapp/config 아래의 응용 프로그램 패키지에 추가해야 합니다. 여기서 myapp은 응용 프로그램 코드가 저장되는 폴더입니다.
org.apache.sling.jcr.repoinit.RepositoryInitializer-DistributionService.config

  1. sling-distribution-importer​의 원인이 아닌 경우 기본 서비스를 벗어나는 잘못된 OSGi 구성으로 인해 배포가 실패할 수 있습니다. 배포하는 동안 로그를 확인하여 명백한 오류가 있는지 확인합니다.

  2. 잘못된 디스패처 또는 Apache 구성으로 인해 배포가 실패할 수 있습니다. SDK에 포함된 Docker 이미지를 사용하여 Apache 구성 및 Dispatcher 구성을 로컬로 테스트하십시오. 간편한 로컬 테스트를 위해 디스패처 Docker 컨테이너를 설정하는 방법은 Cloud🔗Dispatcher의 디스패처를 참조하십시오.

  3. 작성자에서 게시 인스턴스로 콘텐츠 패키지(스링 배포)를 복제하는 동안 몇 가지 다른 오류로 인해 배포가 실패할 수 있습니다.

    로컬 설정에서 이를 시뮬레이션하려면 아래 단계를 참조하십시오.

    • 작성자 및 게시 인스턴스 설치(최신 AEM SDK jar 사용)
    • 작성자 인스턴스에 로그인
    • 도구 -> 배포 -> 배포​로 이동합니다.
    • 코드 베이스에 포함된 컨텐츠 패키지를 배포하고 오류로 인해 큐가 차단되었는지 확인합니다.

aio cloud manager 세트 파이프라인 변수를 통해 변수를 설정할 수 없습니다. 이러한 문제를 디버깅하는 방법?

아래 명령과 유사한 명령을 통해 파이프라인 변수를 나열하거나 설정할 때 403 오류가 발생하는 경우 Admin Console에서 배포 관리자 클라우드 관리자 제품 역할로 추가해야 합니다.
자세한 내용은 API 권한을 참조하십시오.

관련 명령 및 오류:

$ aio cloudmanager:list-pipeline-variables 222

오류: Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-pipeline-variables 222 --variable TEST 1

오류: Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-environment-variables 1755 --variable TEST 1

setting variables... !

오류: Cannot set variables: https://cloudmanager.adobe.io/api/program/111/environment/222/variables (403 Forbidden)

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now