文件Experience Cloud KCS

使用內容複製工具同步AEM環境內容

最後更新： 2026年6月24日

使用內容複製工具時，如果沒有其相依的設定路徑或針對不支援的流程方向，在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 （內容集和內容副本）

問題/症狀：

  • 複製到階段的內容會顯示不正確的中繼資料結構或預設值。
  • 由於缺少許可權（部署管理員加上AEM管理員）或環境流程方向無法使用，無法起始內容複製操作。
  • 除非明確啟用「正向流程」，否則使用者無法從較低環境複製到較高環境，例如從開發複製到階段或開發複製到生產環境。
  • 自動化嘗試失敗，因為內容副本沒有內建排程器。
  • 套件式同步需要太長或失敗，因為DAM大小超過AEM套件限制。

根本原因：

AEMaaCS使用不可變程式碼和可變內容的分離，因此環境內容無法直接在存放庫層級複製。 支援的機制是使用「內容複製」工具進行路徑型複製，此工具會覆寫目標內容以符合JCR路徑、在路徑不同時合併，且只能從較高到較低環境運作（除非為非生產流程啟用「正向流量」）。 缺少相依路徑（例如/conf個中繼資料設定檔）會導致同步後出現非預期的行為。 內容複製不支援節點型別篩選或增量變更；每次執行都是定義內容集的完整重新整理。

如何確認

  1. 確認環境流程方向和您的許可權。 在Cloud Manager中，移至程式→環境，選取來源和目標兩者，並確認來源是較高層級的環境（生產→階段→開發→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路徑的內容復本。 . 將Stage Author同步至Stage Publish。 生產到階段製作複製完成後，請使用標準AEM製作到發佈復寫將內容復寫到階段發佈。 透過檢查發佈者記錄檔並開啟已發佈的URL，確認出現在「階段發佈」中的內容。 如果內容未出現，請驗證Stage Author上的復寫代理。

驗證

*1. 登入目標AEM Author環境，並確認/content/下存在所有預期的內容。 2. 開啟多個DAM資產並確認中繼資料結構正確且符合生產環境。 3. 如果使用自動化，請確認Cloud Manager內容流程工作會以預期的時間間隔顯示。### 相關閱讀 內容複製工具

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