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 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.dist
do 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 Edition
paraMagento 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 o armazenamento M1 tiver alterações personalizadas, você deverá mapear o restante dos arquivos de configuração para as 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.xml
a partir da amostra fornecida:code language-bash cp config.xml.dist config.xml
-
Abra
config.xml
em 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
root
com a senhapass
e você usar o prefixomagento1
no 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_ca
ssl_cert
ssl_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 de 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.dist
config.xml.dist
customer-attr-document-groups.xml.dist
customer-attr-map.xml.dist
deltalog.xml.dist
eav-attribute-groups.xml.dist
eav-document-groups.xml.dist
log-document-groups.xml.dist
map-eav.xml.dist
map-log.xml.dist
map-sales.xml.dist
map.xml.dist
settings.xml.dist
core_config_data
.customer-attribute-groups.xml.dist
customer-document-groups.xml.dist
map-customer.xml.dist
order-grids-document-groups.xml.dist
map-document-groups.xml.dist
map-stores.xml.dist
map-tier-price.xml.dist
visual_merchandiser_map.xml.dist
visual_merchandiser_attribute_groups.xml.dist
visual_merchandiser_document_groups.xml.dist
Você pode consultar a Data Migration Tool Especificação técnica para obter mais detalhes.