DocumentationAEMGuide de l’utilisateur

Migration de code assisté par l’IA vers AEM as a Cloud Service cloud-migration-skill-overview

Dernière mise à jour : 30 octobre 2026
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Développeur

La solution Migration du cloud est un ensemble d’outils basé sur des agents qui guide les développeurs tout au long de la migration du code Java AEM 6.x, AMS ou On-Premise et des configurations OSGi vers AEM as a Cloud Service (AEMaaCS). Il fonctionne dans tout IDE compatible avec l’IA qui prend en charge les compétences des agents et le protocole MCP (Model Context Protocol).

La vidéo de démonstration suivante fournit une présentation rapide de bout en bout de la solution de migration vers le cloud AEM et est incluse à titre de référence.

https://video.tv.adobe.com/v/3491440?captions=fre_fr&learn=on

La solution se compose de deux composants :

Composant
Rôle
Compétences en migration
Orchestre le workflow de migration, il identifie les résultats de l’analyseur de bonnes pratiques (BPA), identifie les fichiers affectés dans votre projet et applique les transformations de code motif par motif. Fonctionne avec une exportation CSV BPA locale ou avec le serveur MCP AEM (recommandé).
Serveur AEM MCP
Connecte votre agent IDE à Cloud Acceleration Manager (CAM), ce qui lui permet de récupérer directement les résultats BPA sans exportation CSV. Recommandé sur un fichier CSV local pour les résultats les plus récents.

Conditions préalables prerequisites

  • Un projet AEM (Maven ou Gradle) s’ouvre dans votre IDE

  • L’une des sources de recherche BPA suivantes (fortement recommandée, non requise pour les flux manuels) :

    • Une exportation CSV BPA à partir de votre instance AEM
    • Un projet ​​avec un rapport BPA chargé et le serveur AEM MCP configuré

La Compétence De Migration migration-skill

La compétence de migration est une compétence d’agent pour les IDE compatibles avec l’IA. Il orchestre un workflow un modèle par session : vous nommez le modèle à corriger, pointez l’agent vers vos résultats BPA, et l’agent lit les règles de transformation appropriées, localise les fichiers affectés dans votre projet et applique les modifications par lots de cinq, en pause de votre révision après chaque lot.

Commencer avec un Runbook de migration migration-runbook

Avant de corriger quoi que ce soit, demandez à l’agent de « Examiner mon code pour la migration AEMaaCS » Au lieu de modifier le code, la compétence génère un migration-runbook.md​ lecture seule à la racine de votre projet. Le runbook couvre chaque modèle de migration que la compétence peut traiter, répertoriant les fichiers affectés, le nombre de résultats par modèle et une invite de copier-coller pour démarrer chaque correctif.

Le runbook est le point d’entrée recommandé pour une évaluation de l’ensemble du projet : il vous donne une vue d’ensemble hiérarchisée et sans surprise de l’effort de migration avant la modification d’un fichier. Lorsque vous démarrez ultérieurement une session de modèles, l’agent réutilise les résultats déjà enregistrés dans le runbook, de sorte qu’aucune nouvelle analyse n’est nécessaire.

NOTE
Le runbook ne couvre que les modèles auxquels les compétences de migration peuvent répondre (ceux répertoriés sous ​ Modèles pris en charge ​). Les tâches de migration gérées en dehors de ces compétences, telles que la structure de référentiel ou le transfert de contenu, ne sont pas incluses. Consultez Comment ils s’intègrent dans le Parcours de migration pour obtenir des outils complémentaires.

Modèles pris en charge supported-patterns

Modèles de code et de configuration

Modèle
Ce qu’il corrige
scheduler
sling.commons.scheduler incompatibles avec l’exécution sans état d’AEMaaCS
resourceChangeListener
Implémentations ResourceChangeListener nécessitant des mises à jour de Cloud Service
replication
Appels d’API Replicator hérités remplacés par des équivalents ContentDistribution
eventListener
Implémentations EventListener OSGi mises à jour pour la sémantique d’événement AEMaaCS
eventHandler
Services de EventHandler OSGi synchrones adaptés à Cloud Service
assetApi
Appels d’API AssetManager et DAM obsolètes remplacés par des équivalents pris en charge
guavaCache
Utilisation du cache Guava (com.google.common.cache.*) remplacée par le cache Caféine pris en charge par Cloud Service
inputStream
Utilisation de java.io.InputStream triée par risque : les flux non fermés sont corrigés automatiquement, et des problèmes de mémoire, de système de fichiers et de diffusion en continu binaire sont proposés pour votre examen
htlLint
data-sly-test des avertissements de comparaison constante redondants dans les modèles HTL
oakIndex (bêta)
Définitions d’_oak_index héritées converties en définitions d’index Oak compatibles avec AEM as a Cloud Service à l’aide d’Adobe Index Converter, renommées en noms d’index avec version de Cloud Service (<name>-custom-<n>), avec une vérification de la compatibilité des types de données
Configurations OSGi
Conversion .cfg.json, définition de la portée du mode d’exécution, extraction des secrets Cloud Manager/env-var et détection et réorganisation sécurisées du mode d’exécution (URC) non pris en charge

