Installeer de migratiemodule | Handleiding voor Adobe Commerce-ontwikkelaars

De migratiemodule is een componistenpakket dat wordt gehost in onze repository. Dit pakket is alleen beschikbaar voor mensen met Commerce-toegangssleutels.

We raden aan om de module in een ontwikkelomgeving te gebruiken voordat u deze in de productieomgeving implementeert. We raden ook aan om voldoende back-ups te maken voordat u enige vorm van contentmigratie voltooit.

Vereisten

Voordat u de migratiemodule installeert, moet u de omgeving voorbereiden die u wilt migreren:

BlueFoot bevat geen verwijderscripts, maar we bewaren uw gegevens bij het verwijderen wel.

• Upgrade naar Magento Commerce 2.3.1 (inclusief Page Builder).

Raadpleeg onze Command-line upgrade-instructies over hoe u dit kunt voltooien. Page Builder zelf converteert uw inhoud niet. We behouden uw bestaande BlueFoot-inhoud wanneer we Page Builder installeren.

Componist installatie

De migratiemodule installeren:

1. Navigeer naar de hoofdmap van uw Magento 2.3.1-installatie.

2. Gebruik het volgende componist-commando:

   1
   
   
   
   composer require magento/module-page-builder-data-migration
   
   
   
   
   
   

3. Schakel de standaardfunctie voor migratie bij implementatie uit.

   Deze stap is van cruciaal belang voor ontwikkelingswerk op het gebied van migratie. Het schakelt het standaardgedrag van de migratiemodule uit waarmee uw inhoud wordt gemigreerd als onderdeel van de implementatie met: setup:upgrade. We hebben dit het standaardgedrag gemaakt, zodat implementatie naar productie eenvoudig is. Maar tijdens de ontwikkeling moet u het uitschakelen, zodat u uw migraties niet per ongeluk uitvoert, voordat u strategische wijzigingen in uw migratiecode of back-ups naar uw database hebt aangebracht.

Na het voltooien van deze stappen is de broncode van de gegevensmigratie te vinden in de: vendor/magento directory met de andere magento-modules.

GitHub-installatie

Deze installatieoptie is voor degenen die deel uitmaken van de Magento-organisatie op GitHub en gemakkelijker toegang willen tot de migratiebroncode tijdens migratieontwikkelingswerk.

De migratiemodule installeren vanuit de GitHub-repo (magento2/magento2-page-builder-data-migration):

1. Navigeer naar de map boven uw Magento 2-installatie.

2. Kloon de magento/magento2-page-builder-data-migration repository met behulp van de volgende opdracht:

   1
   
   
   
   git clone git@github.com:magento/magento2-page-builder-data-migration.git
   
   
   
   
   
   

3. Symlink de magento2-page-builder-data-migration in uw Magento-installatie:

   1
   
   
   
   php <magento-root-directory>/dev/tools/build-ee.php --command=link --ce-source <magento-root-directory> --ee-source magento2-page-builder-data-migration
   
   
   
   
   
   

4. Schakel de standaardfunctie voor migratie bij implementatie uit.

   Deze stap is van cruciaal belang voor ontwikkelingswerk op het gebied van migratie. Het schakelt het standaardgedrag van de migratiemodule uit waarmee uw inhoud wordt gemigreerd als onderdeel van de implementatie met: setup:upgrade. We hebben dit het standaardgedrag gemaakt, zodat implementatie naar productie eenvoudig is. Maar tijdens de ontwikkeling moet u het uitschakelen, zodat u uw migraties niet per ongeluk uitvoert, voordat u strategische wijzigingen in uw migratiecode of back-ups naar uw database hebt aangebracht.

Na het voltooien van deze stappen, zou de broncode van de gegevensmigratie naast de hoofdmap van de Magento 2.3.1-installatie moeten staan, met de symlinks erin. Als uw directorystructuur anders is, past u uw symlink-paden indien nodig aan.

Migratie bij implementatie uitschakelen

Met deze stap wordt de functie van de migratiemodule uitgeschakeld die uw inhoud migreert als onderdeel van de implementatie met: setup:upgrade. Tijdens de ontwikkeling moet u vaak uw migratiecode aanpassen voordat migraties uitvoeren om ervoor te zorgen dat uw inhoud naar Page Builder wordt gemigreerd zoals bedoeld. Het is dus het beste om deze automatische migratiefunctie uit te schakelen en de expliciete migratieopdracht te gebruiken zoals beschreven in het uitvoeren van de migratiemodule.

Om migratie bij implementatie uit te schakelen, voert u de volgende query’s uit op de: setup_module en patch_list tabellen in uw database. Deze querywaarden geven aan dat de migratiemodule al is geïnstalleerd, wat verhindert dat Magento de patch toepast en de migratie automatisch uitvoert voordat u klaar bent.

1
2
3
4
5
6
7



INSERT INTO `setup_module` (`module`, `schema_version`, `data_version`)
VALUES
    ('Magento_PageBuilderDataMigration', '1.0.0', '1.0.0');

INSERT INTO `patch_list` (`patch_name`)
VALUES
    ('Magento\\PageBuilderDataMigration\\Setup\\Patch\\Data\\MigrateToPageBuilder');

Migratiebroncode wijzigen

We zijn niet van plan om updates van de PageBuilderDataMigration module. Dit betekent dat u de migratiebroncode naar behoefte kunt aanpassen aan uw behoeften.

Volgende stappen

Voer de migratiemodule uit.