DokumentationAEMBenutzerhandbuch

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

Letzte Aktualisierung: 28. Mai 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.

Unterstützte Muster supported-patterns

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

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 aem-cloud-service Skill-Paket aus dem Adobe Skills Repository.

  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:

    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