AEM(Adobe Experience Manager)은 AEM as a Cloud Service SDK의 QuickStart Jar로 사용하여 로컬에서 실행할 수 있습니다. 이 경우 개발자는 소스 제어에 커밋하기 전에 사용자 정의 코드, 구성 및 콘텐츠를 배포하고 테스트하고, AEM as a Cloud Service 환경으로 배포할 수 있습니다.
참고: ~
는 사용자 디렉토리의 축약으로 사용됩니다. Windows에서 이는 %HOMEPATH%
.
Experience Manager은 Java 애플리케이션이므로 개발 도구를 지원하려면 Java SDK가 필요합니다.
java -version
java --version
AEM as a Cloud Service SDK 또는 AEM SDK에는 호환 가능한 버전의 Dispatcher 도구뿐만 아니라 개발을 위해 로컬에서 AEM 작성자 및 게시를 실행하는 데 사용되는 Quickstart Jar가 포함되어 있습니다.
aem-sdk-XXX.zip
파일로컬 AEM Author Service는 개발자에게 콘텐츠를 만들고 관리하기 위해 공유할 로컬 경험 디지털 마케터/콘텐츠 작성자를 제공합니다. AEM Author Service는 작성 및 미리보기 환경으로 설계되어 기능 개발에 대한 대부분의 유효성 검사를 수행할 수 있으므로 로컬 개발 프로세스의 중요한 요소입니다.
폴더 만들기 ~/aem-sdk/author
다음을 복사합니다. Quickstart JAR 파일 위치: ~/aem-sdk/author
이름을 로 바꿉니다. aem-author-p4502.jar
명령줄에서 다음을 실행하여 로컬 AEM 작성자 서비스를 시작합니다.
java -jar aem-author-p4502.jar
admin
. 모든 관리자 암호는 사용할 수 있지만, 재구성의 필요성을 줄이기 위해 로컬 개발에 기본값을 사용하는 것이 좋습니다.본인 할 수 없음 Cloud Service Quickstart Jar로 AEM 시작 두 번 클릭하여.
다음 위치에서 로컬 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 Publish 서비스는 AEM의 최종 사용자가 AEM에서 호스팅하는 웹 사이트를 검색하는 것과 같은 로컬 경험을 개발자에게 제공합니다. 로컬 AEM 게시 서비스는 AEM SDK의 Dispatcher 도구 또한 개발자는 최종 사용자 대면 경험을 연기 테스트하고 미세 조정할 수 있습니다.
폴더 만들기 ~/aem-sdk/publish
다음을 복사합니다. Quickstart JAR 파일 위치: ~/aem-sdk/publish
이름을 로 바꿉니다. aem-publish-p4503.jar
명령줄에서 다음을 실행하여 로컬 AEM 게시 서비스를 시작합니다.
java -jar aem-publish-p4503.jar
admin
. 모든 관리자 암호는 사용할 수 있지만, 재구성의 필요성을 줄이기 위해 로컬 개발에 기본값을 사용하는 것이 좋습니다.본인 할 수 없음 Cloud Service Quickstart Jar로 AEM 시작 두 번 클릭하여.
에서 로컬 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 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 서비스를 사용하여 콘텐츠 배포를 시뮬레이션하는 것이 바람직할 수 있습니다. 이 작업은 기존 복제 에이전트를 활성화하여 수행할 수 있습니다.
복제 에이전트는 로컬 Quickstart JAR에서만 사용할 수 있으며 컨텐츠 배포 시뮬레이션만 제공합니다.
에 로그인 작성자 서비스 및 다음으로 이동 http://localhost:4502/etc/replication/agents.author.html.
클릭 기본 에이전트(게시) 기본 복제 에이전트를 엽니다.
클릭 편집 에이전트 구성을 엽니다.
아래 설정 탭에서 다음 필드를 업데이트합니다.
아래 전송 탭에서 다음 필드를 업데이트합니다.
http://localhost:4503/bin/receive?sling:authRequestLogin=1
admin
admin
클릭 확인 구성을 저장하고 기본값 복제 에이전트.
이제 Author 서비스의 콘텐츠를 변경하고 Publish 서비스에 게시할 수 있습니다.
Quickstart Jar 이름 지정 aem-<tier>_<environment>-p<port number>.jar
시작 방법을 지정합니다. AEM이 특정 계층, 작성자 또는 게시에서 시작되면 대체 계층으로 변경할 수 없습니다. 이렇게 하려면 crx-Quickstart
첫 번째 실행 중에 생성된 폴더를 삭제하고 Quickstart Jar를 다시 실행해야 합니다. 환경 및 포트는 변경할 수 있지만 로컬 AEM 인스턴스의 중지/시작이 필요합니다.
변화하는 환경, dev
, stage
및 prod
는 AEM에서 환경별 구성을 올바르게 정의하고 확인하도록 개발자에게 유용할 수 있습니다. 로컬 개발은 기본적으로 수행되는 것이 좋습니다 dev
환경 실행 모드.
사용 가능한 순열은 다음과 같습니다.
Jar 파일 이름 빠른 시작 | 모드 설명 |
---|---|
aem-author-p4502.jar |
포트 4502에서 개발 실행 모드의 작성자 |
aem-author_dev-p4502.jar |
포트 4502의 개발 실행 모드에서 작성자로(와 동일) aem-author-p4502.jar ) |
aem-author_stage-p4502.jar |
포트 4502에서 스테이징 실행 모드의 작성자로 |
aem-author_prod-p4502.jar |
포트 4502에서 프로덕션 실행 모드의 작성자로 |
aem-publish-p4503.jar |
포트 4503의 개발 실행 모드에서 게시로 |
aem-publish_dev-p4503.jar |
포트 4503의 개발 실행 모드에서 게시로(와 동일) aem-publish-p4503.jar ) |
aem-publish_stage-p4503.jar |
포트 4503의 스테이징 실행 모드에서 게시로 |
aem-publish_prod-p4503.jar |
포트 4503에서 프로덕션 실행 모드로 게시로 |
포트 번호는 로컬 개발 시스템에서 사용 가능한 모든 포트일 수 있지만, 규칙에 따라 다릅니다.
이를 변경하려면 AEM SDK 구성을 조정해야 할 수 있습니다
로컬 AEM 런타임을 중지하려면 AEM Author 또는 Publish 서비스를 선택하고 AEM 런타임을 시작하는 데 사용된 명령줄 창을 연 다음 을 누릅니다 Ctrl-C
. AEM이 종료될 때까지 기다립니다. 종료 프로세스가 완료되면 명령줄 프롬프트를 사용할 수 있습니다.
매월 마지막 목요일(AEM as a Cloud Service "기능 릴리스"의 릴리스 케이던스)에 대해 적어도 매월 또는 그 직후에 AEM SDK를 업데이트합니다.
Quickstart Jar를 새 버전으로 업데이트하려면 전체 로컬 개발 환경을 교체해야 하므로 로컬 AEM 저장소의 모든 코드, 구성 및 콘텐츠가 손실됩니다. 폐기해서는 안 되는 코드, 구성 또는 콘텐츠가 Git에 안전하게 커밋되거나 로컬 AEM 인스턴스에서 AEM 패키지로 내보내지는지 확인합니다.
AEM SDK를 업그레이드하면 새 저장소를 포함하여 완전히 새로운 AEM 런타임이 생성됩니다. 즉, 이전 AEM SDK의 저장소에 대한 변경 사항이 모두 손실됩니다. 다음은 AEM SDK 업그레이드 사이에서 콘텐츠를 지속하는 데 도움이 되는 실행 가능한 전략이며, 개별적으로 또는 함께 사용할 수 있습니다.
includepaths
지시문을 사용하여 이전 AEM SDK 저장소의 콘텐츠를 새 AEM SDK 저장소로 복사합니다.위의 접근 방식을 사용하여 AEM SDK 업그레이드 사이에 코드를 유지 관리하면 개발 방지 패턴이 표시된다는 점을 기억하십시오. 일회용 코드가 아닌 코드는 개발 IDE에서 가져와서 배포를 통해 AEM SDK로 이동해야 합니다.
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를 시작하면 프로세스가 즉시 중단되고 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가 설치되면 명령줄에서 명령을 실행하여 활성 버전인지 확인합니다.
java -version
java --version