Descarga de trabajos offloading-jobs
Introducción introduction
La descarga distribuye tareas de procesamiento entre instancias de Experience Manager en una topología. Con la descarga, puede utilizar instancias de Experience Manager específicas para realizar tipos de procesamiento específicos. El procesamiento especializado le permite maximizar el uso de los recursos de servidor disponibles.
La descarga se basa en la variable Apache Sling Discovery y Sling JobManager. Para utilizar la descarga, agregue clústeres de Experience Manager a una topología e identifique los temas de trabajo que procesa el clúster. Los clústeres están formados por una o más instancias de Experience Manager, de modo que una sola instancia se considera un clúster.
Para obtener información sobre cómo agregar instancias a una topología, consulte Administración de topologías.
Distribución de trabajo job-distribution
Sling JobManager y JobConsumer permiten la creación de trabajos que se procesan en una topología:
- JobManager: Servicio que crea trabajos para temas específicos.
- JobConsumer: Servicio que ejecuta trabajos de uno o más temas. Se pueden registrar varios servicios de JobConsumer para el mismo tema.
Cuando JobManager crea un trabajo, el marco de descarga selecciona un clúster de Experience Manager en la topología para ejecutar el trabajo:
- El clúster debe incluir una o más instancias que ejecuten un JobConsumer registrado para el tema del trabajo.
- El tema debe estar habilitado para al menos una instancia del clúster.
Consulte Configuración del consumo de tema para obtener información sobre cómo perfeccionar la distribución de trabajos.
Cuando el marco de descarga selecciona un clúster para ejecutar un trabajo y el clúster consta de varias instancias, Sling Distribution determina qué instancia del clúster ejecuta el trabajo.
Cargas de trabajo job-payloads
El marco de descarga admite cargas de trabajo que asocian trabajos con recursos del repositorio. Las cargas de trabajo son útiles cuando se crean trabajos para procesar recursos y el trabajo se descarga a otro equipo.
Tras la creación de un trabajo, la carga útil solo se encuentra en la instancia que crea el trabajo. Al descargar el trabajo, los agentes de replicación se aseguran de que la carga útil se crea en la instancia que finalmente consume el trabajo. Cuando finaliza la ejecución del trabajo, la replicación inversa hace que la carga útil se copie de nuevo en la instancia que creó el trabajo.
Administración de topologías administering-topologies
Las topologías son clústeres de Experience Manager de acoplamiento flexible que participan en la descarga. Un clúster consta de una o más instancias de servidor Experience Manager (una sola instancia se considera un clúster).
Cada instancia de Experience Manager ejecuta los siguientes servicios relacionados con la descarga:
- Servicio de detección: Envía solicitudes a un conector de topología para unirse a la topología.
- Conector de topología: Recibe las solicitudes de combinación y acepta o rechaza cada solicitud.
El servicio de detección de todos los miembros de la topología apuntan al conector de topología de uno de los miembros. En las secciones siguientes, este miembro se denomina miembro raíz.
Cada clúster de la topología contiene una instancia que se reconoce como líder. El líder del clúster interactúa con la topología en nombre de los demás miembros del clúster. Cuando el encabezado abandona el clúster, se elige automáticamente un nuevo líder para el clúster.
Visualización de la topología viewing-the-topology
Utilice el explorador de topología para explorar el estado de la topología en la que participa la instancia de Experience Manager. Topology Browser muestra los clústeres y las instancias de la topología.
Para cada clúster, verá una lista de miembros del clúster que indica el orden en que cada miembro se unió al clúster y qué miembro es el líder. La propiedad Current indica la instancia que está administrando actualmente.
Para cada instancia del clúster, puede ver varias propiedades relacionadas con la topología:
- Una lista de permitidos de temas para el consumidor de trabajos de la instancia.
- Los extremos expuestos para la conexión con la topología.
- Los temas de trabajo para los que se registra la instancia para su descarga.
- Los temas de trabajo que procesa la instancia.
-
Con la IU táctil, haga clic en la ficha Herramientas . (http://localhost:4502/tools.html)
-
En el área Operaciones de Granite, haga clic en Explorador de descarga.
-
En el panel de navegación, haga clic en Explorador de topología.
Aparecen los clústeres que participan en la topología.
-
Haga clic en un clúster para ver una lista de las instancias del clúster y su ID, estado actual y estado de encabezado.
-
Haga clic en un ID de instancia para ver propiedades más detalladas.
También puede utilizar la Consola Web para ver la información de topología. La consola proporciona más información sobre los clústeres de topología:
- Qué instancia es la instancia local.
- Los servicios del conector de topología que utiliza esta instancia para conectarse a la topología (saliente) y los servicios que se conectan a esta instancia (entrante).
- Cambiar el historial de las propiedades de topología e instancia.
Utilice el siguiente procedimiento para abrir la página Administración de topología de la consola web:
-
Abra la consola web en el explorador. (http://localhost:4502/system/console)
-
Haga clic en Principal > Administración de topología.
Configuración de la pertenencia a la topología configuring-topology-membership
El servicio de detección basado en recursos de Apache Sling se ejecuta en cada instancia para controlar cómo las instancias de Experience Manager interactúan con una topología.
El servicio de detección envía solicitudes de POST periódicas (latidos) a los servicios del conector de topología para establecer y mantener conexiones con la topología. El servicio Conector de topología mantiene una lista de permitidos de direcciones IP o nombres de host a los que se permite unirse a la topología:
- Para unir una instancia a una topología, especifique la dirección URL del servicio Conector de topología del miembro raíz.
- Para permitir que una instancia se una a una topología, añada la instancia a la lista de permitidos del servicio Topology Connector del miembro raíz.
Utilice la consola web o un nodo sling:OsgiConfig para configurar las siguientes propiedades del servicio org.apache.sling.discovery.impt.Config :
Utilice el siguiente procedimiento para conectar una instancia de CQ al miembro raíz de una topología. El procedimiento dirige la instancia a la URL del conector de topología del miembro de topología raíz. Realice este procedimiento en todos los miembros de la topología.
- Abra la consola web en el explorador. (http://localhost:4502/system/console)
- Haga clic en Principal > Administración de topología.
- Haga clic en Configurar servicio de detección.
- Agregue un elemento a la propiedad URL del conector de topología y especifique la dirección URL del servicio del conector de topología del miembro de la topología raíz. La dirección URL tiene el formato https://rootservername:4502/libs/sling/topology/connector.
Realice el siguiente procedimiento en el miembro raíz de la topología. El procedimiento agrega los nombres de los demás miembros de la topología a su lista de permitidos de Discovery Service.
- Abra la consola web en el explorador. (http://localhost:4502/system/console)
- Haga clic en Principal > Administración de topología.
- Haga clic en Configurar servicio de detección.
- Para cada miembro de la topología, agregue un elemento a la propiedad de lista de permitidos del conector de topología y especifique el nombre de host o la dirección IP del miembro de la topología.
Configuración del consumo de tema configuring-topic-consumption
Utilice el Explorador de descarga para configurar el consumo de temas para las instancias de Experience Manager en la topología. Para cada instancia, puede especificar los temas que consume. Por ejemplo, para configurar la topología de modo que solo una instancia consuma temas de un tipo específico, deshabilite el tema en todas las instancias excepto en una.
Los trabajos se distribuyen entre instancias que tienen el tema asociado habilitado mediante la lógica de rotación.
-
Con la IU táctil, haga clic en la ficha Herramientas . (http://localhost:4502/tools.html)
-
En el área Operaciones de Granite, haga clic en Explorador de descarga.
-
En el panel de navegación, haga clic en Navegador de descarga.
Aparecen los temas de descarga y las instancias de servidor que pueden consumir los temas.
-
Para desactivar el consumo de un tema para una instancia, debajo del nombre del tema haga clic en Deshabilitar junto a la instancia.
-
Para configurar todo el consumo de temas para una instancia, haga clic en el identificador de instancia debajo de cualquier tema.
-
Haga clic en uno de los siguientes botones junto a un tema para configurar el comportamiento de consumo de la instancia y, a continuación, haga clic en Guardar:
- Habilitado: Esta instancia consume trabajos de este tema.
- Deshabilitado: Esta instancia no consume trabajos de este tema.
- Exclusivo: Esta instancia solo consume trabajos de este tema.
Nota: Al seleccionar Exclusivo para un tema, todos los demás temas se establecen automáticamente como Deshabilitado.
Consumidores de trabajos instalados installed-job-consumers
Se instalan varias implementaciones de JobConsumer con Experience Manager. Los temas para los que están registrados estos JobConsumers aparecen en el Explorador de descargas. Los temas adicionales que aparecen son los que se han registrado en JobConsumers personalizados. En la tabla siguiente se describe el valor predeterminado de JobConsumers.
Desactivación y activación de temas para una instancia disabling-and-enabling-topics-for-an-instance
El servicio Apache Sling Job Consumer Manager proporciona propiedades de lista de permitidos y lista de bloqueados de temas. Configure estas propiedades para habilitar o deshabilitar el procesamiento de temas específicos en una instancia de Experience Manager.
Nota: Si la instancia pertenece a una topología, también puede utilizar el Explorador de descarga en cualquier equipo de la topología para habilitar o deshabilitar temas.
La lógica que crea la lista de temas habilitados permite primero todos los temas que están en la lista de permitidos y luego elimina los temas que están en la lista de bloqueados. De forma predeterminada, todos los temas están habilitados (el valor de lista de permitidos es *) y no hay temas desactivados (la lista de bloqueados no tiene valor).
Utilice la consola web o una sling:OsgiConfig para configurar las siguientes propiedades. Para sling:OsgiConfig , el PID del servicio de Job Consumer Manager es org.apache.sling.event.impl.jobs.JobConsumerManager.
Creación De Agentes De Replicación Para Descarga creating-replication-agents-for-offloading
El marco de descarga utiliza la replicación para transportar recursos entre el autor y el trabajador. El marco de descarga crea automáticamente agentes de replicación cuando las instancias se unen a la topología. Los agentes se crean con valores predeterminados. Debe cambiar manualmente la contraseña que utilizan los agentes para la autenticación.
Cree los agentes de replicación que transportan cargas de trabajo entre instancias para su descarga. La siguiente ilustración muestra los agentes necesarios para descargar del autor en una instancia de trabajo. El autor tiene un Sling ID de 1 y la instancia de trabajo tiene un Sling ID de 2:
Esta configuración requiere los tres agentes siguientes:
- Agente saliente en la instancia de autor que se duplica en la instancia de trabajo.
- Agente inverso en la instancia de autor que se extrae de la bandeja de salida de la instancia de trabajo.
- Agente de buzón de salida en la instancia de trabajo.
Este esquema de replicación es similar al utilizado entre instancias de autor y publicación. Sin embargo, para la situación de descarga, todas las instancias implicadas son instancias de creación.
Asignación de nombres a los agentes de replicación para la descarga naming-the-replication-agents-for-offloading
Utilice un formato específico para la variable Nombre propiedad de los agentes de replicación para que el marco de descarga utilice automáticamente el agente correcto para instancias de trabajo específicas.
Asigne un nombre al agente saliente en la instancia de autor:
offloading_<slingid>, donde <slingid> es el ID de Sling de la instancia de trabajo.
Ejemplo: offloading_f5c8494a-4220-49b8-b079-360a72f71559
Asigne un nombre al agente inverso en la instancia de autor:
offloading_reverse_<slingid>, donde <slingid> es el ID de Sling de la instancia de trabajo.
Ejemplo: offloading_reverse_f5c8494a-4220-49b8-b079-360a72f71559
Asigne un nombre a la bandeja de salida en la instancia de trabajo:
offloading_outbox
Creación del agente saliente creating-the-outgoing-agent
-
Cree un Agente de replicación en author. (Consulte la documentación para agentes de replicación). Especifique cualquier Título. La variable Nombre debe seguir la convención de nomenclatura.
-
Cree el agente con las siguientes propiedades:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Propiedad Valor Configuración > Tipo de serialización Predeterminado Transporte >URI de transporte https:// <ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1Transporte >Usuario de transporte Usuario de replicación en instancia de destino Transporte >Pasaje de transporte Contraseña de usuario de replicación en la instancia de destino Extendido > Método HTTP POST Déclencheur > Ignorar predeterminado Verdadero
Creación del agente inverso creating-the-reverse-agent
-
Cree un Agente de replicación inversa en author. (Consulte la documentación para agentes de replicación.) Especifique cualquier Título. La variable Nombre debe seguir la convención de nomenclatura.
-
Cree el agente con las siguientes propiedades:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 Propiedad Valor Configuración > Tipo de serialización Predeterminado Transporte >URI de transporte https:// <ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1Transporte >Usuario de transporte Usuario de replicación en instancia de destino Transporte >Pasaje de transporte Contraseña de usuario de replicación en la instancia de destino Extendido > Método HTTP GET
Creación del agente de la bandeja de salida creating-the-outbox-agent
-
Cree un Agente de replicación en la instancia de trabajo. (Consulte la documentación para agentes de replicación.) Especifique cualquier Título. La variable Nombre debe
offloading_outbox. -
Cree el agente con las siguientes propiedades.
table 0-row-2 1-row-2 2-row-2 3-row-2 Propiedad Valor Configuración > Tipo de serialización Predeterminado Transporte >URI de transporte repo://var/replication/outbox Déclencheur > Ignorar predeterminado Verdadero
Búsqueda del ID de Sling finding-the-sling-id
Obtenga el ID de Sling de una instancia de Experience Manager mediante cualquiera de los métodos siguientes:
- Abra la consola web y, en la configuración de Sling, busque el valor de la propiedad ID de Sling (http://localhost:4502/system/console/status-slingsettings). Este método es útil si la instancia aún no forma parte de la topología.
- Utilice el explorador de topología si la instancia ya forma parte de la topología.
Descarga del procesamiento de recursos DAM offloading-the-processing-of-dam-assets
Configure las instancias de una topología para que instancias específicas realicen el procesamiento en segundo plano de los recursos que se agregan o actualizan en DAM.
De forma predeterminada, el Experience Manager ejecuta el flujo de trabajo de recursos de actualización de DAM cuando cambia un recurso de DAM o cuando se añade uno a DAM. Cambie el comportamiento predeterminado de modo que el Experience Manager en su lugar ejecute el flujo de trabajo de descarga de recursos de actualización de DAM . Este flujo de trabajo genera un trabajo de JobManager que tiene un tema de com/adobe/granite/workflow/offloading. A continuación, configure la topología para que el trabajo se descargue a un trabajador dedicado.
El siguiente procedimiento asume las siguientes características para la topología de descarga:
- Una o más instancias de Experience Manager son instancias de creación con las que los usuarios interactúan para agregar o actualizar recursos DAM.
- Los usuarios no interactúan directamente con una o más instancias de Experience Manager que procesan los recursos DAM. Estas instancias están dedicadas al procesamiento en segundo plano de los recursos DAM.
-
En cada instancia de Experience Manager, configure Discovery Service para que apunte al conector de topografía raíz. (Consulte Configuración de la pertenencia a la topología.)
-
Configure el conector de topografía raíz para que las instancias de conexión estén en la lista de permitidos.
-
Abra el explorador de descargas y deshabilite la
com/adobe/granite/workflow/offloadingsobre las instancias con las que los usuarios interactúan para cargar o cambiar recursos DAM.
-
En cada instancia con la que los usuarios interactúan para cargar o cambiar los recursos DAM, configure los iniciadores de flujo de trabajo para que utilicen el flujo de trabajo de descarga de recursos de actualización de DAM :
- Abra la consola Flujo de trabajo .
- Haga clic en la ficha Iniciador .
- Busque las dos configuraciones de Launch que ejecutan el flujo de trabajo de recursos de actualización de DAM. Un tipo de evento de configuración de lanzador es Nodo creado y el otro tipo es Nodo modificado.
- Cambie ambos tipos de eventos para que ejecuten el flujo de trabajo de descarga de recursos de actualización de DAM . (Para obtener información sobre las configuraciones del iniciador, consulte Empezar flujos de trabajo cuando cambian los nodos.)
-
En las instancias que realizan el procesamiento en segundo plano de los recursos DAM, desactive los iniciadores de flujo de trabajo que ejecutan el flujo de trabajo de recursos de actualización DAM.
Lectura adicional further-reading
Además de los detalles presentados en esta página, también puede leer lo siguiente:
- Para obtener información sobre el uso de las API de Java para crear trabajos y para consumidores de empleo, consulte Creación y consumo de trabajos para descarga.
- Para obtener instrucciones generales y prácticas recomendadas para la descarga de recursos, consulte Directrices generales y prácticas recomendadas para la descarga de recursos.
- Para saber cómo desactivar la creación automática de agentes de descarga, consulte Desactivación de la administración automática de agentes.