AEM as a Cloud Service: 일괄 프로그래밍 방식 에셋 업로드에 대한 권장 전략 및 제한 사항 (50,000개 에셋)

이 문서에서는 직접 바이너리 업로드를 사용하여 AEM as a Cloud Service에 일괄 프로그래밍 방식 에셋을 업로드하기 위한 모범 사례, 권장 제한 및 구성에 대한 지침을 제공합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS) (모든 버전)

문제/증상

@adobe/aem-upload Node.js 라이브러리와 함께 직접적인 바이너리 업로드 방법을 사용하여 외부 시스템에서 AEM as a Cloud Service DAM으로 약 50,000개의 자산을 수집해야 합니다.

Asset Compute 서비스를 오버로드하거나 제한을 트리거하지 않도록 하려면 권장 전략, 지원되는 처리량, 일괄 처리 크기, 동시 실행 및 모든 공식 제한에 대한 확인을 구합니다. 아직 오류 메시지가 보고되지 않았지만 프로덕션 수집 전에 접근 방식을 확인해야 합니다.

  • 일괄 업로드 볼륨: 50,000개 에셋
  • 접근 방법: 사전 서명된 URL(@adobe/aem-upload)을 통한 직접적인 바이너리 업로드
  • 배치 패턴: 재시도 논리를 사용한 배치 업로드
  • 배치 크기: 프로덕션 환경에 10~50개 권장
  • 동시성: withMaxConcurrent() 메서드를 사용할 수 있음
  • 인증: 서비스 자격 증명(OAuth S2S / JWT)

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. 다이렉트 이진 업로드 사용

  2. 일괄 처리 크기 및 동시 실행 구성

    • 설명서에 설명된 대로 일괄 업로드 패턴을 사용합니다.

    • 권장 시작 구성:

      • batchSize: 일괄 처리당 20~50개 파일
      • maxConcurrent: 클라이언트 프로세스당 5~8개의 동시 업로드
    • 파일럿 결과와 관찰된 시스템 비헤이비어에 따라 이러한 값을 조정합니다.

  3. 처리량 및 처리 모니터링

    • 업로드 API 자체에 대한 초당 요청 또는 시간당 에셋에 대한 엄격한 제한은 없습니다.
    • 실제 처리량은 네트워크 대역폭 및 클라이언트 동시성으로 제어됩니다.
    • 업로드 후 처리(썸네일, 메타데이터, Dynamic Media 등) 는 Asset Compute microservices에서 처리합니다. 일반적인 처리 속도는 시간당 5,000~9,000개의 자산입니다.
    • 50,000개의 에셋에 대해 표준 조건에서 몇 시간에서 몇 시간 이내에 처리가 완료되어야 합니다.
  4. 파일럿 및 모니터링

    • 1,000~2,000개의 자산으로 파일럿을 실행하여 구성의 유효성을 검사하고 시간 초과, HTTP 413(페이로드가 너무 큼) 또는 HTTP 429(요청이 너무 많음)와 같은 오류를 모니터링합니다.
    • AEM에서 처리 시간 및 *처리 중…*배너를 모니터링합니다.
    • 필요에 따라 일괄 처리 크기 및 동시성을 조정하여 전송률 조절을 트리거하지 않고 처리량을 최적화합니다.
  5. 인증 및 권한

    • 필요한 업로드 권한이 있는 계정과 함께 서비스 자격 증명(OAuth S2S / JWT)을 사용합니다.
  6. 적절하게 업로드 예약

    • 이 볼륨에 대해 특별한 환경 확장이 필요하지 않습니다.
    • 처리 처리량을 최대화하기 위해 사용량이 적은 시간 동안 업로드를 실행하는 것이 좋습니다.

원인

직접적인 바이너리 업로드 접근 방식은 대용량 수집을 위해 설계되었으며 확장성을 위해 클라우드 스토리지 및 마이크로서비스를 활용합니다. 처리량은 주로 업로드 API 자체가 아니라 업로드 후 처리 용량으로 제한됩니다.

recommendation-more-help
experience-cloud-kcs-help-kbarticles