Configure o Data Migration Tool

Depois de 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 migração 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 migração 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 a variável Data Migration Tool:

  • Configure o Data Migration Tool em um módulo separado (recomendado)
  • Altere o Data Migration Tool configuração no <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/ diretório.

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 somente localmente, é possível editar arquivos na <your Magento 2 install dir>/vendor/magento/data-migration-tool/ diretamente.

Configurar migração em um módulo separado

Antes de migrar dados, é necessário criar um módulo Magento 2.

  1. 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>
    
  2. Copie o config.xml.dist arquivo de configuração do diretório apropriado do Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) no <your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml arquivo.

    Por exemplo, se você migrar Magento 1.9.3.6 Community Edition para Magento 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
    
  3. No config.xml arquivo, você deve definir os detalhes de acesso aos bancos de dados M1 e M2 e a chave de criptografia.

  4. 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 no vendor pasta

Antes de migrar dados, é necessário criar um config.xml arquivo de configuração da amostra fornecida.

Para configurar o Data Migration Tool para migração:

  1. Efetue login no servidor de aplicativos como, ou alterne para, o proprietário do sistema de arquivos.

  2. 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>
    
  3. Digite o seguinte comando para criar um config.xml da amostra fornecida:

    code language-bash
    cp config.xml.dist config.xml
    
  4. Abertura config.xml em um editor de texto.

  5. 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 variável <crypt_key> A tag deve conter um valor. Você pode encontrá-lo dentro do <key> que está localizada no arquivo app/etc/local.xml na sua instância 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 senha pass e você usar o prefixo magento1 no banco de dados Magento 1, use o seguinte no config.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>
    

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 à database elemento:

  • 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

A variável Data Migration Tool usos mapeando arquivos 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 compatíveis estão localizados em subdiretórios de <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc

Para usar os arquivos de mapeamento:

  1. Copiá-los 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 variável .dist extensão.

  2. Atualize o caminho para o arquivo recém-copiado no <options> nó de config.xml. O caminho atualizado deve ser um dos seguintes:

    1. Caminho absoluto do arquivo, p. ex. /var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
    2. caminho relativo do arquivo do módulo magento/data-migration-tool: etc/opensource-to-opensource/1.9.4.1/map.xml
    3. caminho do arquivo relativo à raiz do Magento: app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml

A variável <Magento 2 dir>/vendor/magento/data-migration-tool/etc e <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> os diretórios contêm os seguintes arquivos de configuração:

Mesmo que você esteja trabalhando com o map.xml.dist na maioria das vezes, a tabela a seguir discute cada mapeamento e outros arquivos.

Nome do arquivo de mapeamento
Descrição
class-map.xml.dist
Dicionário de mapeamentos de classe entre Magento 1 e Magento 2
config.xml.dist
Arquivo de configuração principal que especifica as configurações de banco de dados Magento 1 e Magento 2, configuração de etapa e links para arquivos de mapeamento
Somente Adobe Commerce. customer-attr-document-groups.xml.dist
Lista de tabelas usadas na etapa atributos personalizados do cliente.
Somente Adobe Commerce. customer-attr-map.xml.dist
Arquivo de mapa usado na etapa Atributos personalizados do cliente.
deltalog.xml.dist
Contém a lista de tabelas necessárias para a configuração de rotinas de banco de dados.
eav-attribute-groups.xml.dist
Contém a lista de atributos que são usados na Etapa Eav.
eav-document-groups.xml.dist
Contém a lista de tabelas que são usadas na Etapa Eav.
log-document-groups.xml.dist
Contém a lista de tabelas usadas na Etapa de Log.
map-eav.xml.dist
Arquivo de mapa usado na etapa EAV.
map-log.xml.dist
Arquivo de mapeamento de log.
Somente Adobe Commerce. map-sales.xml.dist
Arquivo de mapa usado na Etapa Ordem de Venda.
map.xml.dist
Arquivo de mapeamento necessário para a etapa do mapa.
settings.xml.dist
Configuração do arquivo de configuração de migração que especifica as regras necessárias para a migração do core_config_data tabela.
customer-attribute-groups.xml.dist
Contém a lista de atributos usados na etapa Atributos do cliente.
customer-document-groups.xml.dist
Contém a lista de tabelas usadas na etapa Atributos do cliente.
map-customer.xml.dist
Arquivo de mapa usado na etapa Atributos do cliente.
order-grids-document-groups.xml.dist
Contém a lista de tabelas usadas na Etapa OrderGrids.
map-document-groups.xml.dist
Define quais campos são atualizados quando ocorrem duplicações na inserção de dados
map-stores.xml.dist
Mapeie o arquivo usado na etapa Lojas.
map-tier-price.xml.dist
Mapeie o arquivo usado na Etapa de Preço da Camada.
Somente Adobe Commerce. visual_merchandiser_map.xml.dist
Arquivo de mapa usado na etapa VisualMerchandiser.
Somente Adobe Commerce. visual_merchandiser_attribute_groups.xml.dist
Contém a lista de atributos usados na etapa VisualMerchandiser.
Somente Adobe Commerce. visual_merchandiser_document_groups.xml.dist
Contém a lista de tabelas usadas na etapa VisualMerchandiser.

Você pode consultar Data Migration Tool Especificação técnica para obter mais detalhes.

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3