aem-replication
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAEM 6.5 LTS Replication
AEM 6.5 LTS 复制
Route user requests to the appropriate specialist skill based on intent.
根据用户意图将请求路由至对应的专业技能。
Intent Router
意图路由器
| User Intent | Skill | Path |
|---|---|---|
| Configure replication agents (default, dispatcher flush, reverse replication) | Configure Replication Agent | configure-replication-agent/SKILL.md |
| Activate or deactivate content using UI or workflows | Replicate Content | replicate-content/SKILL.md |
| Use Replication API programmatically in custom code | Replication API | replication-api/SKILL.md |
| Diagnose blocked queues, connectivity issues, or distribution problems | Troubleshoot Replication | troubleshoot-replication/SKILL.md |
| End-to-end workflows: new environment setup, incident response, performance optimization | Replication Orchestrator | replication-orchestrator/SKILL.md |
| 用户意图 | 技能 | 路径 |
|---|---|---|
| 配置复制代理(默认、Dispatcher Flush、反向复制) | 配置Replication Agent | configure-replication-agent/SKILL.md |
| 通过UI或工作流激活/停用内容 | 内容复制 | replicate-content/SKILL.md |
| 在自定义代码中编程使用Replication API | Replication API | replication-api/SKILL.md |
| 诊断队列阻塞、连接问题或分发故障 | 复制故障排查 | troubleshoot-replication/SKILL.md |
| 端到端工作流:新环境搭建、事件响应、性能优化 | 复制编排器 | replication-orchestrator/SKILL.md |
How to Use
使用方法
- Match the user's request to one row in the Intent Router table above.
- Read the linked SKILL.md for that specialist skill.
- Follow the workflow and guidance defined in that skill.
- For complex scenarios spanning multiple skills (e.g., configure agent then troubleshoot), start with the primary intent and cross-reference as needed.
- 将用户请求与上方意图路由器表格中的某一行匹配。
- 阅读对应专业技能的SKILL.md链接文档。
- 遵循该技能中定义的工作流和指导。
- 对于涉及多个技能的复杂场景(例如,先配置代理再排查问题),从主要意图入手,并根据需要交叉参考相关内容。
Skill Overview
技能概述
Configure Replication Agent
配置Replication Agent
Set up and configure replication agents for:
- Default agents: Author to Publish content distribution
- Dispatcher Flush agents: Cache invalidation
- Reverse replication: Publish to Author user-generated content flow
- Multiple publish instances: Load balancing and high availability
When to use: First-time setup, adding new publish instances, reconfiguring agents
设置并配置以下类型的Replication Agent:
- 默认代理:从作者环境到发布环境的内容分发
- Dispatcher Flush代理:缓存失效
- 反向复制:从发布环境到作者环境的用户生成内容流转
- 多发布实例:负载均衡与高可用
适用场景:首次搭建环境、添加新发布实例、重新配置代理
Replicate Content
内容复制
Activate and deactivate content through:
- Quick Publish: Simple one-click activation
- Manage Publication: Advanced scheduling and approval workflows
- Tree Activation: Hierarchical bulk publishing
- Package Manager: Specific content set distribution
- Workflows: Approval-based publishing
- Scheduled Activation: Time-based content publishing
When to use: Publishing pages, assets, or DAM content; unpublishing content
激活和停用内容通过以下方式:
- 快速发布:简单的一键激活
- 发布管理:高级调度与审批工作流
- 树形激活:分层批量发布
- 包管理器:特定内容集的分发
- 工作流:基于审批的发布
- 定时激活:基于时间的内容发布
适用场景:发布页面、资产或DAM内容;取消发布内容
Replication API
Replication API
Programmatic replication using official AEM 6.5 LTS public APIs:
- Replicator interface: Core replication methods
- ReplicationOptions: Configure synchronous/asynchronous, agent filtering
- ReplicationStatus: Query replication state
- AgentManager, ReplicationQueue, ReplicationListener: Advanced queue management and monitoring
When to use: Custom code integration, bulk operations, workflow process steps, servlets
使用官方AEM 6.5 LTS公开API进行编程式复制:
- Replicator接口:核心复制方法
- ReplicationOptions:配置同步/异步模式、代理过滤
- ReplicationStatus:查询复制状态
- AgentManager、ReplicationQueue、ReplicationListener:高级队列管理与监控
适用场景:自定义代码集成、批量操作、工作流步骤、Servlet
Troubleshoot Replication
复制故障排查
Diagnose and fix common issues:
- Blocked queues: FIFO queue failures
- Connection errors: Network, authentication, SSL issues
- Content not appearing: Dispatcher cache, permissions
- Agent configuration: URI, credentials, triggers
- Event queue issues: Stuck replication jobs
When to use: Replication failures, performance issues, content not distributing
诊断并修复常见问题:
- 队列阻塞:FIFO队列故障
- 连接错误:网络、认证、SSL问题
- 内容未显示:Dispatcher缓存、权限问题
- 代理配置:URI、凭证、触发器
- 事件队列问题:停滞的复制任务
适用场景:复制失败、性能问题、内容未分发
Replication Orchestrator
复制编排器
Coordinates end-to-end replication workflows spanning multiple sub-skills:
- New Environment Setup: Configure agents → Test replication → Troubleshoot
- Production Incident Response: Diagnose → Fix → Verify
- Performance Optimization: Monitor → Tune → Validate
- Migration Preparation: Audit → Plan → Execute
When to use: Multi-step scenarios requiring coordination across configure, replicate, API, and troubleshoot skills
协调跨多个子技能的端到端复制工作流:
- 新环境搭建:配置代理 → 测试复制 → 排查问题
- 生产事件响应:诊断 → 修复 → 验证
- 性能优化:监控 → 调优 → 验证
- 迁移准备:审计 → 规划 → 执行
适用场景:需要协调配置、复制、API和排查技能的多步骤场景
Common Workflows
常见工作流
First-Time Setup
首次搭建
- Use Configure Replication Agent to set up default agent
- Use Replicate Content to test with a sample page
- If issues occur, use Troubleshoot Replication
- 使用配置Replication Agent设置默认代理
- 使用内容复制测试示例页面
- 若出现问题,使用复制故障排查
Production Operations
生产运维
- Use Replicate Content for day-to-day publishing
- Use Replication API for automated/bulk operations
- Use Troubleshoot Replication when issues arise
- 使用内容复制进行日常发布
- 使用Replication API进行自动化/批量操作
- 出现问题时使用复制故障排查
Advanced Integration
高级集成
- Use Replication API to understand available methods
- Use Configure Replication Agent to understand agent configuration
- Use Troubleshoot Replication for debugging custom replication code
- 使用Replication API了解可用方法
- 使用配置Replication Agent了解代理配置
- 使用复制故障排查调试自定义复制代码
Foundation References
基础参考资料
Shared reference materials used across all replication skills:
- Agent Types: Default, Dispatcher Flush, Reverse, and Static agents
- Queue Mechanics: FIFO processing, retry logic, queue management
- AEM 6.5 LTS Guardrails: Service users, timeouts, batch limits, best practices
- API Quick Reference: Replicator, ReplicationOptions, ReplicationStatus methods
所有复制技能共用的参考资料:
- 代理类型:默认、Dispatcher Flush、反向和静态代理
- 队列机制:FIFO处理、重试逻辑、队列管理
- AEM 6.5 LTS 防护准则:服务用户、超时、批量限制、最佳实践
- API快速参考:Replicator、ReplicationOptions、ReplicationStatus方法
Official Documentation
官方文档
All skills reference official Adobe AEM 6.5 LTS documentation:
所有技能均参考Adobe官方AEM 6.5 LTS文档:
Related Skills
相关技能
- AEM Workflow: Integrate replication with approval workflows
- Dispatcher: Configure Dispatcher Flush agents for cache invalidation
- AEM工作流:将复制与审批工作流集成
- Dispatcher:配置Dispatcher Flush代理实现缓存失效
Migration to AEM as a Cloud Service
迁移至AEM as a Cloud Service
AEM as a Cloud Service uses the Sling Distribution API instead of replication agents. If planning migration:
- Review Cloud Service Distribution Documentation
- For code migration patterns, see
skills/aem/cloud-service/skills/best-practices/references/replication.md - Avoid agent-specific coupling (filter by agent ID) to reduce migration complexity
AEM as a Cloud Service使用Sling Distribution API替代Replication Agent。若计划迁移:
- 查看云服务分发文档
- 关于代码迁移模式,请参阅
skills/aem/cloud-service/skills/best-practices/references/replication.md - 避免与代理强耦合(按代理ID过滤)以降低迁移复杂度