DokumentationAEMBenutzerhandbuch

KI-gestützte Code-Migration zu AEM as a Cloud Service cloud-migration-skill-overview

Letzte Aktualisierung: 2. September 2026
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Developer

Die AEM Cloud Migration-Lösung ist ein agentenbasiertes Toolset, das Entwicklerinnen und Entwickler durch die Migration von AEM 6.x, AMS oder On-Premise-Java-Code und OSGi-Konfigurationen zu AEM as a Cloud Service (AEMaaCS). Es funktioniert in jeder KI-aktivierten IDE, die Agentenfähigkeiten unterstützt, und im Model Context Protocol (MCP).

Das folgende Demovideo bietet eine kurze Beschreibung der AEM Cloud-Migrationslösung und ist als Referenz enthalten.

https://video.tv.adobe.com/v/3491447?captions=ger&learn=on

Die Lösung besteht aus zwei Komponenten:

Komponente
Rolle
Migrationsfertigkeit
Orchestriert den Migrations-Workflow, ruft Best Practices Analyzer (BPA)-Ergebnisse ab, identifiziert betroffene Dateien in Ihrem Projekt und wendet Code-Umwandlungen musterweise an. Funktioniert mit einem lokalen BPA-CSV-Export oder mit dem Cloud Migration MCP (empfohlen).
Cloud-Migration - MCP
Verbindet Ihren IDE-Agenten mit Cloud Acceleration Manager (CAM), sodass er BPA-Ergebnisse direkt ohne CSV-Export abrufen kann. Wird anstelle einer lokalen CSV-Datei für die aktuellsten Ergebnisse empfohlen.

Voraussetzungen prerequisites

  • Ein AEM-Projekt (Maven oder Gradle), das in Ihrer IDE geöffnet ist

  • Eine der folgenden BPA-Suchquellen (wird dringend empfohlen, ist für manuelle Flüsse nicht erforderlich):

    • Ein BPA-CSV- aus Ihrer AEM-Instanz
    • Ein Cloud Acceleration Manager-Projekt mit hochgeladenem BPA-Bericht und konfiguriertem MCP für die Cloud-Migration

Die Migrationsfertigkeit migration-skill

Die Migrationsfertigkeit ist eine Agentenfertigkeit für KI-aktivierte IDEs. Er orchestriert einen ein-Muster-pro-Sitzung-Workflow: Sie benennen das zu behebende Muster, verweisen den Agenten auf Ihre BPA-Ergebnisse, und der Agent liest die relevanten Umwandlungsregeln, findet die betroffenen Dateien in Ihrem Projekt und wendet die Änderungen in Batches von jeweils fünf an und hält Sie nach jedem Batch zur Überprüfung an.

Beginnen Sie mit einer Runbook-Migration migration-runbook

Bevor Sie etwas beheben, bitten Sie den Agenten, „Meinen Code für die AEMaaCS-Migration zu ". Anstatt Code zu bearbeiten, generiert die Qualifikation eine schreibgeschütztemigration-runbook.md an Ihrem Projektstamm. Das Runbook behandelt jedes Migrationsmuster, das die Qualifikation adressieren kann, listet die betroffenen Dateien auf, zählt die Anzahl der Mustersuchvorgänge und gibt eine Aufforderung zum Kopieren und Einfügen zum Starten jeder Korrektur.

Das Runbook ist der empfohlene Einstiegspunkt für eine Gesamtprojektbewertung: Es bietet Ihnen ein priorisiertes, nicht überraschendes Bild des Migrationsaufwands, bevor irgendeine Datei geändert wird. Wenn Sie später eine Mustersitzung starten, verwendet der Agent die bereits im Runbook aufgezeichneten Ergebnisse erneut, sodass keine erneute Suche erforderlich ist.

