Desenvolvimento de proxy de ativos assets-proxy-development

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

Um proxy é específico (e às vezes separado) Experience Manager que usa trabalhadores proxy como processadores responsáveis por manipular um trabalho e criar um resultado. Um trabalhador proxy pode ser usado para uma grande variedade de tarefas. No caso de um Experience Manager Proxy de ativos que pode ser usado para carregar ativos para renderização no Experience Manager Ativos. Por exemplo, a variável Trabalhador proxy IDS O usa um InDesign Server para processar arquivos para uso em Experience Manager Ativos.

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

Proxy (Acesso HTTP) proxy-http-access

Um proxy está disponível por meio do Servlet HTTP quando está configurado para aceitar tarefas de processamento em: /libs/dam/cloud/proxy. Este servlet cria um trabalho de sling a partir dos parâmetros publicados. Isso é então adicionado à fila de trabalhos de 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

Trabalhador Proxy proxy-worker

Um trabalhador proxy é um processador responsável por manipular uma tarefa e criar um resultado. Os trabalhadores residem na instância proxy e devem implementar sling JobProcessor para ser reconhecido como um trabalhador proxy.

API do cliente client-api

JobService O 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.

Este é um exemplo de uso da API:

@Reference
 JobService proxyJobService;

 // to create a new 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 do Cloud Service cloud-service-configurations

As configurações do proxy e do trabalhador proxy estão disponíveis por meio das configurações dos serviços em nuvem como acessíveis na Experience Manager Ativos Ferramentas ou em /etc/cloudservices/proxy. Espera-se que cada trabalhador proxy adicione um nó em /etc/cloudservices/proxy para detalhes de configuração específicos do trabalhador (por exemplo, /etc/cloudservices/proxy/workername).

Este é 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");

Desenvolvendo um trabalhador proxy personalizado developing-a-customized-proxy-worker

O Trabalhador proxy IDS é um exemplo de um Experience Manager O trabalhador proxy de ativos que já foi fornecido pronto para uso para terceirizar o processamento de ativos do Indesign.

Você também pode desenvolver e configurar seus próprios Experience Manager Trabalhador proxy de ativos para criar um trabalhador especializado para despachar e terceirizar seu Experience Manager Tarefas de processamento de ativos.

Configurar seu próprio trabalho proxy personalizado requer:

O diagrama e as etapas a seguir detalham como proceder: