Assets 프록시 개발 assets-proxy-development

Adobe Experience Manager Assets은(는) 프록시를 사용하여 특정 작업에 대한 처리를 배포합니다.

프록시는 프록시 작업자를 작업 처리 및 결과 생성을 담당하는 처리자로 사용하는 특정(및 경우에 따라 별도의) Experience Manager 인스턴스입니다. 프록시 작업자는 매우 다양한 작업에 사용할 수 있습니다. Assets 프록시가 있는 경우 Assets 내에서 렌더링할 자산을 로드하는 데 사용할 수 있습니다. 예를 들어 IDS 프록시 작업자는 Adobe InDesign 서버를 사용하여 Assets에서 사용할 파일을 처리합니다.

프록시가 별도의 Experience Manager 인스턴스인 경우 Experience Manager 작성 인스턴스의 로드를 줄이는 데 도움이 됩니다. 기본적으로 Assets은(는) 동일한 JVM(프록시를 통해 외부화됨)에서 자산 처리 작업을 실행하여 Experience Manager 작성 인스턴스의 로드를 줄입니다.

프록시(HTTP 액세스) proxy-http-access

프록시는 /libs/dam/cloud/proxy에서 처리 작업을 수락하도록 구성된 경우 HTTP 서블릿을 통해 사용할 수 있습니다. 이 서블릿은 게시된 매개 변수에서 슬링 작업을 만듭니다. 그런 다음 프록시 작업 대기열에 추가되고 해당 프록시 작업자에 연결됩니다.

지원되는 작업 supported-operations

curl -u admin:admin -F":operation=job" -F"someproperty=xxxxxxxxxxxx"
    -F"jobevent=serialized value map" http://localhost:4502/libs/dam/cloud/proxy

curl -u admin:admin -F":operation=result" -F"jobid=xxxxxxxxxxxx"
    http://localhost:4502   /libs/dam/cloud/proxy

curl -u admin:admin -F":operation=resource" -F"jobid=xxxxxxxxxxxx"
    -F"resourcePath=something.pdf" http://localhost:4502/libs/dam/cloud/proxy

curl -u admin:admin -F":operation=remove" -F"jobid=xxxxxxxxxxxx"
    http://localhost:4502/libs/dam/cloud/proxy

프록시 작업자 proxy-worker

프록시 작업자는 작업을 처리하고 결과를 만드는 역할을 담당하는 프로세서입니다. 작업자는 프록시 인스턴스에 상주하며 프록시 작업자로 인식하려면 sling JobProcessor을(를) 구현해야 합니다.

클라이언트 API client-api

JobService은(는) 작업을 만들고 작업을 제거하고 해당 작업에서 결과를 가져오는 메서드를 제공하는 OSGi 서비스로 사용할 수 있습니다. 이 서비스의 기본 구현(JobServiceImpl)은 HTTP 클라이언트를 사용하여 원격 프록시 서블릿과 통신합니다.

다음은 API 사용의 예입니다.

@Reference
 JobService proxyJobService;

 // to create a job
 final Hashtable props = new Hashtable();
 props.put("someproperty", "some value");
 props.put(JobUtil.PROPERTY_JOB_TOPIC, "myworker/job"); // this is an identifier of the worker
 final String jobId = proxyJobService.addJob(props, new Asset[]{asset});

 // to check status (returns JobService.STATUS_FINISHED or JobService.STATUS_INPROGRESS)
 int status = proxyJobService.getStatus(jobId)

 // to get the result
 final String jsonString = proxyJobService.getResult(jobId);

 // to remove job and cleanup
 proxyJobService.removeJob(jobId);

Cloud Service 구성 cloud-service-configurations

프록시 및 프록시 작업자 구성은 모두 클라우드 서비스 구성을 통해 Assets 도구 콘솔 또는 /etc/cloudservices/proxy에서 액세스할 수 있습니다. 각 프록시 작업자는 작업자별 구성 세부 정보(예: /etc/cloudservices/proxy/workername)에 대해 /etc/cloudservices/proxy 아래에 노드를 추가해야 합니다.

다음은 API 사용의 예입니다.

@Reference(policy = ReferencePolicy.STATIC)
 ProxyConfig proxyConfig;

 // to get proxy config
 Configuration cloudConfig = proxyConfig.getConfiguration();
 final String value = cloudConfig.get("someProperty", "defaultValue");

 // to get worker config
 Configuration cloudConfig = proxyConfig.getConfiguration("workername");
 final String value = cloudConfig.get("someProperty", "defaultValue");

사용자 지정된 프록시 작업자 개발 developing-a-customized-proxy-worker

IDS 프록시 작업자은(는) InDesign 에셋 처리를 아웃소싱하기 위해 기본적으로 이미 제공되는 Assets 프록시 작업자의 예입니다.

또한 고유한 Assets 프록시 작업자를 개발 및 구성하여 Assets 처리 작업을 발송하고 아웃소싱할 전문 작업자를 만들 수도 있습니다.

사용자 정의 프록시 작업자를 설정하려면 다음을 수행해야 합니다.

다음 다이어그램과 단계는 진행 방법에 대해 자세히 설명합니다.