AEM 内容发布与分发监控
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/content-distribution。
技能介绍
这个技能解决什么问题
在 AEM Cloud Service 里,内容从 CMS 推到 Publish 或 Preview 实例并不是一个“发完即生效”的动作。它经过 Sling Distribution 打包、入队、通过 Adobe 管道传输、再到目标实例导入,链路比 AEM 6.x 的直连 JCR 复制复杂不少。现实里的痛点往往集中在三点:
- 发布是黑盒:
Replicator.replicate()一旦返回,你不知道内容什么时候真正上线。 - 排查靠猜:内容没出现在目标 tier 时,只能手动翻日志或反复刷新页面。
- 流程无法自动化:想在发布失败时自动告警,或导入完成后触发缓存预热、通知,缺少统一的事件入口。
这个技能组合聚焦的就是“发布 + 分发监控”这条链路,而不是泛泛的 AEM 运维。
它如何工作
核心思路是用两个官方 API 把发布和监控拆开,不重复造轮子。
Replication API(com.day.cq.replication)负责发布侧:
- 提供
Replicator、ReplicationOptions、ReplicationStatus等接口,支持在自定义 OSGi 服务或 workflow step 中调用。 - 可执行 publish/unpublish、批量操作、向 Preview tier 先行发布。
- 通过
ReplicationException暴露失败,支持捕获后告警。
Sling Distribution Events(org.apache.sling.distribution.event)负责监控侧:
- 订阅分发生命周期事件:
AGENT_PACKAGE_CREATED、AGENT_PACKAGE_QUEUED、AGENT_PACKAGE_DISTRIBUTED、IMPORTER_PACKAGE_IMPORTED。 - 监听
AGENT_PACKAGE_DROPPED处理分发失败,并在导入完成后触发下游动作(如刷新缓存、推送通知、跑审计)。
典型流程是:你的代码调用 replicate() 发布内容 → Sling Distribution 打包并触发事件 → 包排队、传输、最终在目标 tier 导入 → 对应事件依次触发,直到内容正式上线。
适用边界与注意点
这个技能不适用的场景:
- 偶发性少量内容发布,直接在 UI 里走 Quick Publish 或 Manage Publication 更省事。
- 大批量层级内容树激活且无自定义逻辑,官方更建议使用 Tree Activation workflow step。
同时有几个硬约束和 Beta 状态要注意:
- 单次 API 调用路径数建议 ≤100,超出后系统会自动拆包,但会牺牲事务性的原子保证。
- Payload 限制 10 MB(不含二进制资源)。
ReplicationOptions.setUseAtomicCalls()已废弃,不再需要手动设置。- Agent 配置由 Adobe 托管,不暴露手动 OSGi 配置入口。
- 事件监听需精确匹配 topic 常量,并对事件属性做 null 检查;避免在处理函数中阻塞,影响分发吞吐。
- 使用专门的 service user,不要使用 admin 凭据,并在 replicator 调用前执行
replicator.checkPermission()。
整体定位清晰:适合需要把 AEM 发布流程嵌入自动化脚本、自定义 OSGi 服务或运维监控的工程师;不适合把它当成通用内容管理工具。
使用场景
- CMS 运营在批量更新页面后,需要预测内容何时在 Publish 与 Preview 实例上线,并用事件确认每个分发阶段是否完成
- 平台工程师想在自己的 OSGi 服务里调用 Replicator 发布内容,并在 ReplicationException 时阻断流程并告警
- 内容平台需要监听 AGENT_PACKAGE_DROPPED 等事件,统计失败分发次数并定位具体传输环节的问题
- 发布前要在 Preview tier 先行上线供业务团队审核,审核通过后再由自动化脚本将同批次内容推至正式 Publish
适合人员
- 负责在 AEM 里发布内容的 CMS 运营:需要按批次下发页面并确认上线完整结束
- 给 AEM 做二次开发的 Java/OSGi 工程师:想在 workflow step 中嵌入 Replicator 调用
- 管理 AEM 云服务运维的 SRE:需要依据 Sling Distribution 事件做监控大屏与告警
- 搭建 Preview 先行审批流程的内容平台工程师:关注分布式发布链路的可行性与边界约束