文件AEM使用手冊

AI輔助程式碼移轉至AEM as a Cloud Service cloud-migration-skill-overview

最後更新： 2026年5月28日
  • 適用對象：
  • Experience Manager as a Cloud Service

建立對象：

  • Developer

AEM Cloud Migration​解決方案是代理程式型工具集，可引導開發人員將AEM 6.x、AMS或內部部署Java程式碼和OSGi設定移轉至​AEM as a Cloud Service (AEMaaCS)。 它可在任何支援代理程式技能和模型內容通訊協定(MCP)的AI啟用IDE中運作。

下列示範影片提供AEM Cloud移轉解決方案的快速端對端逐步解說，並隨附以供參考。

https://video.tv.adobe.com/v/3491449?captions=chi_hant&learn=on

解決方案包含兩個元件：

元件
角色
移轉技能
協調移轉工作流程、取得Best Practices Analyzer (BPA)發現、識別專案中受影響的檔案，並依模式套用程式碼轉換模式。 適用於本機BPA CSV匯出或雲端移轉MCP （建議）。
雲端移轉MCP
將IDE代理程式連線至Cloud Acceleration Manager (CAM)，使其可直接擷取BPA發現，而無需CSV匯出。 建議透過本機CSV取得最新的發現。

先決條件 prerequisites

  • 在IDE中開啟的AEM專案（Maven或Gradle）

  • 下列其中一個BPA尋找來源（強烈建議，手動流程不需要）：

    • 從您的AEM執行個體匯出​BPA CSV
    • 已上傳並設定雲端移轉MCP的​Cloud Acceleration Manager專案

移轉技能 migration-skill

移轉技能是啟用AI之IDE的代理程式技能。 它會協調​ 每個工作階段一個模式 ​工作流程：您命名要修正的模式、將代理程式指向您的BPA發現，然後代理程式會讀取相關的轉換規則、在您的專案中找出受影響的檔案，並將變更套用為五批次的批次，並在每個批次之後暫停以供您檢閱。

支援的模式 supported-patterns

模式
修正內容
scheduler
sling.commons.scheduler工作與AEMaaCS的無狀態執行階段不相容
resourceChangeListener
需要Cloud Service更新的ResourceChangeListener實作
replication
舊版Replicator API呼叫已由ContentDistribution個對等呼叫取代
eventListener
已針對AEMaaCS事件語意更新OSGi EventListener實作
eventHandler
針對Cloud Service調整的同步OSGi EventHandler服務
assetApi
已棄用的AssetManager和DAM API呼叫已取代為支援的同等呼叫
htlLint
HTL範本中有data-sly-test個備援常數比較警告
OSGi設定
.cfg.json轉換、執行模式範圍設定和Cloud Manager機密/env-var擷取

此技能將所有程式碼轉換步驟委派給同伴best-practices技能。 兩者會以aem-cloud-service技能套件一起發佈；請安裝套件一次以取得兩者。

快速入門 getting-started-skill

  1. 從Adobe技能存放庫安裝aem-cloud-service技能套件。

  2. 在IDE中開啟您的AEM專案，作為工作區根目錄。

  3. 取得BPA發現：從BPA匯出CSV或設定雲端移轉MCP （請參閱下文）。

  4. 使用以下其中一個提示，與您的代理程式開始工作階段：

    BPA CSV：

    code language-none 
    Use the migration skill: scheduler only, BPA CSV at ./reports/bpa.csv

    透過MCP的攝影機：

    code language-none 
    Fix replictaion findings from project <projectname>/<projectId>.

    手動（無BPA）：

    code language-none 
    Migrate event listener in core/src/main/java/com/example/Listener.java

    OSGi設定：

    code language-none 
    Scan my config files and create Cloud Manager environment secrets or variables.

    HTL Lint：

    code language-none 
    Fix htlLint in ui.apps - scan for data-sly-test redundant constant warnings.
NOTE
此技能會為每個工作階段處理一個模式。 如果您的BPA報表包含多個模式，代理程式會要求您在開始前挑選一個模式。

如需完整的模式參考和工作階段管理指南，請參閱使用雲端移轉技能。

雲端移轉MCP cloud-migration-mcp

AEM Cloud Migration MCP​是將IDE代理程式連線到Cloud Acceleration Manager的模型內容通訊協定伺服器。 設定後，移轉技能可以直接從CAM專案擷取BPA發現，而不需要下載CSV。

MCP提供的功能 mcp-tools

工具
說明
fetch-cam-bpa-findings-by-pattern
從CAM專案的最新BPA報告，傳回特定程式碼移轉模式的BPA發現。
fetch-cam-bpa-findings-by-importance
傳回指定嚴重度(CRITICAL， MAJOR， ADVISORY， INFO)的所有BPA發現（依計數排序）。 有助於排定優先順序，以優先處理哪些模式。

移轉技能會自動叫用這些工具；您不會直接呼叫它們。

快速入門 getting-started-mcp

  1. 在IDE的MCP設定中，新增Cloud Migration MCP伺服器URL： https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration
  2. 出現提示時，請使用您的Adobe ID登入，以針對Cloud Acceleration Manager進行驗證。
  3. 移轉技能現在可以直接從CAM專案擷取BPA發現。

如需詳細的設定和疑難排解，請參閱使用雲端移轉MCP。

他們如何適應移轉歷程 migration-journey

技能和MCP補充了​ 實作階段 ​中的其他工具：

  • 最佳做法分析工具：產生推動技能的發現。 請參閱使用Best Practices Analyzer。
  • Cloud Acceleration Manager：主控BPA報告並追蹤整體移轉進度。 請參閱CAM快速入門。
  • 重構工具：處理存放庫結構和Dispatcher設定現代化。 請參閱重構工具總覽。
  • 內容轉移工具：將存放庫內容從AEM 6.x移轉到AEMaaCS。

如需完整資訊，請參閱實作階段概觀。

recommendation-more-help
experience-manager-cloud-service-help-main-toc