文档AEM用户指南

人工智能辅助的代码迁移到AEM as a Cloud Service cloud-migration-skill-overview

最近更新： 2026年6月25日
  • 适用对象：
  • Experience Manager as a Cloud Service

创建对象：

  • Developer

AEM Cloud迁移​解决方案是基于代理的工具集，可指导开发人员将AEM 6.x、AMS或内部部署Java代码和OSGi配置迁移到​AEM as a Cloud Service (AEMaaCS)。 它可以在任何支持代理技能和模型上下文协议(MCP)且启用了AI的IDE中工作。

以下演示视频提供了AEM Cloud迁移解决方案的快速端到端演练，并包含在其中以供参考。

https://video.tv.adobe.com/v/3491448?captions=chi_hans&learn=on

解决方案包含两个组件：

组件
职位
迁移技能
协调迁移工作流，它会提供最佳实践分析器(BPA)调查结果，识别项目中受影响的文件，并按模式应用代码转换模式。 可与本地BPA CSV导出或云迁移MCP配合使用（推荐）。
云迁移MCP
将IDE代理连接到Cloud Acceleration Manager (CAM)，使其不通过CSV导出即可直接获取BPA调查结果。 建议通过本地CSV获取最新的调查结果。

先决条件 prerequisites

  • 在IDE中打开一个AEM项目（Maven或Gradle）

  • 以下BPA发现源之一（强烈推荐，手动流不需要它）：

    • 从您的AEM实例中导出​BPA CSV
    • 已上传的BPA报告并配置了云迁移MCP的​Cloud Acceleration Manager项目

迁移技能 migration-skill

迁移技能是启用AI的IDE的代理技能。 它协调一个​ 每个会话一个模式 ​工作流：您命名要修复的模式，将代理指向您的BPA查找结果，然后代理读取相关的转换规则，在您的项目中查找受影响的文件，并将更改分五批应用，每批应用之后暂停以供您审阅。

支持的模式 supported-patterns

图案
修复的内容
scheduler
基于sling.commons.scheduler的作业与AEMaaCS的无状态运行时不兼容
resourceChangeListener
ResourceChangeListener实施需要Cloud Service更新
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提取

该技能将所有代码转换步骤委派给伴侣code-assessment技能。 两者作为aem-cloud-service技能包一起分发；请安装一次该包以获取两者。

快速入门 getting-started-skill

  1. 从Adobe技能存储库安装aem-cloud-service技能包。

  2. 在IDE中打开AEM项目，作为工作区的根目录。

  3. 获取BPA调查结果：从BPA导出CSV或配置Cloud Migration MCP（请参阅下文）。

  4. 使用以下提示之一启动与代理的会话：

    BPA CSV：

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

    通过MCP的​CAM：

    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迁移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配置中，添加云迁移MCP服务器URL： https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration
  2. 出现提示时，请使用您的Adobe ID登录以针对Cloud Acceleration Manager进行身份验证。
  3. 迁移技能现在可以直接从CAM项目中获取BPA调查结果。

有关详细的设置和疑难解答，请参阅使用云迁移MCP。

它们如何适应迁移历程 migration-journey

技能和MCP补充了​ 实施阶段 ​中的其他工具：

  • 最佳实践分析器：生成可提升技能的调查结果。 请参阅使用最佳实践分析器。
  • Cloud Acceleration Manager：托管BPA报告并跟踪整体迁移进度。 请参阅CAM入门。
  • 重构工具：处理存储库结构和Dispatcher配置现代化。 请参阅重构工具概述。
  • 内容传输工具：将存储库内容从AEM 6.x迁移到AEMaaCS。

请参阅实施阶段概述以了解全貌。

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