Assets desarrollo de proxy assets-proxy-development
Adobe Experience Manager Assets utiliza un proxy para distribuir el procesamiento de determinadas tareas.
Un proxy es una instancia de Experience Manager específica (y a veces independiente) que utiliza los proxies como procesadores responsables de gestionar un trabajo y crear un resultado. Un trabajador proxy puede utilizarse para una amplia variedad de tareas. Si hay un Assets proxy: esto se puede utilizar para cargar recursos para procesarlos en Assets. Por ejemplo, la variable Trabajador proxy IDS utiliza un Adobe InDesign Servidor para procesar archivos para usarlos en Assets.
Cuando el proxy es un servidor independiente Experience Manager Esto ayuda a reducir la carga de la Experience Manager instancia(s) de creación. De forma predeterminada, Assets ejecuta las tareas de procesamiento de recursos en la misma JVM (externalizadas mediante proxy) para reducir la carga en la Experience Manager instancia de creación.
Proxy (acceso HTTP) proxy-http-access
Un proxy está disponible a través del servlet HTTP cuando está configurado para aceptar trabajos de procesamiento en: /libs/dam/cloud/proxy
. Este servlet crea un trabajo de sling a partir de los parámetros registrados. A continuación, se agrega a la cola de trabajos del proxy y se conecta al trabajador del proxy correspondiente.
Operaciones admitidas supported-operations
-
job
Requisitos: el parámetro
jobevent
debe establecerse como un mapa de valores serializados. Se utiliza para crear unEvent
para un procesador de trabajos.Resultado: Añade un nuevo trabajo. Si se realiza correctamente, se devuelve un ID de trabajo único.
curl -u admin:admin -F":operation=job" -F"someproperty=xxxxxxxxxxxx"
-F"jobevent=serialized value map" http://localhost:4502/libs/dam/cloud/proxy
-
result
Requisitos: el parámetro
jobid
debe estar configurado.Resultado: Devuelve una representación JSON del nodo resultante creado por el procesador de trabajos.
curl -u admin:admin -F":operation=result" -F"jobid=xxxxxxxxxxxx"
http://localhost:4502 /libs/dam/cloud/proxy
-
resource
Requisitos: se debe establecer el parámetro jobid.
Resultado: Devuelve un recurso asociado al trabajo determinado.
curl -u admin:admin -F":operation=resource" -F"jobid=xxxxxxxxxxxx"
-F"resourcePath=something.pdf" http://localhost:4502/libs/dam/cloud/proxy
-
remove
Requisitos: se debe establecer el parámetro jobid.
Resultados: elimina un trabajo si se encuentra.
curl -u admin:admin -F":operation=remove" -F"jobid=xxxxxxxxxxxx"
http://localhost:4502/libs/dam/cloud/proxy
Trabajador Proxy proxy-worker
Un trabajador proxy es un procesador responsable de gestionar un trabajo y crear un resultado. Los trabajadores residen en la instancia de proxy y deben implementar sling JobProcessor para que se reconozca como trabajador proxy.
API de cliente client-api
JobService
está disponible como servicio OSGi que proporciona métodos para crear trabajos, eliminar trabajos y obtener resultados de esos trabajos. La implementación predeterminada de este servicio (JobServiceImpl
) utiliza el cliente HTTP para comunicarse con el servlet proxy remoto.
A continuación se muestra un ejemplo de uso de 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);
Configuraciones del Cloud Service cloud-service-configurations
Las configuraciones de trabajo de proxy y proxy están disponibles a través de las configuraciones de los servicios en la nube, como accesibles desde el Assets Herramientas consola o en /etc/cloudservices/proxy
. Se espera que cada trabajador proxy agregue un nodo en /etc/cloudservices/proxy
para detalles de configuración específicos del trabajador (por ejemplo, /etc/cloudservices/proxy/workername
).
A continuación se muestra un ejemplo de uso de 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");
Desarrollo de un trabajador proxy personalizado developing-a-customized-proxy-worker
El Trabajador proxy IDS es un ejemplo de Assets trabajador proxy que ya se proporciona de forma predeterminada para externalizar el procesamiento de recursos de InDesign.
También puede desarrollar y configurar sus propios Assets trabajador proxy para crear un trabajador especializado para distribuir y externalizar su Assets tareas de procesamiento.
La configuración de su propio trabajador de proxy personalizado requiere lo siguiente:
-
Configurar e implementar (con eventos de Sling):
- un tema de trabajo personalizado
- un controlador de eventos de trabajo personalizado
-
A continuación, utilice la API de JobService para:
- enviar el trabajo personalizado al proxy
- administre su trabajo
-
Si desea utilizar el proxy de un flujo de trabajo, debe implementar un paso externo personalizado mediante la API WorkflowExternalProcess y la API JobService.
El siguiente diagrama y pasos detallan cómo proceder:
-
A Trabajo de Sling se utiliza, por lo que debe definir un tema de trabajo para el caso de uso.
Como ejemplo, consulte
IDSJob.IDS_EXTENDSCRIPT_JOB
para el trabajador del proxy IDS. -
El paso externo se utiliza para almacenar en déclencheur el evento y luego esperar hasta que termine; esto se hace sondeando el ID. Desarrolle su propio paso para implementar nuevas funciones.
Implementación de un
WorkflowExternalProcess
A continuación, utilice la API del servicio de trabajos y el tema del trabajo para preparar un evento de trabajo y enviarlo al servicio de trabajos (un servicio OSGi).Como ejemplo, consulte
INDDMediaExtractProcess
.java para el trabajador del proxy IDS. -
Implemente un controlador de trabajo para el tema. Este controlador requiere desarrollo para que realice la acción específica y se considere la implementación de trabajador.
Como ejemplo, consulte
IDSJobProcessor.java
para el trabajador del proxy IDS. -
Utilizar de
ProxyUtil.java
en dam-commons. Esto permite enviar trabajos a los trabajadores mediante el proxy DAM.