로컬 AEM 런타임 설정

AEM(Adobe Experience Manager)은 AEM as a Cloud Service SDK의 QuickStart Jar로 사용하여 로컬에서 실행할 수 있습니다. 이 경우 개발자는 소스 제어에 커밋하기 전에 사용자 정의 코드, 구성 및 콘텐츠를 배포하고 테스트하고, AEM as a Cloud Service 환경으로 배포할 수 있습니다.

참고: ~ 는 사용자 디렉토리의 축약으로 사용됩니다. Windows에서 이는 %HOMEPATH%.

Java 설치

Experience Manager은 Java 애플리케이션이므로 개발 도구를 지원하려면 Java SDK가 필요합니다.

1. 최신 Java SDK 11 다운로드 및 설치
2. 다음 명령을 실행하여 Java 11 SDK가 설치되어 있는지 확인합니다.
   • Windows:java -version
   • macOS / Linux: java --version

AEM as a Cloud Service SDK 다운로드

AEM as a Cloud Service SDK 또는 AEM SDK에는 호환 가능한 버전의 Dispatcher 도구뿐만 아니라 개발을 위해 로컬에서 AEM 작성자 및 게시를 실행하는 데 사용되는 Quickstart Jar가 포함되어 있습니다.

1. 에 로그인 https://experience.adobe.com/#/downloads Adobe ID 사용
   • Adobe 조직 참고 필수 AEM as a Cloud Service SDK를 다운로드하도록 AEM as a Cloud Service에 대해 프로비저닝합니다.
2. 다음 위치로 이동 AEM as a Cloud Service 탭
3. 정렬 기준: 게시한 날짜 위치: 내림차순 주문
4. 최신 항목을 클릭합니다. AEM SDK 결과 행
5. EULA를 검토하고 수락한 다음 다운로드 단추

AEM SDK zip에서 Quickstart Jar 추출

1. 다운로드한 파일 압축 풀기 aem-sdk-XXX.zip 파일

로컬 AEM 작성자 서비스 설정

로컬 AEM Author Service는 개발자에게 콘텐츠를 만들고 관리하기 위해 공유할 로컬 경험 디지털 마케터/콘텐츠 작성자를 제공합니다. AEM Author Service는 작성 및 미리보기 환경으로 설계되어 기능 개발에 대한 대부분의 유효성 검사를 수행할 수 있으므로 로컬 개발 프로세스의 중요한 요소입니다.

1. 폴더 만들기 ~/aem-sdk/author

2. 다음을 복사합니다. Quickstart JAR 파일 위치: ~/aem-sdk/author 이름을 로 바꿉니다. aem-author-p4502.jar

3. 명령줄에서 다음을 실행하여 로컬 AEM 작성자 서비스를 시작합니다.

   • java -jar aem-author-p4502.jar
     • 관리자 암호 입력 admin. 모든 관리자 암호는 사용할 수 있지만, 재구성의 필요성을 줄이기 위해 로컬 개발에 기본값을 사용하는 것이 좋습니다.

   본인 할 수 없음 Cloud Service Quickstart Jar로 AEM 시작 두 번 클릭하여.

4. 다음 위치에서 로컬 AEM 작성자 서비스에 액세스합니다. http://localhost:4502 웹 브라우저에서

Windows:

$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar

macOS / Linux:

$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

로컬 AEM 게시 서비스 설정

로컬 AEM Publish 서비스는 AEM의 최종 사용자가 AEM에서 호스팅하는 웹 사이트를 검색하는 것과 같은 로컬 경험을 개발자에게 제공합니다. 로컬 AEM 게시 서비스는 AEM SDK의 Dispatcher 도구 또한 개발자는 최종 사용자 대면 경험을 연기 테스트하고 미세 조정할 수 있습니다.

1. 폴더 만들기 ~/aem-sdk/publish

2. 다음을 복사합니다. Quickstart JAR 파일 위치: ~/aem-sdk/publish 이름을 로 바꿉니다. aem-publish-p4503.jar

3. 명령줄에서 다음을 실행하여 로컬 AEM 게시 서비스를 시작합니다.

   • java -jar aem-publish-p4503.jar
     • 관리자 암호 입력 admin. 모든 관리자 암호는 사용할 수 있지만, 재구성의 필요성을 줄이기 위해 로컬 개발에 기본값을 사용하는 것이 좋습니다.

   본인 할 수 없음 Cloud Service Quickstart Jar로 AEM 시작 두 번 클릭하여.

4. 에서 로컬 AEM 게시 서비스에 액세스 http://localhost:4503 웹 브라우저에서

Windows:

$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar

macOS / Linux:

$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

프리릴리스 모드에서 로컬 AEM 서비스 설정

로컬 AEM 런타임은에서 시작할 수 있습니다. 프리릴리스 모드 개발자가 AEM as a Cloud Service의 다음 릴리스 기능에 대해 빌드할 수 있도록 허용합니다. 프리릴리스는 다음을 전달하여 활성화됩니다. -r prerelease 로컬 AEM 런타임의 첫 번째 시작 부분에 인수를 추가합니다. 로컬 AEM Author 및 AEM Publish 서비스에서 모두 사용할 수 있습니다.

# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

콘텐츠 배포 시뮬레이션

실제 Cloud Service 환경에서는 를 사용하여 Author 서비스에서 Publish 서비스로 콘텐츠가 배포됩니다. Sling 콘텐츠 배포 및 Adobe 파이프라인입니다. 다음 Adobe 파이프라인 는 클라우드 환경에서만 사용할 수 있는 격리된 마이크로서비스입니다.

개발 중에 로컬 Author 및 Publish 서비스를 사용하여 콘텐츠 배포를 시뮬레이션하는 것이 바람직할 수 있습니다. 이 작업은 기존 복제 에이전트를 활성화하여 수행할 수 있습니다.

1. 에 로그인 작성자 서비스 및 다음으로 이동 http://localhost:4502/etc/replication/agents.author.html.

2. 클릭 기본 에이전트(게시) 기본 복제 에이전트를 엽니다.

3. 클릭 편집 에이전트 구성을 엽니다.

4. 아래 설정 탭에서 다음 필드를 업데이트합니다.

   • 활성화됨 - true 확인
   • 에이전트 사용자 Id - 이 필드를 비워 둡니다.

   

5. 아래 전송 탭에서 다음 필드를 업데이트합니다.

   • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
   • 사용자 - admin
   • 암호 - admin

   

6. 클릭 확인 구성을 저장하고 기본값 복제 에이전트.

7. 이제 Author 서비스의 콘텐츠를 변경하고 Publish 서비스에 게시할 수 있습니다.

Jar 시작 모드 빠른 시작

Quickstart Jar 이름 지정 aem-<tier>_<environment>-p<port number>.jar 시작 방법을 지정합니다. AEM이 특정 계층, 작성자 또는 게시에서 시작되면 대체 계층으로 변경할 수 없습니다. 이렇게 하려면 crx-Quickstart 첫 번째 실행 중에 생성된 폴더를 삭제하고 Quickstart Jar를 다시 실행해야 합니다. 환경 및 포트는 변경할 수 있지만 로컬 AEM 인스턴스의 중지/시작이 필요합니다.

변화하는 환경, dev, stage 및 prod는 AEM에서 환경별 구성을 올바르게 정의하고 확인하도록 개발자에게 유용할 수 있습니다. 로컬 개발은 기본적으로 수행되는 것이 좋습니다 dev 환경 실행 모드.

사용 가능한 순열은 다음과 같습니다.

포트 번호는 로컬 개발 시스템에서 사용 가능한 모든 포트일 수 있지만, 규칙에 따라 다릅니다.

• 포트 4502 다음에 사용됩니다. 로컬 AEM Author 서비스
• 포트 4503 다음에 사용됩니다. 로컬 AEM 게시 서비스

이를 변경하려면 AEM SDK 구성을 조정해야 할 수 있습니다

로컬 AEM 런타임 중지

로컬 AEM 런타임을 중지하려면 AEM Author 또는 Publish 서비스를 선택하고 AEM 런타임을 시작하는 데 사용된 명령줄 창을 연 다음 을 누릅니다 Ctrl-C. AEM이 종료될 때까지 기다립니다. 종료 프로세스가 완료되면 명령줄 프롬프트를 사용할 수 있습니다.

