Configurar o Data Migration Tool
Após instalar o Data Migration Tool, o seguinte diretório contém arquivos de mapeamento e configuração:
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource: configuração e scripts para migrar do Magento Open Source 1 para o Magento Open Source 2
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce: configuração e scripts para migrar do Magento Open Source 1 para o Adobe Commerce 2<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce: configuração e scripts para migrar do Adobe Commerce 1 para o Adobe Commerce 2
Os diretórios anteriores contêm subdiretórios para cada versão compatível.
Configuração da migração
Há duas maneiras de configurar o Data Migration Tool:
- Configurar o Data Migration Tool em um módulo separado (recomendado)
- Altere a configuração de Data Migration Tool no diretório
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/.
Para usar o controle do código-fonte para gerenciar a configuração de migração e usá-la para implantação, você deve criar um módulo separado.
Se você planeja executar o Data Migration Tool apenas localmente, poderá editar os arquivos diretamente no diretório <your Magento 2 install dir>/vendor/magento/data-migration-tool/.
Configurar migração em um módulo separado
Antes de migrar dados, é necessário criar um módulo do Magento 2.
-
Crie um módulo Magento 2.
<your Magento 2 install dir>/app/code/Vendor/Migration/composer.json
code language-json { "name": "vendor/migration", "description": "Providing config for migration", "config": { "sort-packages": true }, "require": { "magento/framework": "*", "magento/data-migration-tool": "*" }, "type": "magento2-module", "autoload": { "files": [ "registration.php" ], "psr-4": { "Vendor\\Migration\\": "" } }, "version": "1.0.0" }<your Magento 2 install dir>/app/code/Vendor/Migration/registration.php
code language-php <?php \Magento\Framework\Component\ComponentRegistrar::register( \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Vendor_Migration', __DIR__ );<your Magento 2 install dir>/app/code/Vendor/Migration/etc/module.xml
code language-xml <?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_Migration" setup_version="1.0.0"> <sequence> <module name="Magento_DataMigrationTool"/> </sequence> </module> </config> -
Copie o arquivo de configuração
config.xml.distdo diretório apropriado de Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) para o arquivo<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml.Por exemplo, se você migrar
Magento 1.9.3.6 Community EditionparaMagento 2 Open Source:code language-bash cd <your Magento 2 install dir>code language-bash cp vendor/magento/data-migration-tool/etc/opensource-to-opensource/1.9.3.6/config.xml.dist app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.3.6/config.xml -
No arquivo
config.xml, você deve definir os detalhes de acesso aos bancos de dados M1 e M2 e à chave de criptografia. -
Se seu armazenamento M1 tiver alterações personalizadas, você deverá mapear o restante dos arquivos de configuração para suas personalizações do armazenamento Magento 1. Consulte Trabalhar com arquivos de configuração e mapeamento.
Configurar migração na pasta vendor
Antes de migrar dados, você deve criar um arquivo de configuração do config.xml a partir da amostra fornecida.
Para configurar o Data Migration Tool para migração:
-
Faça logon no servidor de aplicativos como ou alterne para o proprietário do sistema de arquivos.
-
Altere para o seguinte diretório:
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version> -
Digite o seguinte comando para criar um
config.xmla partir da amostra fornecida:code language-bash cp config.xml.dist config.xml -
Abra
config.xmlem um editor de texto. -
No mínimo, o arquivo config.xml deve conter detalhes de acesso para bancos de dados M1 e M2 e chaves de criptografia.
code language-xml <source> <database host="127.0.0.1" name="magento1" user="root"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root"/> </destination> <options> <crypt_key /> </options>A tag <crypt_key> deve conter um valor. Você pode encontrá-lo dentro da tag
<key>, que está localizada no arquivo app/etc/local.xml na sua instância do Magento 1.Parâmetros opcionais:
- Senha do usuário do banco de dados:
password=<password> - Porta personalizada do banco de dados:
port=<port> - Prefixo da tabela:
<source_prefix>,<dest_prefix>
Por exemplo, se o nome de usuário do proprietário do banco de dados for
rootcom a senhapasse você usar o prefixomagento1no banco de dados Magento 1, use o seguinte noconfig.xml:code language-xml <source> <database host="127.0.0.1" name="magento1" user="root" password="pass"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root" password="pass"/> </destination> <options> <source_prefix>magento1</source_prefix> <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key> </options> - Senha do usuário do banco de dados:
Quando terminar, salve as alterações em config.xml e saia do editor de texto.
Conectar-se usando o protocolo TLS
Você também pode se conectar a um banco de dados usando o protocolo TLS (ou seja, usando chaves criptográficas públicas/privadas). Adicione os seguintes atributos opcionais ao elemento database:
ssl_cassl_certssl_key
Por exemplo:
<source>
<database host="localhost" name="magento1" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</source>
<destination>
<database host="localhost" name="magento2" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</destination>
Trabalhar com arquivos de configuração e mapeamento
O Data Migration Tool usa arquivos de mapeamento para permitir que você execute o mapeamento de banco de dados personalizado entre seus bancos de dados Magento 1 e Magento 2, incluindo:
-
Alteração de nomes de tabela
-
Alteração de nomes de campo
-
Ignorando tabelas ou campos
-
Adaptar a transferência de dados de um campo para o formato Magento 2
Os arquivos de mapeamento para versões do Magento com suporte estão localizados em subdiretórios de <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
Para usar os arquivos de mapeamento:
-
Copie-os de
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/para<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/e remova a extensão.dist. -
Atualize o caminho para o arquivo recém-copiado no nó
<options>deconfig.xml. O caminho atualizado deve ser um dos seguintes:- Caminho absoluto do arquivo, ex.:
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml - caminho relativo do arquivo do módulo magento/data-migration-tool:
etc/opensource-to-opensource/1.9.4.1/map.xml - Caminho do arquivo relativo à raiz do Magento:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Caminho absoluto do arquivo, ex.:
Os diretórios <Magento 2 dir>/vendor/magento/data-migration-tool/etc e <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> contêm os seguintes arquivos de configuração:
Embora você esteja trabalhando com o arquivo map.xml.dist na maior parte do tempo, a tabela a seguir discute cada mapeamento e outros arquivos.
class-map.xml.distconfig.xml.distcustomer-attr-document-groups.xml.distcustomer-attr-map.xml.distdeltalog.xml.disteav-attribute-groups.xml.disteav-document-groups.xml.distlog-document-groups.xml.distmap-eav.xml.distmap-log.xml.distmap-sales.xml.distmap.xml.distsettings.xml.distcore_config_data.customer-attribute-groups.xml.distcustomer-document-groups.xml.distmap-customer.xml.distorder-grids-document-groups.xml.distmap-document-groups.xml.distmap-stores.xml.distmap-tier-price.xml.distvisual_merchandiser_map.xml.distvisual_merchandiser_attribute_groups.xml.distvisual_merchandiser_document_groups.xml.distVocê pode consultar a Data Migration Tool Especificação técnica para obter mais detalhes.