Resursproxyutveckling assets-proxy-development

Adobe Experience Manager Assets använder en proxy för att distribuera bearbetningen för vissa uppgifter.

En proxy är en specifik (och ibland separat) Experience Manager -instans som använder proxyarbetare som processorer som hanterar ett jobb och skapar ett resultat. En proxyarbetare kan användas för en mängd olika uppgifter. I fallet med Experience Manager Resursproxy som kan användas för att läsa in resurser för återgivning inom Experience Manager Resurser. Till exempel IDS-proxyarbetare använder en InDesign Server för att bearbeta filer som ska användas i Experience Manager Resurser.

När proxyn är en separat Experience Manager -instans som minskar belastningen på Experience Manager redigeringsinstans(er). Som standard Experience Manager Resurserna kör resurshanteringsuppgifterna i samma JVM (externaliserat via Proxy) för att minska belastningen på Experience Manager -redigeringsinstans.

Proxy (HTTP Access) proxy-http-access

En proxy är tillgänglig via HTTP-servern när den är konfigurerad att acceptera bearbetningsjobb på: /libs/dam/cloud/proxy. Den här servern skapar ett snedjobb av de bokförda parametrarna. Detta läggs sedan till i proxyjobbkön och ansluts till lämplig proxyarbetare.

Åtgärder som stöds 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

Proxyarbetare proxy-worker

En proxyarbetare är en processor som hanterar ett jobb och skapar ett resultat. Arbetarna finns på proxyinstansen och måste implementera sling JobProcessor som ska godkännas som proxyarbetare.

Klient-API client-api

JobService är tillgänglig som en OSGi-tjänst som tillhandahåller metoder för att skapa jobb, ta bort jobb och hämta resultat från dessa jobb. Standardimplementeringen av den här tjänsten (JobServiceImpl) använder HTTP-klienten för att kommunicera med fjärrproxyservern.

Här följer ett exempel på API-användning:

@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);

Cloud Service Configurations cloud-service-configurations

Både proxy- och proxy-arbetskonfigurationer är tillgängliga via molntjänster som är tillgängliga från Experience Manager Resurser verktyg konsol eller under /etc/cloudservices/proxy. Varje proxyarbetare förväntas lägga till en nod under /etc/cloudservices/proxy för arbetarspecifik konfigurationsinformation (till exempel /etc/cloudservices/proxy/workername).

Här följer ett exempel på API-användning:

@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");

Utveckla en anpassad proxyarbetare developing-a-customized-proxy-worker

The IDS-proxyarbetare är ett exempel på en Experience Manager Tilldelar proxyarbetare som redan är färdiga att använda för att lägga ut bearbetningen av InDesign-resurser på entreprenad.

Du kan också utveckla och konfigurera egna Experience Manager Resurser som proxyarbetare kan använda för att skapa en specialiserad arbetare som skickar ut och lägger ut Experience Manager Resurshanteringsuppgifter.

Om du konfigurerar en egen anpassad proxyarbetare måste du:

Följande diagram och steg visar hur du fortsätter: