Checkliste für die Kundenbereitschaft
Verwenden Sie diese Checkliste, um sich mit dem Tool für die Massendatenmigration auf eine Datenmigration von einer Adobe Commerce on Cloud oder lokalen Instanz Adobe Commerce as a Cloud Service vorzubereiten.
Das Migrations-Tool wird als Teil des Interaktionsprozesses mit dem von Commerce bereitgestellten Engineering (CDE) bereitgestellt. Der Zugriff auf das Tool erfolgt aufgrund einer unterzeichneten CDE-Vereinbarung und ist nicht öffentlich verfügbar.
Diese Checkliste enthält, was vor der Freigabe des Tools vorhanden sein muss (Schritt 1) und was Sie benötigen, um mit der Konfiguration und Ausführung des Tools zu beginnen, sobald Sie das Tool haben (Schritt 2). Überprüfen Sie diese Checkliste frühzeitig mit Ihrem Adobe-Team, da einige Elemente die Koordinierung mit Adobe erfordern.
Schritt 1: vor dem Tool-Zugriff
Füllen Sie Folgendes aus oder bestätigen Sie es, bevor Sie das Migrations-Tool und die Dokumentation bereitstellen.
- CDE-: Eine unterzeichnete, von Commerce bereitgestellte Entwicklungsvereinbarung muss vorhanden sein. Der Tool-Zugriff wird beim Abschluss-Sign-Schritt des Code-Lebenszyklus gewährt. Abstimmung mit Ihrem Adobe-Team
- Scoping Questionnaire Completed - Während der CDE-Ermittlung wird ein Scoping-Fragebogen ausgefüllt, um zu bestätigen, dass die Migration mit den aktuellen Tool-Funktionen durchführbar ist, und um den Datenspeicherbedarf und die Komplexität zu bewerten. Stellen Sie sicher, dass Sie dies mit Ihrem Adobe-Team abschließen, bevor Sie fortfahren.
- Keine HIPAA-Daten bestätigt - Die Quellinstanz darf keine HIPAA-regulierten Daten enthalten. Bestätigen Sie dies, bevor Sie fortfahren.
- Bereitgestellte IP-: Geben Sie Ihrem Adobe-Team die Liste der statischen IP-Adressen, von denen aus das Migrations-Tool ausgeführt werden soll. Dies ist erforderlich, damit der Netzwerkzugriff auf der Adobe-Seite konfiguriert werden kann.
- Zielinstanz bereitgestellt - Die Zielinstanz muss Adobe Commerce as a Cloud Service bereitgestellt werden, bevor die Migration beginnt. Stimmen Sie sich mit Ihrem Adobe-Team ab, um zu bestätigen, dass die Instanz bereit ist.
Schritt 2: vor Ausführung der Migration
Nachdem Sie Zugriff auf das Tool haben, sollten Sie die folgenden Elemente vorbereiten, bevor Sie mit der Konfiguration und Ausführung beginnen.
Migrationsmaschine
Das Migrations-Tool wird auf einem von Ihnen gesteuerten Computer ausgeführt, z. B. auf einem speziellen Sprungfeld. Diese Maschine muss folgende Anforderungen erfüllen.
- Dockerund Docker Compose installiert - Das Tool ist Docker. Sowohl
dockerals auchdocker compose(oder die veraltetedocker-compose) müssen auf dem Migrationsrechner installiert sein und funktionieren. - DockerAusführungsberechtigungen - Der Benutzer, der die Migration ausführt, muss berechtigt sein, Docker Befehle auszuführen. Am Linux muss der Benutzer in der
dockersein. Auf macOS und Windows muss Docker Desktop ausgeführt werden und zugänglich sein. - Schreibfähiger Arbeitsordner - Das Verzeichnis, in das das Migrations-Tool extrahiert wird, muss vom Migrationsbenutzer vollständig schreibbar sein. Das Tool schreibt Protokolle, Cache, Composer und generierte Dateien während der Ausführung.
- Ausreichend Speicherplatz - Stellen Sie sicher, dass ausreichend freier Speicherplatz für extrahierte Daten, Docker Bilder und Protokollausgaben vorhanden ist. Der erforderliche Speicherplatz hängt von der Größe der Quelldatenbank ab.
- On-Premise-Quellen: Direkte Datenbankkonnektivität vom Migrationsrechner - Für lokale Quellinstanzen muss der Migrationsrechner über direkten Netzwerkzugriff auf die Quelldatenbank verfügen. Das Tool stellt nicht automatisch eine lokale Datenbankkonnektivität her. Vergewissern Sie sich, dass der Host, der Port und die Anmeldeinformationen vom Migrationscomputer aus erreichbar sind, bevor Sie einen Migrationsbefehl ausführen.
- Cloud-CLI installiert und SSH-Schlüssel registriert - Für Adobe Commerce on Cloud Quellinstanzen muss die Cloud-CLI auf dem Migrationsrechner installiert sein. Ihr öffentlicher SSH-Schlüssel muss ebenfalls in Ihrem Konto registriert sein. Anweisungen finden Sie „Handbuch gesicherter Verbindungen“.
Source-Instanz
- Zugriff auf Source Store-APIs — Der Zugriff auf die REST- und GraphQL-APIs des Quellspeichers muss vom Migrationsrechner aus möglich sein. Stellen Sie sicher, dass keine HTTP-Autorisierungs- oder Netzwerkeinschränkung den API-Traffic an die Quell-URL blockiert.
- Source OAuth-Anmeldeinformationen - Das Migrations-Tool verwendet OAuth zur Authentifizierung beim Quellspeicher. Erstellen oder bestätigen Sie eine Integration in der Quelle Admin (System > Erweiterungen > Integrations) und halten Sie den Consumer Key, das Consumer Secret, das Access Token und das Access Token Secret bereit.
- PaaS-Quellen: Magento Cloud-API Token - Generieren Sie ein Cloud-API-Token aus Ihren Cloud-Kontoeinstellungen unter Kontoeinstellungen > API-Token. Nur erforderlich, wenn die Quelle eine Adobe Commerce on Cloud ist.
- Source-Datenbankanmeldeinformationen - (nur On-Premise) Die Details der Quell- MySQL Datenbankverbindung müssen konfiguriert werden:
host,port,user,passwordunddatabase. - Möglichkeit, Cron anzuhalten - Sie müssen in der Lage sein, Cron auf der Quellinstanz für die Dauer der Datenextraktion zu stoppen, um gleichzeitige Schreibvorgänge zu verhindern.
- Möglichkeit, Integrationen und Hintergrundaufträge anzuhalten - Alle Drittanbieterintegrationen (ERP, OMS, PIM), geplanten Aufträge oder Hintergrundprozesse, die in die Quelldatenbank schreiben, müssen für das Extraktionsfenster angehalten werden.
- Möglichkeit, den Wartungsmodus zu aktivieren und zu deaktivieren - (Nur stufenweise Migration) Wenn Sie eine stufenweise Migration mit einem Wartungsfenster ausführen, müssen Sie in der Lage sein, den Wartungsmodus auf der Quellinstanz zu aktivieren und zu deaktivieren.
Zielinstanz
- Mandanten-ID und Organisations-ID bestätigt - Beziehen Sie vor der Konfiguration Ihre
TARGET_TENANT_IDundTARGET_ORG_IDvon Ihrem Adobe-Team. - IMS OAuth Server-zu-Server-Anmeldeinformationen - Erforderlich, damit sich das Migrations-Tool beim Ziel authentifizieren kann. Generiert über die Adobe Developer Console. Sie benötigen Developer oder Admin Zugriff auf Ihre Adobe-Organisation, da der einfache Benutzerzugriff zum Erstellen von Anmeldeinformationen nicht ausreicht. Stimmen Sie sich mit Ihrem Adobe-Team ab, um das richtige Produktprofil auszuwählen, und halten Sie die Client-ID (
ADOBE_IMS_CLIENT_ID) und das Client-Geheimnis (ADOBE_IMS_CLIENT_SECRET) bereit. - CDMS-Endpunkt-URL - von Ihrem Adobe-Team bereitgestellt. Versuchen Sie nicht, diesen Wert abzuleiten. Sie benötigen sowohl den Vorproduktions-Endpunkt für Sandbox- und Testmigrationen als auch den Produktions-Endpunkt für Live-Cutover-Migrationen.
- Kernkonfiguration, die zwischen Quelle und Ziel abgestimmt ist - Kernkonfigurationsdaten wie Store-Einstellungen und Systemkonfiguration werden vom Tool nicht migriert. Richten Sie sie vor der Migration manuell auf dem Ziel so ein, dass sie mit der Quelle übereinstimmt.
- B2B-Stores: B2B-Funktionen konsistent konfiguriert - Wenn die Quelle ein B2B-fähiger Store ist, stellen Sie sicher, dass die relevanten B2B-Admin-Einstellungen vor der Migration sowohl auf der Quelle als auch auf dem Ziel konsistent konfiguriert sind. Die erforderlichen Einstellungen finden Sie Migrationshandbuch .
Migrationsplanung
-
Migrationsansatz entschieden - Bestimmen Sie vor dem Start, welcher Ansatz zu Ihrem Anwendungsfall passt.
- Einphasige Migration - kein Wartungsmodus erforderlich. Eignet sich für Trockenläufe, Entwicklungs- oder Sandbox-Umgebungen oder jede Migration, bei der die Quelle während der Extraktion live bleiben kann.
- Mehrphasenmigration - Wartungsmodus ist erforderlich. Eine mehrphasige Migration ist für Produktionsmigrationen erforderlich, bei denen die Quelle während der Extraktion eingefroren werden muss, um die Datenkonsistenz sicherzustellen.
-
Wartungsfenster geplant — Gilt nur für mehrphasige Migrationen. Planen und kommunizieren Sie das Wartungsfenster im Voraus. Die Quellinstanz steht Endbenutzern während der Extraktions- und Ladephasen nicht zur Verfügung.
-
Store-Ansicht-Code bestätigt - Identifizieren Sie den Store-Ansicht-Code (
STORE_CODE) in der Quellinstanz. Standardmäßig istdefaultfestgelegt, aber der tatsächliche Code muss unter Admin > Stores > All Stores übereinstimmen. Ein falscher Speicher-Code kann Datenvorgänge während der Migration beeinträchtigen.
Nachdem Sie alle Elemente bestätigt haben, können Sie den Zugriff auf den Service mit dem Migrationshandbuch für den Service überprüfen und dann die Konfigurations- und Ausführungsschritte im Migrationshandbuch starten.