Modèles hérités de modernisation de l’interface utilisateur et des modèles

Modèle
Ce qu’il corrige
lui (migration de boîte de dialogue)
Boîtes de dialogue IU classique/ExtJS (cq:Dialog) et Coral 2 converties en boîtes de dialogue d’IU tactile Coral 3
cdw (widgets de conception personnalisés)
Widgets ExtJS personnalisés (cq:Widget xtypes) mappés à Coral 3 ou générés en tant que composants de l’IU Granite
Modernisation des modèles
Modèles statiques convertis en modèles modifiables, avec la structure des outils de modernisation AEM, les composants et les règles de réécriture de politique générés. Détecte et classe les modèles statiques hérités et personnalisés, y compris les dossiers de modèles imbriqués.

Configuration de Dispatcher

Modèle
Ce qu’il corrige
dispatcherConversion
Configurations AMS ou Apache HTTPD et Dispatcher on-premise converties en structure AEM as a Cloud Service

Voir Conversion ​ pour le workflow.

Validation de la migration (version bêta)

Fonction
Effets
Validation d’une migration
Crée et déploie le code migré vers un SDK AEM as a Cloud Service local, puis vérifie le contrat de migration, le bundle et l’état des composants via le MCP de démarrage rapide d’AEM. Il ne modifie jamais votre code source.

Voir Validation d’une migration pour le workflow.

La compétence délègue toutes les étapes de transformation du code à la compétence code-assessment associée. Les deux sont distribués ensemble sous la forme du package de compétences aem-cloud-service ; installez le package une fois pour obtenir les deux.

Prise en main getting-started-skill

  1. Installez le package de compétences aem-cloud-service (qui comprend les compétences de migration et de code-assessment) à partir du référentiel de compétences Adobe. Pour les commandes d’installation par IDE, consultez Développement local avec les outils d’IA.

  2. Ouvrez votre projet AEM en tant que racine de l’espace de travail dans votre IDE.

  3. Obtenir des résultats BPA : exportez un fichier CSV à partir de BPA ou configurez le serveur MCP AEM (voir ci-dessous).

  4. Démarrez une session avec votre agent à l’aide de l’une des invites suivantes :

    Évaluer d’abord l’ensemble du projet (générer le runbook en lecture seule) :

    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

    CAM via MCP:

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

    Manuel (pas de BPA) :

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

    Configurations 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.

    Cache Guava :

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

    InputStream:

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

    Conversion Dispatcher :

    code language-none 
    Convert my AMS / on-prem Dispatcher config to AEM as a Cloud Service.

    conversion d’index Oak (version bêta) :

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

    Validation d’une migration (version bêta) :

    code language-none 
    Validate my scheduler migration on the local Cloud SDK.
NOTE
La compétence traite un modèle par session. Si votre rapport BPA contient plusieurs modèles, l’agent vous demande d’en choisir un avant de commencer.

Pour obtenir une référence complète aux modèles et des conseils sur la gestion des sessions, voir ​ Utilisation des compétences de migration vers le cloud ​.

Fonctionnalités MCP de la migration vers le cloud cloud-migration-mcp

Les fonctionnalités de migration vers le cloud d’AEM sont disponibles via le serveur AEM MCP, un serveur Model Context Protocol qui connecte votre agent IDE à Cloud Acceleration Manager. Une fois configurée, la compétence de migration peut récupérer les résultats BPA directement à partir de votre projet CAM sans nécessiter de téléchargement de CSV.

Avantages du MCP mcp-tools

Outil
Description
fetch-cam-bpa-findings-by-pattern
Renvoie les résultats BPA pour un modèle de migration de code spécifique à partir du dernier rapport BPA dans un projet CAM.
fetch-cam-bpa-findings-by-importance
Renvoie tous les résultats de l’analyseur de bonnes pratiques à une gravité donnée (CRITICAL, MAJOR, ADVISORY, INFO), triés par nombre. Utile pour établir la priorité des modèles à utiliser en premier.

Ces outils sont appelés automatiquement par la compétence de migration ; vous ne les appelez pas directement.

Prise en main getting-started-mcp

  1. Dans la configuration MCP de votre IDE, ajoutez l’URL du serveur MCP AEM : https://mcp.adobeaemcloud.com/adobe/mcp/aem ou utilisez une entrée existante avec cette URL.
  2. Lorsque vous y êtes invité, connectez-vous avec votre Adobe ID pour vous authentifier auprès de Cloud Acceleration Manager.
  3. Les compétences de migration peuvent désormais récupérer les résultats BPA directement à partir de vos projets CAM.

Pour obtenir une configuration et un dépannage détaillés, voir Utilisation des fonctionnalités de migration cloud du serveur MCP AEM.

Comment ils s’intègrent dans le Parcours de la migration migration-journey

Les compétences et le MCP complètent les autres outils de la phase de mise en œuvre :

Pour une vue d’ensemble, consultez la ​ Présentation de la phase d’implémentation ​.

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