선택적 로컬 AEM 런타임 설정 작업

• OSGi 구성 환경 변수 및 비밀 변수 은(는) AEM 로컬 런타임에 대해 특별히 설정됨aio CLI를 사용하여 관리하지 않고,

Quickstart Jar 업데이트 시기

매월 마지막 목요일(AEM as a Cloud Service "기능 릴리스"의 릴리스 케이던스)에 대해 적어도 매월 또는 그 직후에 AEM SDK를 업데이트합니다.

AEM SDK를 업그레이드할 때 콘텐츠 손실을 방지하는 방법

AEM SDK를 업그레이드하면 새 저장소를 포함하여 완전히 새로운 AEM 런타임이 생성됩니다. 즉, 이전 AEM SDK의 저장소에 대한 변경 사항이 모두 손실됩니다. 다음은 AEM SDK 업그레이드 사이에서 콘텐츠를 지속하는 데 도움이 되는 실행 가능한 전략이며, 개별적으로 또는 함께 사용할 수 있습니다.

1. 개발에 도움이 되는 "샘플" 콘텐츠를 포함하는 전용 콘텐츠 패키지를 만들고 Git에서 유지 관리합니다. AEM SDK 업그레이드를 통해 유지해야 하는 모든 콘텐츠는 이 패키지로 유지되며 AEM SDK를 업그레이드한 후 다시 배포됩니다.
2. 사용 oak 업그레이드 (으)로 includepaths 지시문을 사용하여 이전 AEM SDK 저장소의 콘텐츠를 새 AEM SDK 저장소로 복사합니다.
3. 이전 AEM SDK의 AEM 패키지 관리자 및 컨텐츠 패키지를 사용하여 컨텐츠를 백업하고 새 AEM SDK에 다시 설치합니다.

위의 접근 방식을 사용하여 AEM SDK 업그레이드 사이에 코드를 유지 관리하면 개발 방지 패턴이 표시된다는 점을 기억하십시오. 일회용 코드가 아닌 코드는 개발 IDE에서 가져와서 배포를 통해 AEM SDK로 이동해야 합니다.

문제 해결

Quickstart Jar 파일을 두 번 클릭하면 오류가 발생합니다

Quickstart Jar를 두 번 클릭하여 시작하면 오류 모달이 표시되어 AEM이 로컬에서 시작되지 않도록 합니다.

이는 AEM as a Cloud Service Quickstart Jar에서 Quickstart Jar를 두 번 클릭하여 AEM을 로컬로 시작할 수 없기 때문입니다. 대신 해당 명령줄에서 Jar 파일을 실행해야 합니다.

AEM 작성자 서비스를 시작하려면 다음을 수행하십시오. cd quickstart Jar가 포함된 디렉토리로 이동한 다음 명령을 실행합니다.

$ java -jar aem-author-p4502.jar

또는 AEM Publish 서비스를 시작하려면 cd quickstart Jar가 포함된 디렉토리로 이동한 다음 명령을 실행합니다.

$ java -jar aem-publish-p4503.jar

명령줄에서 Quickstart Jar를 시작하면 즉시 중단됩니다

명령줄에서 Quickstart Jar를 시작하면 프로세스가 즉시 중단되고 AEM 서비스가 시작되지 않으며 다음 오류가 발생합니다.

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

이는 AEM as a Cloud Service에는 Java SDK 11이 필요하며 다른 버전(Java 8일 가능성이 높음)을 실행 중이기 때문입니다. 이 문제를 해결하려면 을 다운로드하여 설치하십시오. Oracle Java SDK 11.
Java SDK 11이 설치되었으면 명령줄에서 다음을 실행하여 활성 버전인지 확인합니다.

Java 11 SDK가 설치되면 명령줄에서 명령을 실행하여 활성 버전인지 확인합니다.

• Windows: java -version
• macOS / Linux: java --version

추가 리소스

• AEM SDK 다운로드
• Adobe Cloud Manager
• Docker 다운로드
• Experience Manager Dispatcher 설명서

Business.Adobe.com 리소스

Multichannel Communication Targeted Content Asset Collections Content Intelligence Mobile Forms Responsive Forms