卸载作业

简介

卸载在拓扑中分布处理任务占用Experience Manager实例。 通过卸载，您可以使用特定Experience Manager实例执行特定类型的处理。 专用处理使您能够最大限度地利用可用的服务器资源。

卸载基于Apache Sling Discovery和Sling JobManager功能。 要使用卸载，可向拓扑中添加Experience Manager群集并标识群集处理的作业主题。 群集由一个或多个Experience Manager实例组成，因此单个实例被视为群集。

有关向拓扑添加实例的信息，请参见管理拓扑。

作业分配

Sling JobManager和JobConsumer支持创建在拓扑中处理的作业：

• 作业管理器：为特定主题创建作业的服务。
• JobConsumer:执行一个或多个主题的作业的服务。 可以为同一主题注册多个JobConsumer服务。

当JobManager创建作业时，卸载框架会选择拓扑中的Experience Manager群集来执行该作业：

• 群集必须包括一个或多个运行为作业主题注册的JobConsumer的实例。
• 必须至少为群集中的一个实例启用主题。

有关优化作业分配的信息，请参阅配置主题消耗。

当卸载框架选择群集以执行作业，并且群集由多个实例组成时，Sling Distribution将确定群集中的哪个实例执行该作业。

作业负载

卸载框架支持将作业与存储库中的资源相关联的作业有效负荷。 当为处理资源创建作业并且作业被卸载到另一台计算机时，作业有效负荷很有用。

创建作业时，仅保证有效负荷位于创建作业的实例上。 卸载作业时，复制代理确保在最终消耗作业的实例上创建有效负荷。 作业执行完成后，反向复制会导致有效负荷被复制回创建作业的实例。

管理拓扑

拓扑是参与卸载的松耦合Experience Manager群集。 群集由一个或多个Experience Manager服务器实例（单个实例被视为群集）组成。

每个Experience Manager实例都运行以下卸载相关服务：

• 发现服务：向拓扑连接器发送请求以加入拓扑。
• 拓扑连接器：接收加入请求，并接受或拒绝每个请求。

拓扑的所有成员的发现服务指向其中一个成员上的拓扑连接器。 在后面的部分中，此成员称为根成员。

拓扑中的每个群集都包含一个被识别为引线的实例。 群集引线代表群集的其他成员与拓扑交互。 当引线离开群集时，将自动选择群集的新引线。

查看拓扑

使用拓扑浏览器来浏览Experience Manager实例所参与的拓扑的状态。 拓扑浏览器显示拓扑的群集和实例。

对于每个群集，您会看到一个群集成员列表，它指示每个成员加入群集的顺序，以及哪个成员是Leader。 “当前”属性指示您当前管理的实例。

对于群集中的每个实例，您可以看到几个与拓扑相关的属性：

• 实例的作业使用者的允许列表主题。
• 用于连接拓扑的端点。
• 已注册实例以卸载的作业主题。
• 实例处理的作业主题。

