설명서 AEM AEM 튜토리얼 AEM as a Cloud Service 튜토리얼

로컬 AEM SDK 설정 set-up-local-aem-sdk

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Developer Tools

작성 대상:

Beginner
Developer

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

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

Java™ 설치

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

최신 Java™ SDK 11 다운로드 및 설치
다음 명령을 실행하여 Oracle Java™ 11 SDK가 설치되어 있는지 확인합니다.

macOS

code language-shell
`$ java --version`

Windows

code language-shell
`$ java -version`

Linux®

code language-shell
`$ java --version`

Java

AEM as a Cloud Service SDK 다운로드

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

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

AEM SDK zip에서 Quickstart Jar 추출

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

로컬 AEM Author 서비스 설정 set-up-local-aem-author-service

로컬 AEM 작성자 서비스는 개발자에게 콘텐츠를 만들고 관리하기 위해 공유할 로컬 경험 디지털 마케터/콘텐츠 작성자를 제공합니다. 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 웹 브라우저에서

macOS

code language-shell
`$ 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`

Windows

code language-shell

code language-shell
`$ 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`

$ 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

Linux®

code language-shell
`$ 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 Publish 서비스는 개발자에게 AEM에 호스팅된 웹 사이트를 검색하는 것과 같이 AEM의 최종 사용자가 갖게 될 로컬 경험을 제공합니다. 로컬 AEM Publish 서비스는 AEM SDK의 Dispatcher 도구 또한 개발자는 최종 사용자 대면 경험을 연기 테스트하고 미세 조정할 수 있습니다.

폴더 만들기 ~/aem-sdk/publish
다음을 복사합니다. Quickstart JAR 파일 위치: ~/aem-sdk/publish 이름을 로 바꿉니다. aem-publish-p4503.jar
명령줄에서 다음을 실행하여 로컬 AEM Publish 서비스를 시작합니다.
- java -jar aem-publish-p4503.jar
  - 관리자 암호 입력 admin. 모든 관리자 암호는 사용할 수 있지만, 로컬 개발에 기본값을 사용하여 재구성할 필요가 없도록 하는 것이 좋습니다.
본인 할 수 없음 Cloud Service Quickstart Jar로 AEM 시작 두 번 클릭하여.
다음 위치에서 로컬 AEM Publish 서비스에 액세스합니다. http://localhost:4503 웹 브라우저에서

macOS

code language-shell
`$ 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`

Windows

code language-shell

code language-shell
`$ 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`

$ 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

Linux®

code language-shell
`$ 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 서비스 모두에서 사용할 수 있습니다.

macOS

code language-shell
`# 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`

Windows

code language-shell
`# 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`

Linux®

code language-shell
`# 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`

콘텐츠 배포 시뮬레이션 content-distribution

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

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

NOTE

복제 에이전트는 로컬 Quickstart JAR에서만 사용할 수 있으며 컨텐츠 배포 시뮬레이션만 제공합니다.

에 로그인 작성자 서비스 및 다음으로 이동 http://localhost:4502/etc/replication/agents.author.html.
클릭 기본 에이전트(게시) 기본 복제 에이전트를 엽니다.
클릭 편집 에이전트 구성을 엽니다.
아래 설정 탭에서 다음 필드를 업데이트합니다.
- 활성화됨 - true 확인
- 에이전트 사용자 Id - 이 필드를 비워 둡니다.
아래 전송 탭에서 다음 필드를 업데이트합니다.
- URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
- 사용자 - admin
- 암호 - admin
클릭 확인 구성을 저장하고 기본값 복제 에이전트.
이제 Author 서비스의 콘텐츠를 변경하고 Publish 서비스에 게시할 수 있습니다.

페이지 게시

Jar 시작 모드 빠른 시작

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에서 프로덕션 실행 모드로 게시로

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

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

이를 변경하려면 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를 업데이트합니다.

WARNING

Quickstart Jar를 새 버전으로 업데이트하려면 전체 로컬 개발 환경을 교체해야 하므로 로컬 AEM 저장소의 모든 코드, 구성 및 콘텐츠가 손실됩니다. 폐기해서는 안 되는 코드, 구성 또는 콘텐츠가 Git에 안전하게 커밋되거나 로컬 AEM 인스턴스에서 AEM 패키지로 내보내지는지 확인합니다.

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

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

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

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

문제 해결

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

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

문제 해결 - Quickstart Jar 파일을 두 번 클릭합니다.

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

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

macOS

code language-shell
`$ java -jar aem-author-p4502.jar`

Windows

code language-shell
`$ java -jar aem-author-p4502.jar`

Linux®

code language-shell
`$ java -jar aem-author-p4502.jar`

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

macOS

code language-shell
`$ java -jar aem-publish-p4503.jar`

Windows

code language-shell
`$ java -jar aem-publish-p4503.jar`

Linux®

code language-shell
`$ java -jar aem-publish-p4503.jar`

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

명령줄에서 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.

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

macOS

code language-shell
`$ java --version`

Windows

code language-shell
`$ java -version`

Linux®

code language-shell
`$ java --version`

추가 리소스

recommendation-more-help

4859a77c-7971-4ac9-8f5c-4260823c6f69