NOTE
Das Runbook behandelt nur die Muster, die die Migrationsfertigkeit ansprechen kann (die unter "​ Muster“ ​). Migrationsaufgaben, die außerhalb dieser Fähigkeiten durchgeführt werden, wie Repository-Struktur, Dispatcher-Konfiguration oder Inhaltstransfer, sind nicht enthalten. Siehe So passen sie in die Migrations-Journey für die zusätzlichen Tools.

Unterstützte Muster supported-patterns

Code- und Konfigurationsmuster

Muster
Fehlerbehebungen
scheduler
sling.commons.scheduler Aufträge sind mit der statuslosen -Laufzeit von AEMaaCS nicht kompatibel
resourceChangeListener
ResourceChangeListener Implementierungen, die Cloud Service-Updates erfordern
replication
Alte Replicator API-Aufrufe wurden durch ContentDistribution Äquivalente ersetzt
eventListener
Aktualisierte OSGi-EventListener für die AEMaaCS-Ereignissemantik
eventHandler
Für Cloud Service angepasste synchrone OSGi-EventHandler
assetApi
Veraltete AssetManager- und DAM-API-Aufrufe wurden durch unterstützte Entsprechungen ersetzt
htlLint
data-sly-test von redundanten, konstanten Vergleichswarnungen in HTL-Vorlagen
OSGi-Konfigurationen
.cfg.json, Berechnung des Ausführungsmodus und Extraktion von Cloud Manager-Geheimnissen/env-var

Modernisierungsmuster für veraltete Benutzeroberflächen und Vorlagen

Muster
Fehlerbehebungen
lui (Dialogfeldmigration)
Die Dialogfelder der klassischen Benutzeroberfläche/ExtJS (cq:Dialog) und der Coral 2-Benutzeroberfläche wurden in Dialogfelder der Coral 3-Touch-Benutzeroberfläche konvertiert
cdw (benutzerdefinierte Design-Widgets)
Benutzerdefinierte ExtJS-Widgets (cq:Widget xtypes), die Coral 3 zugeordnet sind oder als Granite-UI-Komponenten strukturiert sind
Vorlagenmodernisierung
Statische Vorlagen werden in bearbeitbare Vorlagen konvertiert, wobei die Struktur-, Komponenten- und Richtlinienumschreibungsregeln für die AEM-Modernisierungs-Tools generiert werden

Die Qualifikation delegiert alle Code-Umwandlungsschritte an die Companion-code-assessment-Qualifikation. Beide werden zusammen als das Paket für aem-cloud-service Kenntnisse verteilt. Installieren Sie das Paket einmal, um beide zu erhalten.

Erste Schritte getting-started-skill

  1. Installieren Sie das Paket aem-cloud-service (das sowohl die Migrations- als auch die code-assessment Kenntnisse umfasst) aus dem Adobe Skills Repository. Informationen zu einzelnen IDE-Installationsbefehlen finden Sie unter Lokale Entwicklung mit KI-.

  2. Öffnen Sie Ihr AEM-Projekt als Workspace-Stamm in Ihrer IDE.

  3. Abrufen von BPA-Ergebnissen: Exportieren Sie eine CSV-Datei aus BPA oder konfigurieren Sie die MCP für die Cloud-Migration (siehe unten).

  4. Starten Sie eine Sitzung mit Ihrem Agenten über eine der folgenden Eingabeaufforderungen:

    Bewerten Sie zunächst das gesamte Projekt (generiert das schreibgeschützte 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

    CAM über MCP:

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

    Manuell (kein BPA):

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

    OSGi-Konfigurationen:

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

    HTL-Link:

    code language-none 
    Fix htlLint in ui.apps - scan for data-sly-test redundant constant warnings.
NOTE
Die Qualifikation verarbeitet ein Muster pro Sitzung. Wenn Ihr BPA-Bericht mehrere Muster enthält, werden Sie vom Agenten aufgefordert, eines auszuwählen, bevor Sie beginnen.

Eine vollständige Anleitung zum Pattern-Referenzhandbuch und zur Sitzungsverwaltung finden Sie unter Verwenden der Cloud-Migrationsfertigkeit.

MCP der Cloud-Migration cloud-migration-mcp

Der AEM Cloud Migration MCP ist ein Model Context Protocol-Server, der Ihren IDE-Agenten mit Cloud Acceleration Manager verbindet. Wenn konfiguriert, kann die Migrationskompetenz BPA-Ergebnisse direkt aus Ihrem CAM-Projekt abrufen, ohne dass ein CSV-Download erforderlich ist.

Was der MCP bietet mcp-tools

Tool
Beschreibung
fetch-cam-bpa-findings-by-pattern
Gibt BPA-Ergebnisse für ein bestimmtes Code-Migrationsmuster aus dem neuesten BPA-Bericht in einem CAM-Projekt zurück.
fetch-cam-bpa-findings-by-importance
Gibt alle BPA-Ergebnisse mit einem bestimmten Schweregrad (CRITICAL, MAJOR, ADVISORY, INFO) zurück, sortiert nach Anzahl. Nützlich für die Priorisierung, welche Muster zuerst bearbeitet werden sollen.

Diese Tools werden automatisch von der Migrationsfertigkeit aufgerufen. Sie rufen sie nicht direkt auf.

Erste Schritte getting-started-mcp

  1. Fügen Sie in der MCP-Konfiguration Ihrer IDE die MCP-Server-URL der Cloud-Migration hinzu: https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration
  2. Melden Sie sich bei Aufforderung mit Ihrer Adobe ID an, um sich bei Cloud Acceleration Manager zu authentifizieren.
  3. Die Migrationsfertigkeit kann jetzt BPA-Ergebnisse direkt aus Ihren CAM-Projekten abrufen.

Detaillierte Informationen zu Setup und Fehlerbehebung finden Sie unter Verwenden des Cloud Migration MCP.

So passen sie in die Migrations-Journey migration-journey

Die Kenntnisse und das MCP ergänzen die anderen Tools in der Implementierungsphase:

  • Best Practices Analyzer: Erzeugt die Ergebnisse, die zu den neuen Fähigkeiten beitragen. Siehe Verwenden von Best Practices Analyzer.
  • Cloud Acceleration Manager: hostet BPA-Berichte und verfolgt den gesamten Migrationsfortschritt. Siehe ​ Schritte mit CAM.
  • Refaktorierungs-Tools: Übernimmt die Modernisierung der Repository-Struktur und Dispatcher-Konfiguration. Siehe Übersicht über die Umgestaltungs-Tools.
  • Content Transfer Tool: Migriert Repository-Inhalte von AEM 6.x auf AEMaaCS.

Umfassende Informationen finden Sie ​ „Übersicht ​ Implementierungsphase“.

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