Desenvolvimento de proxy Assets assets-proxy-development

Adobe Experience Manager Assets usa um proxy para distribuir o processamento de determinadas tarefas.

Um proxy é uma instância de Experience Manager específica (e às vezes separada) que usa trabalhadores proxy como processadores responsáveis por lidar com um trabalho e criar um resultado. Um trabalhador proxy pode ser usado para uma grande variedade de tarefas. Se houver um proxy Assets, ele poderá ser usado para carregar ativos para renderização no Assets. Por exemplo, o trabalhador de proxy de IDS usa um Servidor Adobe InDesign para processar arquivos para uso no Assets.

Quando o proxy é uma instância Experience Manager separada, isso ajuda a reduzir a carga na(s) instância(s) de criação Experience Manager. Por padrão, o Assets executa as tarefas de processamento de ativos na mesma JVM (externalizada via Proxy) para reduzir a carga na instância de criação Experience Manager.

Proxy (Acesso HTTP) proxy-http-access

Um proxy está disponível por meio do Servlet HTTP quando configurado para aceitar trabalhos de processamento em: /libs/dam/cloud/proxy. Este servlet cria um trabalho sling a partir dos parâmetros publicados. Ele é adicionado à fila de trabalhos do proxy e conectado ao trabalhador proxy apropriado.

Operações suportadas 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

Worker do proxy proxy-worker

Um trabalhador proxy é um processador responsável por gerenciar um trabalho e criar um resultado. Os trabalhadores residem na instância proxy e devem implementar o sling JobProcessor para serem reconhecidos como um trabalhador proxy.

API do cliente client-api

JobService está disponível como um serviço OSGi que fornece métodos para criar trabalhos, remover trabalhos e obter resultados desses trabalhos. A implementação padrão deste serviço (JobServiceImpl) usa o cliente HTTP para se comunicar com o servlet proxy remoto.

Veja a seguir um exemplo de uso da 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);

configurações de Cloud Service cloud-service-configurations

As configurações de proxy e de trabalho de proxy estão disponíveis por meio das configurações de serviços em nuvem, conforme acessível no console Assets Ferramentas ou em /etc/cloudservices/proxy. Espera-se que cada trabalhador proxy adicione um nó sob /etc/cloudservices/proxy para obter detalhes de configuração específicos do trabalhador (por exemplo, /etc/cloudservices/proxy/workername).

Veja a seguir um exemplo de uso da 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");

Desenvolvimento de um Worker de proxy personalizado developing-a-customized-proxy-worker

O trabalhador de proxy de IDS é um exemplo de um trabalhador de proxy Assets que já foi fornecido pronto para uso para terceirizar o processamento de ativos de InDesign.

Você também pode desenvolver e configurar seu próprio Assets proxy worker para criar um worker especializado para despachar e terceirizar suas tarefas de processamento de Assets.

Para configurar seu próprio trabalhador proxy personalizado, é necessário:

O diagrama e as etapas a seguir detalham como proceder: