使用“内容复制”工具同步AEM环境内容

在使用内容复制工具时,如果无依赖其配置路径或针对不受支持的流方向时,在AEMaaCS环境之间同步内容会失败或产生错误结果。 AEMaaCS将不可变代码与可变内容分隔开来,因此无法在存储库级别克隆环境 — 支持的机制是基于路径的复制,即从较高的环境复制到较低的环境,这将覆盖匹配的JCR路径并在不同的地方合并。 缺少依赖路径(如/conf元数据配置文件)会导致同步后元数据不正确,从较低环境复制到较高环境需要启用转发流程。 包括从属路径、确认流方向和权限以及验证目标环境会生成可靠、可重复的同步。

描述 description

问题:内容复制会生成错误的元数据或在AEM环境之间失败

说明

客户会定期将内容从生产环境同步到暂存、开发或RDE环境,以进行测试或验证。 基于包的手动传输速度较慢、容易出错,不适用于大型DAM存储库。 AEMaaCS提供了内容复制工具,以将允许的可变JCR路径从较高环境复制到较低环境,但您可能会遇到元数据配置文件不匹配,如缺少/conf依赖项、自动化限制(默认情况下按需复制内容)、流量限制(仅生产到较低环境,除非启用了正向流量)以及有关增量或增量复制的混淆,这是不受支持的。

环境:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Assets Essentials
  • AEM Managed Services
  • Cloud Manager(内容集和内容副本)

问题/症状:

  • 复制到暂存的内容显示不正确的元数据架构或默认值。
  • 由于缺少权限(Deployment Manager加上AEM管理员)或环境流方向不可用,无法启动内容复制操作。
  • 除非明确启用“正向流”,否则用户无法从较低环境复制到较高环境,例如从开发环境复制到暂存环境,或从开发环境复制到生产环境。
  • 由于内容复制没有内置计划程序,因此自动化尝试失败。
  • 基于包的同步耗时过长或失败,因为DAM大小超过AEM包限制。

根本原因:

AEMaaCS将不可变代码和可变内容分开,因此不能直接在存储库级别克隆环境内容。 支持的机制是使用内容复制工具进行基于路径的复制,该工具会覆盖用于匹配JCR路径的目标内容、在路径不同时合并,并且仅在从高到低的环境中工作,除非为非生产流启用正向流。 缺少依赖路径(如/conf元数据配置文件)会导致同步后出现意外行为。 内容复制不支持节点类型筛选或增量更改;每次运行都是对定义的内容集进行完全刷新。

如何确认

  1. 确认环境流方向和您的权限。 在Cloud Manager中,转到Program → Environments,选择源和目标,并确认源是更高级别的环境(生产→暂存→ Dev → RDE)。 通过打开 →内容集 并验证其是否加载且没有访问被拒绝错误,确认您的用户拥有部署管理员和AEM管理员角色。

  2. 确定必须同步的JCR路径(页面、DAM资源、标记、体验片段和元数据配置文件),并包含相应的/conf路径以避免元数据或配置不匹配。 允许的路径包括:

    • /content/<b>
    • /conf/</b>
    • /etc/<b>
    • /var/workflow/models/</b>
    • /var/commerce/<b>

解决方法 resolution

  1. 在Cloud Manager中创建内容集。 转到程序→环境→内容集→添加内容集,添加所有必需的包含路径,并根据需要添加排除项。 打开内容集详细信息,并确认所有路径都符合您的要求。 如果UI阻止路径,请确认它是上述允许的路径之一。
  2. 启动内容复制流程。 在Cloud Manager →内容副本中,选择内容集以及源环境和目标环境,然后启动副本。 Cloud Manager使用源环境的卷快照来传输内容。 当目标环境在同步期间进入停机时间时,生产将保持完全可用。 监视进度,直到状态从​ 正在运行 ​变为​已完成
  3. . 要实现自动化,请使用Cloud Manager内容复制API 。 从外部调度程序通过Adobe I/O调用内容集API和内容流API,以每日、每周或每月运行流。 在Cloud Manager UI中确认显示的流具有与调度程序匹配的时间戳。 不支持增量同步,因此完整内容复制是唯一的方法。 验证目标环境。 登录到目标AEM作者,导航到示例内容路径和资源,并确认页面、DAM资源、元数据配置文件和体验片段反映源。 对于DAM元数据,请选择资产,打开属性→元数据,并确认已应用自定义架构。 如果元数据错误,请重新运行包含父/conf路径的内容副本。 . 将阶段作者同步到阶段发布。 在制作到暂存创作复制完成后,使用标准AEM创作到发布复制将内容复制到暂存发布。 通过检查发布者日志并打开已发布的URL,确认阶段发布中显示的内容。 如果未显示内容,请在Stage Author上验证复制代理。

验证

*1. 登录到目标AEM创作环境,并确认/content/下存在所有预期的内容。 2. 打开多个DAM资源并确认元数据架构正确且与生产环境匹配。 3. 如果使用自动化,请确认Cloud Manager内容流作业按预期时间间隔显示。### 相关阅读 内容复制工具

recommendation-more-help
experience-cloud-kcs-help-kbarticles