DocumentaçãoCommerceFerramentas

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Visão geral da migração

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

Antes de iniciar a migração, interrompa todos os trabalhos cron do Magento 1.

Durante o processo de migração, siga estas regras gerais para uma migração bem-sucedida:

  1. Não faça alterações no Administrador do Magento 1, exceto para gerenciamento de pedidos (remessa, criação de fatura e avisos de crédito)
  2. Não altere qualquer código
  3. Não faça alterações no Administrador e na loja do Magento 2
TIP
Todas as operações na loja do Magento 1 são permitidas.

Executar o Data Migration Tool

Esta seção mostra como executar o Data Migration Tool para migrar configurações, dados ou alterações incrementais.

Primeiros passos

  1. Efetue login no servidor de aplicativos como, ou alterne para, um usuário com permissões para gravar no sistema de arquivos. Consulte alternar para o proprietário do sistema de arquivos.

    Se você usar o shell bash, poderá usar a seguinte sintaxe para alternar para o proprietário do sistema de arquivos e inserir o comando ao mesmo tempo:

    code language-bash 
    su <file system owner> -s /bin/bash -c <command>

    Se o proprietário do sistema de arquivos não permitir logons, você poderá fazer o seguinte:

    code language-bash 
    sudo -u <file system owner>  <command>

  2. Para executar comandos Magento de qualquer diretório, adicione <magento_root>/bin ao sistema PATH.

    Como os shells têm sintaxe diferente, consulte uma referência como unix.stackexchange.com.

    Exemplo de shell bash para CentOS:

    code language-bash 
    export PATH=$PATH:/var/www/html/magento2/bin

    Como opção, você pode executar os comandos das seguintes maneiras:

    • cd <magento_root>/bin e executá-los como ./magento <command name>
    • <magento_root>/bin/magento <command name>
    • <magento_root> é um subdiretório do docroot do seu servidor Web.

Sintaxe de comando

Abaixo está um exemplo típico de comando:

bin/magento migrate:<mode> [-r|--reset] [-a|--auto] {<path to config.xml>}

Onde:

  • <mode> pode ser: settings, data, ou delta
  • [-r|--reset] é um argumento opcional que inicia a migração desde o início. Você pode usar esse argumento para testar a migração.
  • [-a|--auto] é um argumento opcional que impede que a migração pare quando encontrar erros de verificação de integridade.
  • {<path to config.xml>} é o caminho absoluto do sistema de arquivos para config.xml; este argumento é obrigatório.
NOTE
Os logs são gravados no diretório <magento_root>/var/.

Ordem de migração

Quando criamos o Data Migration Tool, assumimos a seguinte sequência de transferência de dados:

  1. Configurações
  2. Dados
  3. Alterações

É altamente recomendável migrar os dados na mesma ordem.

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