mcpField
A
aem-replication

aem-replication

github.com/adobe云与 DevOps316570 次安装今天更新
代码仓库

关于 aem-replication

面向 AEM 6.5 LTS 复制任务的技能路由器，根据用户意图交由配置、内容发布、API 或故障排查等专门技能处理。也提供跨技能编排，涵盖环境设置、事故响应与性能优化。

主要功能

  1. 01按意图选择专门技能
  2. 02配置复制 Agent
  3. 03通过多种方式发布内容
  4. 04使用复制 API 编程
  5. 05诊断队列与连接问题
  6. 06编排端到端复制流程

适用场景

  1. 01初次配置发布实例
  2. 02安排页面或资产发布
  3. 03将复制集成到自定义代码
  4. 04排查内容未分发问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/adobe/skills --skill aem-replication

安装后在 Claude Code 中输入/aem-replication确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/replication-foundation/
65-lts-guardrails.md
agent-types.md
api-reference.md
queue-mechanics.md
replicate-content/references/
PACKAGE_REPLICATION.md
REPLICATION_API.md
TREE_ACTIVATION.md

详细介绍

AEM 6.5 LTS 复制

根据用户意图，将请求路由到相应的专用技能。

意图路由表

用户意图技能路径
配置复制代理（默认代理、Dispatcher 刷新、反向复制）配置复制代理configure-replication-agent/SKILL.md
使用 UI 或工作流激活或取消激活内容复制内容replicate-content/SKILL.md
在自定义代码中以编程方式使用复制 API复制 APIreplication-api/SKILL.md
诊断队列阻塞、连接问题或分发问题排查复制问题troubleshoot-replication/SKILL.md
端到端工作流：新环境设置、事件响应、性能优化复制编排器replication-orchestrator/SKILL.md

使用方法

  1. 将用户请求与上方意图路由表中的一行匹配。
  2. 阅读对应专用技能的 SKILL.md。
  3. 遵循该技能中定义的工作流和指南。
  4. 对于跨越多项技能的复杂场景（例如，配置代理后再排查问题），先从主要意图入手，并根据需要交叉参考。

技能概览

配置复制代理

设置和配置复制代理，用于：

  • 默认代理：将 Author 内容分发到 Publish
  • Dispatcher 刷新代理：使缓存失效
  • 反向复制：将 Publish 上用户生成的内容传回 Author
  • 多个 Publish 实例：负载均衡和高可用性

**适用场景：**首次设置、添加新的 Publish 实例、重新配置代理

复制内容

通过以下方式激活和取消激活内容：

  • 快速发布：简单的一键激活
  • 管理发布：高级计划和审批工作流
  • 树激活：分层批量发布
  • 包管理器：分发特定内容集
  • 工作流：基于审批的发布
  • 计划激活：按时间发布内容

**适用场景：**发布页面、资源或 DAM 内容；取消发布内容

复制 API

使用官方 AEM 6.5 LTS 公共 API 以编程方式进行复制：

  • Replicator 接口：核心复制方法
  • ReplicationOptions：配置同步或异步执行、代理筛选
  • ReplicationStatus：查询复制状态
  • AgentManager、ReplicationQueue、ReplicationListener：高级队列管理和监控

**适用场景：**自定义代码集成、批量操作、工作流流程步骤、Servlet

排查复制问题

诊断并修复常见问题：

  • 队列阻塞：FIFO 队列故障
  • 连接错误：网络、身份验证、SSL 问题
  • 内容未显示：Dispatcher 缓存、权限
  • 代理配置：URI、凭据、触发器
  • 事件队列问题：卡住的复制作业

**适用场景：**复制失败、性能问题、内容未能分发

复制编排器

协调跨多个子技能的端到端复制工作流：

  • 新环境设置：配置代理 → 测试复制 → 排查问题
  • 生产事件响应：诊断 → 修复 → 验证
  • 性能优化：监控 → 调优 → 验证
  • 迁移准备：审计 → 规划 → 执行

**适用场景：**需要协调配置、复制、API 和排查技能的多步骤场景

常见工作流

首次设置
  1. 使用配置复制代理设置默认代理
  2. 使用复制内容通过示例页面进行测试
  3. 如果出现问题，请使用排查复制问题
生产运维
  1. 日常发布使用 Replicate Content
  2. 自动化或批量操作使用 Replication API
  3. 出现问题时使用 Troubleshoot Replication
高级集成
  1. 使用 Replication API 了解可用方法
  2. 使用 Configure Replication Agent 了解 Agent 配置
  3. 调试自定义复制代码时使用 Troubleshoot Replication

基础参考资料

所有复制技能共用的参考资料：

官方文档

所有技能均参考 Adobe AEM 6.5 LTS 官方文档：

相关技能

  • AEM 工作流：将复制集成到审批工作流中
  • Dispatcher：配置 Dispatcher Flush Agent 以使缓存失效

迁移到 AEM as a Cloud Service

AEM as a Cloud Service 使用 Sling Distribution API，而非复制 Agent。如果计划迁移：

  • 查看 Cloud Service Distribution 文档
  • 有关代码迁移模式，请参阅 skills/aem/cloud-service/skills/best-practices/references/replication.md
  • 避免与 Agent 特有配置耦合（按 Agent ID 筛选），以降低迁移复杂性

评论

支持 Markdown