ドキュメントAEMユーザーガイド

AEM AS A CLOUD SERVICEへのAIを活用したコードの移行 cloud-migration-skill-overview

最終更新日： 2026年6月25日
  • 適用対象：
  • 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 Migration ソリューションの簡単なエンドツーエンドのチュートリアルを紹介します。参照用に含まれています。

https://video.tv.adobe.com/v/3491439?captions=jpn&learn=on

このソリューションは、次の2つのコンポーネントで構成されています。

コンポーネント
役割
移行スキル
移行ワークフローのオーケストレーション、ベストプラクティスアナライザー（BPA）の調査結果の取得、プロジェクト内の影響を受けるファイルの特定、パターン別のコード変換パターンの適用を行います。 ローカル BPA CSV エクスポートまたはCloud Migration MCPで動作します（推奨）。
クラウド移行MCP
IDE エージェントをCloud Acceleration Manager（CAM）に接続し、CSV エクスポートを行わずにBPA結果を直接取得できるようにします。 最新の結果を得るには、ローカル CSVよりも推奨されます。

前提条件 prerequisites

  • IDEでAEM プロジェクト（MavenまたはGradle）を開く

  • 次のBPA検索ソースの1つ（強くお勧めします。手動フローには必要ありません）。

    • AEM インスタンスからの​BPA CSV エクスポート
    • BPA レポートがアップロードされ、Cloud Migration MCPが設定された​Cloud Acceleration Manager プロジェクト

移行スキル migration-skill

移行スキルは、AI対応IDEのエージェントスキルです。 このワークフローは、one-pattern-per-session ワークフローを編成します。修正するパターンに名前を付け、BPAの調査結果にエージェントを指定すると、エージェントは関連する変換ルールを読み取り、プロジェクト内の影響を受けるファイルを見つけ、変更を5つのバッチに適用し、各バッチの後にレビューを一時停止します。

サポートされるパターン supported-patterns

パターン
修正点
scheduler
sling.commons.scheduler ベースのジョブは、AEMaaCSのステートレスランタイムと互換性がありません
resourceChangeListener
Cloud Serviceの更新が必要なResourceChangeListener実装
replication
従来のReplicator API呼び出しはContentDistribution個の同等のものに置き換えられました
eventListener
OSGi EventListener実装がAEMaaCS イベントセマンティクス用に更新されました
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 スキルパッケージとして一緒に配布されます。両方を取得するには、パッケージを1回インストールしてください。

はじめに getting-started-skill

  1. Adobe スキルリポジトリ ​からaem-cloud-service スキルパッケージをインストールします。

  2. AEM プロジェクトをIDEのワークスペースルートとして開きます。

  3. BPA調査結果の取得：BPAからCSVをエクスポートするか、クラウド移行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
スキルは、セッションごとに1つのパターンを処理します。 BPA レポートに複数のパターンが含まれる場合、開始する前に1つを選択するように求められます。

完全なパターン参照とセッション管理ガイダンスについては、​ クラウド移行スキルの使用を参照してください。

クラウド移行MCP cloud-migration-mcp

AEM Cloud Migration MCP​は、IDE エージェントをCloud Acceleration Managerに接続するModel Context Protocol サーバーです。 移行スキルを設定すると、CSV ダウンロードを必要とせずに、CAM プロジェクトからBPA結果を直接取得できます。

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は、実装フェーズ​の他のツールを補完します。

全体像については、実装フェーズの概要を参照してください。

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