1. 使用触屏UI，单击工具选项卡。 (http://localhost:4502/tools.html)

2. 在“Granite操作”区域，单击“卸载浏览器”。

3. 在导航面板中，单击拓扑浏览器。

   将出现参与拓扑的群集。

   

4. 单击某个群集可查看群集中实例的列表及其ID、当前状态和Leader状态。

5. 单击实例ID以查看更详细的属性。

您还可以使用Web控制台视图拓扑信息。 该控制台提供了有关拓扑群集的更多信息：

• 哪个实例是本地实例。
• 此实例用来连接到拓扑（传出）的拓扑连接器服务，以及连接到此实例（传入）的服务。
• 更改拓扑和实例属性的历史记录。

请按照以下过程打开Web控制台的“拓扑管理”页：

1. 在浏览器中打开Web控制台。 (http://localhost:4502/system/console)

2. 单击“主”>“拓扑管理”。

   

配置拓扑成员关系

Apache Sling Resource-Based Discovery Service在每个实例上运行，以控制Experience Manager实例与拓扑交互的方式。

发现服务向拓扑连接器服务发送定期POST请求（心跳），以建立和维护与拓扑的连接。 拓扑连接器服务保留允许加入拓扑的IP地址或主机名允许列表:

• 要将实例连接到拓扑，请指定根成员的拓扑连接器服务的URL。
• 要使实例能够加入拓扑，请将该实例添加到根成员的拓扑连接器服务的允许列表。

使用Web控制台或sling:OsgiConfig节点配置org.apache.sling.discovery.impt.Config服务的以下属性：

属性名称	OSGi名称	描述	默认值
心跳超时（秒）	心跳超时	在目标实例被视为不可用之前等待心跳响应的时间（秒）。	20
心跳间隔（秒）	heartbeatInterval	心跳之间的秒数。	15
最小事件延迟（秒）	minEventDelay	当拓扑发生更改时，将状态从TOPOLOGY_CHANGING延迟到TOPOLOGY_CHANGED的时间。 当状态为TOPOLOGY_CHANGING时发生的每次更改都会将延迟增加此时间量。 这种延迟防止了听众被事件淹没。 要不使用延迟，请指定0或负数。	3
拓扑连接器URL	topologyConnectorUrl	用于发送心跳消息的拓扑连接器服务的URL。	http://localhost:4502/libs/sling/topology/connector
拓扑连接器允许列表	topologyConnectorWhitelist	本地拓扑连接器服务允许在拓扑中列表IP地址或主机名。	本地主机 127.0.0.1
存储库描述符名称	leaderElectionRepositoryDescriptor		<无值>

请按照以下过程将CQ实例连接到拓扑的根成员。 该过程将实例指向根拓扑成员的拓扑连接器URL。 对拓扑的所有成员执行此过程。

1. 在浏览器中打开Web控制台。 (http://localhost:4502/system/console)
2. 单击“主”>“拓扑管理”。
3. 单击“配置发现服务”。
4. 向“拓扑连接器URL”属性添加一个项，并指定根拓扑成员的拓扑连接器服务的URL。 URL的形式为https://rootservername:4502/libs/sling/topology/connector。

对拓扑的根成员执行以下过程。 该过程将其他拓扑成员的名称添加到其发现服务允许列表。

1. 在浏览器中打开Web控制台。 (http://localhost:4502/system/console)
2. 单击“主”>“拓扑管理”。
3. 单击“配置发现服务”。
4. 对于拓扑的每个成员，向“拓扑连接器允许列表”属性添加一个项，并指定拓扑成员的主机名或IP地址。

配置主题消耗

使用卸载浏览器为拓扑中的Experience Manager实例配置主题消耗。 对于每个实例，您可以指定它使用的主题。 例如，要配置拓扑以便只有一个实例读取特定类型的主题，请禁用除一个实例外的所有实例上的主题。

作业是使用循环法逻辑启用相关主题的分配数量实例。

1. 使用触屏UI，单击工具选项卡。 (http://localhost:4502/tools.html)

2. 在“Granite操作”区域，单击“卸载浏览器”。

3. 在导航面板中，单击“卸载浏览器”。

   将显示卸载主题以及可以使用这些主题的服务器实例。

   

4. 要禁用实例主题的使用，请在topc名称下单击实例旁边的禁用。

5. 要配置实例的所有主题使用情况，请单击任意主题下的实例标识符。

   

6. 单击主题旁边的以下按钮之一以配置实例的使用行为，然后单击保存：

   • 已启用：此实例会消耗此主题的作业。
   • 已禁用：此实例不占用此主题的作业。
   • 独家：此实例仅消耗本主题的作业。

   注意： 当您为某个主题选择“排他”时，所有其他主题都会自动设置为“禁用”。

已安装的作业使用者

多个JobConsumer实现随Experience Manager一起安装。 注册这些JobConsumer的主题显示在卸载浏览器中。 显示的其他主题是自定义JobConsumers已注册的主题。 下表描述了默认的JobConsumer。

作业主题	服务PID	描述
/	org.apache.sling.event.impl.jobs.deprecated.EventAdminBridge	已与Apache Sling一起安装。 处理OSGi事件管理员生成的作业，以实现向后兼容性。
com/day/cq/replication/job/*	com.day.cq.replication.impl.AgentManagerImpl	复制作业负载的复制代理。
com/adobe/granite/workflow/offloading	com.adobe.granite.workflow.core.offloading.WorkflowOffloadingJobConsumer	处理DAM更新资产卸载程序工作流生成的作业。

禁用和启用实例的主题

Apache Sling Job Consumer Manager服务提供主题允许列表和阻止列表属性。 配置这些属性以启用或禁用对Experience Manager实例上特定主题的处理。

注意： 如果实例属于拓扑，您还可以在拓扑中的任何计算机上使用卸载浏览器来启用或禁用主题。

创建已启用主题列表的逻辑首先允许允许列表中的所有主题，然后删除阻止列表中的主题。默认情况下，所有主题都处于启用状态(允许列表值*)，并且不禁用任何主题(阻止列表没有值)。

使用Web控制台或sling:OsgiConfig节点配置以下属性。 对于sling:OsgiConfig节点，作业消费者管理器服务的PID为org.apache.sling.事件.impl.jobs.JobConsumerManager。

Web控制台中的属性名称	OSGi ID	描述
主题白名单	job.consumermanager.whitelist	本地JobManager服务处理的主题列表。 &ast；的默认值使所有主题都发送到注册的TopicConsumer服务。
主题黑名单	job.consumermanager.blacklist	本地JobManager服务未处理的主题列表。

创建用于卸载的复制代理

卸载框架使用复制在作者和工作者之间传输资源。 卸载框架在实例加入拓扑时自动创建复制代理。 代理是使用默认值创建的。 您必须手动更改代理用于身份验证的密码。

创建在实例之间传输作业负载以进行卸载的复制代理。 下图显示了从作者卸载到工作实例所需的代理。 作者的Sling ID为1，工作实例的Sling ID为2:

此设置需要以下三个代理：

1. 创作实例上的传出代理，它复制到工作实例。
2. 创作实例上的反向代理，它从工作实例的输出框中拉出。
3. 工作器实例上的发件箱代理。

此复制方案与创作实例和发布实例之间使用的复制方案类似。 但是，对于卸载情况，涉及的所有实例都是创作实例。

命名要卸载的复制代理

为复制代理的​名称​属性使用特定格式，这样卸载框架会自动为特定工作器实例使用正确的代理。

在创作实例上命名传出代理：

offloading_<slingid>，其 <slingid> 中是worker实例的Sling ID。

示例: offloading_f5c8494a-4220-49b8-b079-360a72f71559

在创作实例上命名反向代理：

offloading_reverse_<slingid>，其 <slingid> 中是worker实例的Sling ID。

示例: offloading_reverse_f5c8494a-4220-49b8-b079-360a72f71559

命名工作器实例上的输出框：

offloading_outbox

创建传出代理

1. 在作者上创建​复制代理。 （请参见有关复制代理的文档）。 指定任何​标题。 名称​必须遵循命名约定。

2. 使用以下属性创建代理：

   属性	值
   “设置”>“序列化类型”	默认
   传输>传输URI	https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
   “传输”>“传输用户”	目标实例上的复制用户
   “传输”>“传输密码”	目标实例上的复制用户口令
   “扩展”>“HTTP方法”	POST
   “触发器”>“忽略默认值”	True

创建反向代理

1. 在作者上创建​反向复制代理。 （请参见有关复制代理的文档。） 指定任何​标题。 名称​必须遵循命名约定。

2. 使用以下属性创建代理：

   属性	值
   “设置”>“序列化类型”	默认
   传输>传输URI	https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
   “传输”>“传输用户”	目标实例上的复制用户
   “传输”>“传输密码”	目标实例上的复制用户口令
   “扩展”>“HTTP方法”	GET

创建发件箱代理

1. 在工作器实例上创建​复制代理。 （请参见有关复制代理的文档。） 指定任何​标题。 名称​必须为offloading_outbox。

2. 使用以下属性创建代理。

   属性	值
   “设置”>“序列化类型”	默认
   传输>传输URI	repo://var/replication/outbox
   “触发器”>“忽略默认值”	True

查找Sling ID

使用以下任一方法获取Experience Manager实例的Sling ID:

• 打开Web控制台，在Sling设置中，找到Sling ID属性的值(http://localhost:4502/system/console/status-slingsettings)。 如果实例尚不是拓扑的一部分，则此方法可用。
• 如果实例已是拓扑的一部分，请使用拓扑浏览器。

卸载DAM资产的处理

配置拓扑实例，以便特定实例对在DAM中添加或更新的资产执行后台处理。

默认情况下，当DAM资产发生更改或将一个资产添加到DAM时，Experience Manager会执行DAM更新资产工作流。 更改默认行为，以便Experience Manager改为执行DAM更新资产卸载程序工作流。 此工作流会生成一个主题为com/adobe/granite/workflow/offloading的JobManager作业。 然后，配置拓扑，以将作业卸载到专用工作器。

以下过程假定卸载拓扑具有以下特征：

• 一个或多个Experience Manager实例正在创作用户与之交互以添加或更新DAM资产的实例。
• 用户不直接与处理DAM资产的一个或多个Experience Manager实例交互。 这些实例专用于DAM资产的后台处理。

1. 在每个Experience Manager实例上，配置发现服务，使其指向根地形连接器。 （请参阅配置拓扑成员关系。）

2. 配置根拓扑连接器，使连接实例位于允许列表上。

3. 打开卸载浏览器并禁用用户与之交互以上传或更改DAM资产的实例中的com/adobe/granite/workflow/offloading主题。

   

4. 在用户与之交互以上传或更改DAM资产的每个实例上，将工作流启动器配置为使用DAM更新资产卸载工作流：

   1. 打开工作流控制台。
   2. 单击“启动器”选项卡。
   3. 找到执行DAM更新资产工作流的两个启动程序配置。 一个启动器配置事件类型为“已创建节点”，另一个类型为“已修改节点”。
   4. 更改这两个事件类型，以便它们执行DAM更新资产卸载工作流。 (有关启动器配置的信息，请参阅当节点发生更改时启动工作流。)

5. 在执行DAM资产后台处理的实例上，禁用执行DAM更新资产工作流的工作流启动程序。

进一步阅读

除了本页中显示的详细信息之外，您还可以阅读以下内容：

• 有关使用Java API创建作业和作业使用者的信息，请参阅创建和使用卸载作业。
• 有关资产卸载的一般准则和最佳实践，请参阅资产卸载的一般准则和最佳实践。
• 要了解如何禁用卸载代理的自动创建，请参阅关闭自动代理管理。