Agent Skills
返回列表
AEM 内容发布与分发监控

AEM 内容发布与分发监控

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 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 先行审批流程的内容平台工程师:关注分布式发布链路的可行性与边界约束