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
아래 단계에 따라 문제를 해결하십시오.
-
다이렉트 이진 업로드 사용
- 프로그래밍 방식의 에셋 업로드 자습서 및 에셋 업로드 HTTP API 참조를 따르십시오.
- 다이렉트 바이너리 업로드 방식은 파일을 클라우드 스토리지에 직접 업로드하고 AEM JVM의 로드를 최소화하므로 대규모 수집에 권장됩니다.
-
일괄 처리 크기 및 동시 실행 구성
-
설명서에 설명된 대로 일괄 업로드 패턴을 사용합니다.
-
권장 시작 구성:
batchSize: 일괄 처리당 20~50개 파일maxConcurrent: 클라이언트 프로세스당 5~8개의 동시 업로드
-
파일럿 결과와 관찰된 시스템 비헤이비어에 따라 이러한 값을 조정합니다.
-
-
처리량 및 처리 모니터링
- 업로드 API 자체에 대한 초당 요청 또는 시간당 에셋에 대한 엄격한 제한은 없습니다.
- 실제 처리량은 네트워크 대역폭 및 클라이언트 동시성으로 제어됩니다.
- 업로드 후 처리(썸네일, 메타데이터, Dynamic Media 등) 는 Asset Compute microservices에서 처리합니다. 일반적인 처리 속도는 시간당 5,000~9,000개의 자산입니다.
- 50,000개의 에셋에 대해 표준 조건에서 몇 시간에서 몇 시간 이내에 처리가 완료되어야 합니다.
-
파일럿 및 모니터링
- 1,000~2,000개의 자산으로 파일럿을 실행하여 구성의 유효성을 검사하고 시간 초과, HTTP 413(페이로드가 너무 큼) 또는 HTTP 429(요청이 너무 많음)와 같은 오류를 모니터링합니다.
- AEM에서 처리 시간 및 *처리 중…*배너를 모니터링합니다.
- 필요에 따라 일괄 처리 크기 및 동시성을 조정하여 전송률 조절을 트리거하지 않고 처리량을 최적화합니다.
-
인증 및 권한
- 필요한 업로드 권한이 있는 계정과 함께 서비스 자격 증명(OAuth S2S / JWT)을 사용합니다.
-
적절하게 업로드 예약
- 이 볼륨에 대해 특별한 환경 확장이 필요하지 않습니다.
- 처리 처리량을 최대화하기 위해 사용량이 적은 시간 동안 업로드를 실행하는 것이 좋습니다.
원인
직접적인 바이너리 업로드 접근 방식은 대용량 수집을 위해 설계되었으며 확장성을 위해 클라우드 스토리지 및 마이크로서비스를 활용합니다. 처리량은 주로 업로드 API 자체가 아니라 업로드 후 처리 용량으로 제한됩니다.
recommendation-more-help
experience-cloud-kcs-help-kbarticles