AEM용 AEM Commerce as a Cloud Service 개발

Cloud Service으로 AEM용 CIF(Commerce Integration Framework) 기반의 AEM Commerce Projects를 개발하는 과정에서도 Cloud Service으로 AEM의 다른 AEM 프로젝트와 동일한 규칙 및 우수 사례를 따릅니다. 다음 사항을 먼저 검토하십시오.

AEM as a Cloud Service SDK를 사용한 로컬 개발

CIF 프로젝트에서 작업하려면 로컬 개발 환경을 사용하는 것이 좋습니다. AEM as a Cloud Service에 대해 제공된 CIF 추가 기능 도 로컬 개발에 사용할 수 있습니다. 소프트웨어 배포 포털에서 다운로드할 수 있습니다.

CIF 추가 기능은 Sling 기능 아카이브로 제공됩니다. 소프트웨어 배포 포털에서 사용할 수 있는 zip 파일에는 AEM 작성자 및 AEM 게시 인스턴스용, 이렇게 두 개의 Sling 기능 아카이브 파일이 포함되어 있습니다.

AEM as a Cloud Service을 처음 사용하십니까? AEM as a Cloud Service SDK로 사용하여 로컬 개발 환경을 설정하는 방법에 대한 자세한 안내서를 확인하십시오.

필수 소프트웨어

로컬에 설치해야 합니다.

CIF 추가 기능 액세스

CIF 추가 기능은 소프트웨어 배포 포털에서 zip 파일로 다운로드할 수 있습니다. zip 파일에 Sling 기능 아카이브​로 CIF 추가 기능이 포함되어 있으며 AEM 패키지가 아닙니다. SDK 목록에 대한 액세스는 Cloud Service 라이센스로 AEM이 있는 항목으로 제한됩니다.

항상 최신 CIF 추가 기능 버전을 사용해야 합니다.

로컬 설정

AEM을 Cloud Service SDK로 사용하여 로컬 CIF 추가 기능 개발에 사용할 경우 다음 단계를 수행합니다.

  1. 최신 AEM as a Cloud Service SDK 가져오기

  2. AEM .jar의 압축을 풀고 crx-quickstart 폴더를 만든 다음 실행하십시오.

    java -jar <jar name> -unpack
    
  3. crx-quickstart/install 폴더 만들기

  4. CIF 추가 기능의 올바른 Sling 기능 아카이브 파일을 crx-quickstart/install 폴더에 복사합니다.

    CIF 추가 기능 zip 파일에는 두 개의 Sling 기능 아카이브 .far 파일이 포함되어 있습니다. 로컬 AEM을 Cloud Service SDK로 실행하는 방법에 따라 AEM 작성자 또는 AEM 게시용으로 올바른 SDK를 사용해야 합니다.

  5. Magento GraphQL 종단점을 사용하여 COMMERCE_ENDPOINT이라는 로컬 OS 환경 변수를 만듭니다.

    예 Mac OSX:

    export COMMERCE_ENDPOINT=https://<yourmagentosystem>/graphql
    

    예제 Windows:

    set COMMERCE_ENDPOINT=https://<yourmagentosystem>/graphql
    

    이 변수는 AEM에서 상거래 시스템에 연결하는 데 사용됩니다. 또한, CIF 추가 기능에는 Commerce GraphQL 끝점을 로컬에서 사용할 수 있도록 하는 로컬 역방향 프록시가 포함되어 있습니다. CIF 작성 도구(제품 콘솔 및 선택기)와 직접 GraphQL 호출을 수행하는 CIF 클라이언트측 구성 요소에 사용됩니다.

    이 변수는 AEM as a Cloud Service 환경용으로 설정해야 합니다. 변수에 대한 자세한 내용은 AEM as a Cloud Service에 대한 OSGi 구성 을 참조하십시오.

  6. (선택 사항) 준비된 카탈로그 기능을 활성화하려면 Magento 인스턴스에 대한 통합 토큰을 만들어야 합니다. 시작하기의 단계에 따라 토큰을 만드십시오.

    이름이 COMMERCE_AUTH_HEADER인 OSGi 암호를 다음 값으로 설정합니다.

    Authorization: Bearer <Access Token>
    

    비밀에 대한 자세한 내용은 AEM용 OSGi Cloud Service을 참조하십시오.

  7. AEM as a Cloud Service SDK 시작

노트

환경 변수가 5단계에서 설정되어 있는 경우 동일한 터미널 창에서 AEM을 Cloud Service SDK로 시작해야 합니다. 별도의 터미널 창에서 시작하거나 .jar 파일을 두 번 클릭하여 환경 변수가 표시되는지 확인합니다.

OSGI 콘솔을 통해 설정을 확인합니다. http://localhost:4502/system/console/osgi-installer. 이 목록에는 기능 모델 파일에 정의된 대로 CIF 추가 기능 관련 번들, 컨텐츠 패키지 및 OSGI 구성이 포함되어야 합니다.

프로젝트 설정

AEM용 CIF 프로젝트를 Cloud Service으로 부트스트랩하는 방법에는 두 가지가 있습니다.

AEM 프로젝트 원형 사용

AEM Project Archetype은 CIF를 시작하기 위해 사전 구성된 프로젝트를 부트스트랩하는 기본 도구입니다. CIF 코어 구성 요소 및 모든 필수 구성은 한 개의 추가 옵션을 사용하여 생성된 프로젝트에 포함할 수 있습니다.

AEM Project Archetype 24 이상을 사용하여 프로젝트를 생성합니다.

AEM 프로젝트를 생성하는 방법에 대해서는 AEM 프로젝트 원형 사용 지침 을 참조하십시오. 프로젝트에 CIF를 포함하려면 includeCommerce 옵션을 사용합니다.

예:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

CIF 코어 구성 요소는 제공된 all 패키지를 포함하거나 CIF 컨텐츠 패키지 및 관련 OSGI 번들을 개별적으로 사용하여 모든 프로젝트에서 사용할 수 있습니다. 프로젝트에 CIF 코어 구성 요소를 수동으로 추가하려면 다음 종속성을 사용하십시오.

<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-apps</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-config</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-core</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>graphql-client</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>magento-graphql</artifactId>
    <version>x.y.z</version>
</dependency>

AEM Venia 참조 저장소 사용

CIF 프로젝트를 시작하는 두 번째 옵션은 AEM Venia Reference Store를 복제하고 사용하는 것입니다. AEM Venia Reference Store는 AEM용 CIF 핵심 구성 요소의 사용을 보여 주는 샘플 참조 저장소 응용 프로그램입니다. 모범 사례 세트 및 사용자 고유의 기능을 개발하기 위한 잠재적 시작점으로 사용됩니다.

Venia 참조 스토어를 시작하려면 Git 리포지토리를 복제하고 필요에 따라 프로젝트 사용자 지정을 시작합니다.

노트

Venia Reference Store 프로젝트에는 AEM as a Cloud Service과 AEM 6.5에 대한 두 개의 빌드 프로필이 포함되어 있습니다. 프로젝트 readme.md에서 사용 방법을 확인하십시오.

추가 리소스

이 페이지에서는