Assets sviluppo proxy assets-proxy-development

Adobe Experience Manager Assets utilizza un proxy per distribuire l'elaborazione per determinate attività.

Un proxy è un'istanza di Experience Manager specifica (e talvolta separata) che utilizza i lavoratori proxy come processori responsabili della gestione di un processo e della creazione di un risultato. Un processo di lavoro proxy può essere utilizzato per un'ampia gamma di attività. Se è presente un proxy Assets, può essere utilizzato per caricare le risorse per il rendering in Assets. Il processo di lavoro proxy IDS utilizza ad esempio un server Adobe InDesign per elaborare i file da utilizzare in Assets.

Quando il proxy è un'istanza Experience Manager separata, ciò consente di ridurre il carico sulle istanze di authoring Experience Manager. Per impostazione predefinita, Assets esegue le attività di elaborazione delle risorse nella stessa JVM (esternalizzata tramite Proxy) per ridurre il carico sull'istanza di authoring Experience Manager.

Proxy (accesso HTTP) proxy-http-access

Un proxy è disponibile tramite HTTP Servlet quando è configurato per accettare processi di elaborazione in: /libs/dam/cloud/proxy. Questo servlet crea un processo sling dai parametri inviati. Questa viene quindi aggiunta alla coda del processo proxy e connessa al processo di lavoro proxy appropriato.

Operazioni supportate 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

Processo di lavoro proxy proxy-worker

Un proxy worker è un processore responsabile della gestione di un processo e della creazione di un risultato. I processi di lavoro risiedono nell'istanza proxy e devono implementare sling JobProcessor per essere riconosciuti come processi di lavoro proxy.

API client client-api

JobService è disponibile come servizio OSGi che fornisce metodi per creare processi, rimuovere processi e ottenere risultati da tali processi. L'implementazione predefinita di questo servizio (JobServiceImpl) utilizza il client HTTP per comunicare con il servlet proxy remoto.

Di seguito è riportato un esempio di utilizzo dell’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);

Configurazioni Cloud Service cloud-service-configurations

Le configurazioni di lavoro proxy e proxy sono disponibili tramite le configurazioni dei servizi cloud accessibili dalla console Assets Strumenti o in /etc/cloudservices/proxy. Ogni processo di lavoro proxy deve aggiungere un nodo in /etc/cloudservices/proxy per i dettagli di configurazione specifici del processo (ad esempio, /etc/cloudservices/proxy/workername).

Di seguito è riportato un esempio di utilizzo dell’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");

Sviluppo di un processo di lavoro proxy personalizzato developing-a-customized-proxy-worker

Il processo di lavoro proxy IDS è un esempio di un processo di lavoro proxy Assets già preconfigurato per esternalizzare l'elaborazione delle risorse InDesign.

È inoltre possibile sviluppare e configurare il proprio processo di lavoro proxy Assets per creare un processo di lavoro specializzato per l'invio e l'esternalizzazione delle attività di elaborazione Assets.

Per configurare un processo di lavoro proxy personalizzato è necessario:

Il diagramma e i passaggi seguenti descrivono in dettaglio come procedere: