aem-replication

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AEM 6.5 LTS Replication

AEM 6.5 LTS 复制

Route user requests to the appropriate specialist skill based on intent.
根据用户意图将请求路由至对应的专业技能。

Intent Router

意图路由器

User IntentSkillPath
Configure replication agents (default, dispatcher flush, reverse replication)Configure Replication Agentconfigure-replication-agent/SKILL.md
Activate or deactivate content using UI or workflowsReplicate Contentreplicate-content/SKILL.md
Use Replication API programmatically in custom codeReplication APIreplication-api/SKILL.md
Diagnose blocked queues, connectivity issues, or distribution problemsTroubleshoot Replicationtroubleshoot-replication/SKILL.md
End-to-end workflows: new environment setup, incident response, performance optimizationReplication Orchestratorreplication-orchestrator/SKILL.md
用户意图技能路径
配置复制代理(默认、Dispatcher Flush、反向复制)配置Replication Agentconfigure-replication-agent/SKILL.md
通过UI或工作流激活/停用内容内容复制replicate-content/SKILL.md
在自定义代码中编程使用Replication APIReplication APIreplication-api/SKILL.md
诊断队列阻塞、连接问题或分发故障复制故障排查troubleshoot-replication/SKILL.md
端到端工作流:新环境搭建、事件响应、性能优化复制编排器replication-orchestrator/SKILL.md

How to Use

使用方法

  1. Match the user's request to one row in the Intent Router table above.
  2. Read the linked SKILL.md for that specialist skill.
  3. Follow the workflow and guidance defined in that skill.
  4. For complex scenarios spanning multiple skills (e.g., configure agent then troubleshoot), start with the primary intent and cross-reference as needed.
  1. 将用户请求与上方意图路由器表格中的某一行匹配。
  2. 阅读对应专业技能的SKILL.md链接文档。
  3. 遵循该技能中定义的工作流和指导。
  4. 对于涉及多个技能的复杂场景(例如,先配置代理再排查问题),从主要意图入手,并根据需要交叉参考相关内容。

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

首次搭建

  1. Use Configure Replication Agent to set up default agent
  2. Use Replicate Content to test with a sample page
  3. If issues occur, use Troubleshoot Replication
  1. 使用配置Replication Agent设置默认代理
  2. 使用内容复制测试示例页面
  3. 若出现问题,使用复制故障排查

Production Operations

生产运维

  1. Use Replicate Content for day-to-day publishing
  2. Use Replication API for automated/bulk operations
  3. Use Troubleshoot Replication when issues arise
  1. 使用内容复制进行日常发布
  2. 使用Replication API进行自动化/批量操作
  3. 出现问题时使用复制故障排查

Advanced Integration

高级集成

  1. Use Replication API to understand available methods
  2. Use Configure Replication Agent to understand agent configuration
  3. Use Troubleshoot Replication for debugging custom replication code
  1. 使用Replication API了解可用方法
  2. 使用配置Replication Agent了解代理配置
  3. 使用复制故障排查调试自定义复制代码

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过滤)以降低迁移复杂度