On-Demand Sandbox 생성

On-Demand Sandbox(ODS)는 개발 및 테스트 목적으로 사용되는 특수한 B2C Commerce 인스턴스입니다. ODS 인스턴스는 임시용으로만, 최대 90일 동안 사용할 수 있습니다.

PWA Kit 스토어프런트 코드에는 카탈로그, 고객, 장바구니 등에 대한 정보 데이터가 포함되지 않습니다. 중요한 커머스 데이터를 얻으려면 헤드리스 API를 사용하여 이커머스 백엔드에 요청해야 합니다.

대부분의 PWA Kit 프로젝트는 스토어프런트 코드를 개발하는 동안 백엔드 역할을 하는 하나 이상의 On-Demand Sandbox로 시작합니다. 소수의 샌드박스를 공유하는 개발 팀도 있고, 다양한 용도로 다수의 샌드박스를 만드는 개발 팀도 있습니다.

Account Manager에서 Sandbox API User 역할이 부여된 사람은 누구나 ODS를 생성할 수 있습니다. 이 역할은 특정 realm으로 범위가 지정되므로 ODS를 생성하려면 4자로 이루어진 realm의 ID를 알아야 합니다. realm ID를 모르면 Account Executive(AE) 또는 Customer Success Manager(CSM)에게 문의하십시오.

또한 Sandbox 생성에 사용할 클라이언트 ID를 알아야 하며, 없는 경우 다른 관리자에게 문의하여 생성해야 합니다. Sandbox 생성 클라이언트 ID를 모를 경우, 팀의 다른 B2C Commerce 관리자에게 공유해줄 것을 요청합니다. (Salesforce 내부 사용자는 이 Concierge 문서에서 고객 ID를 확인할 수 있습니다.)

B2C Commerce Developer Sandbox REST API를 사용하여 On-Demand Sandbox를 생성하려면:

  1. B2C Commerce Developer Sandbox REST API로 이동합니다. (Salesforce 내부 사용자는 다른 URL을 사용해야 합니다.)

  2. Authorize(승인)를 클릭합니다.

  3. Sandbox 생성을 위한 클라이언트 ID를 입력합니다.

  4. Authorize(승인)를 클릭합니다.

  5. Account Manager 자격 증명을 사용하여 로그인합니다.

  6. 승인 창을 닫고 Sandbox API 사용자 인터페이스로 돌아가려면 Close(닫기)를 클릭합니다.

  7. Sandbox API 사용자 인터페이스의 Sandbox 섹션에서 POST/sandboxes 메서드를 클릭해 펼칩니다.

  8. Try it out(실행)을 클릭합니다.

  9. ProvisioningRequest 필드에서 JSON 오브젝트를 삭제합니다.

  10. 다음 JSON 오브젝트를 복사하여 ProvisioningRequest 필드에 붙여 넣습니다.

  11. <your realm id>를 실제 realm ID로 바꿉니다. 예: zzdc.

  12. Sandbox를 24시간 이상 사용하려면 ttl 값을 최대 2,160시간(90일)으로 바꿉니다.

  13. 또한 ttl에 0 이하의 값을 입력하여 삭제할 때까지 Sandbox가 지속되도록 지정할 수 있습니다.

  14. Execute(실행)를 클릭합니다.

  15. ProvisioningRequest JSON이 유효한 경우 서버 응답이 나타납니다.

  16. 나중에 참조할 수 있도록 응답 본문을 복사하거나 Download(다운로드)를 클릭합니다.

다음 섹션에서는 Sandbox의 Business Manager URL이 필요합니다. Business Manager URL은 data.links.bm의 응답 본문 오브젝트에서 찾을 수 있습니다.

Business Manager URL의 예는 다음과 같습니다(realm ID 및 인스턴스 ID에 따라 호스트 이름이 달라짐). https://zzdc-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-Site

On-Demand Sandbox에 대한 자세한 내용은 B2C Commerce Infocenter: On-Demand Sandbox 시작하기에서 확인할 수 있습니다.

보다 자세한 Trailhead 모듈도 참조할 수 있습니다. Salesforce B2C Commerce On-Demand Sandbox

샘플 데이터가 포함된 B2C Commerce 인스턴스로 PWA Kit 프로젝트를 시작하는 것이 좋습니다.

샘플 데이터를 인스턴스로 가져오려면:

  1. 인스턴스의 Business Manager URL로 이동합니다. (방금 ODS를 생성한 경우 Business Manager를 사용할 수 있게 되기까지 10분 정도 걸릴 수 있습니다.)
  2. Account Manager 자격 증명을 사용하여 로그인합니다.
  3. 관리 > 사이트 개발 > 사이트 가져오기 및 내보내기로 이동합니다.
  4. Storefront Reference Architecture 데모 사이트를 선택합니다.
  5. 가져오기를 클릭합니다.
  6. Storefront Reference Architecture 기반을 선택합니다.
  7. 배포를 클릭합니다.
  8. 새로 고침을 클릭하여 배포 진행률을 확인합니다.

배포 프로세스가 완료되면(약 15분) PWA Kit를 사용하여 개발할 때 사용할 수 있는 샘플 데이터가 인스턴스에 포함됩니다.

샘플 데이터 배포를 완료한 후에는 새 데이터가 반영되도록 검색 색인을 다시 빌드합니다.

  1. 인스턴스의 Business Manager URL로 이동합니다.
  2. Account Manager 자격 증명을 사용하여 로그인합니다.
  3. 판매자 도구 > 검색 색인로 이동합니다.
  4. 색인을 모두 선택합니다.
  5. 다시 빌드를 클릭합니다.

새 ODS를 생성한 직후 PWA Kit 스토어프런트에 손상된 카탈로그 이미지가 표시되는 경우 문제가 자체적으로 해결될 때까지 10분 정도 더 기다리십시오.

  • 샘플 데이터가 포함된, 사용 가능한 On-Demand Sandbox가 준비되었으므로 이제 시작하기 시리즈의 다음 가이드를 진행할 수 있습니다. API 액세스 설정