文档AEM用户指南

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

最近更新： 2026年9月17日
  • 适用对象：
  • 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查找结果，然后代理读取相关的转换规则，在您的项目中查找受影响的文件，并将更改分五批应用，每批应用之后暂停以供您审阅。

从迁移Runbook开始 migration-runbook

在解决任何问题之前，请让代理​“查看我的AEMaaCS迁移代码”。 该技能会在项目根目录中生成​只读migration-runbook.md，而不是编辑代码。 Runbook涵盖​ 技能可处理的每 ​个迁移模式，列出受影响的文件、每个模式的查找计数，以及启动每个修复的复制粘贴提示。

Runbook是进行整个项目评估的推荐入口点：它为您提供了在任何文件更改之前迁移工作的优先级，而不会让人感到意外。 在稍后启动模式会话时，代理会重用已在Runbook中记录的调查结果，因此无需重新扫描。

NOTE
Runbook仅涵盖迁移技能可处理的模式（支持的模式下列出的模式）。 在这些技能之外处理的迁移工作（如存储库结构或内容传输）不包括在内。 查看它们如何适应迁移历程🔗，以了解补充工具。

支持的模式 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调用已替换为支持的等效调用
guavaCache
已将Guava缓存(com.google.common.cache.*)使用情况交换为Cloud Service支持的咖啡因缓存
htlLint
HTL模板中data-sly-test个冗余常量比较警告
OSGi配置
.cfg.json转化、运行模式范围、Cloud Manager密钥/env-var提取，以及不受支持的运行模式(URC)检测和安全重新排序

旧版UI和模板现代化模式

图案
修复的内容
lui （对话框迁移）
经典UI/ExtJS (cq:Dialog)和Coral 2对话框转换为Coral 3 Touch UI对话框
cdw （自定义设计小组件）
自定义ExtJS小组件(cq:Widget xtypes)映射到Coral 3或作为Granite UI组件构建基架
模板现代化
静态模板转换为可编辑模板，并生成AEM现代化工具结构、组件和策略重写规则。 检测和分类旧版和自定义静态模板，包括嵌套模板文件夹

Dispatcher 配置

图案
修复的内容
dispatcherConversion
转换为AEM as a Cloud Service结构的AMS或内部部署Apache HTTPD和Dispatcher配置

请参阅工作流的Dispatcher转换。

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

快速入门 getting-started-skill

  1. 从Adobe技能存储库安装aem-cloud-service技能包（包括迁移和code-assessment技能）。 有关每个IDE的安装命令，请参阅使用AI工具进行本地开发。

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

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

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

    首先评估整个项目（生成只读Runbook）：

    code language-none 
    Review my code for AEMaaCS migration

    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.

    Guava缓存：

    code language-none 
    Fix guavaCache findings using BPA CSV at ./reports/bpa.csv

    Dispatcher转换：

    code language-none 
    Convert my AMS / on-prem Dispatcher config to AEM as a Cloud Service.
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