Leia o relatório de migração da sua instância

O relatório de migração verifica a sua instância e lista o que o n8n 3.0 altera nos seus workflows e nas suas configurações. Ele evita a conferência manual de cada item da lista de breaking changes. A tela fica em Settings > Migration Report em toda instância na versão 2.39 ou posterior.

Atualize antes para a última versão 2.x. Segundo o anúncio do n8n, ela traz a versão mais recente do relatório.

Confira o seu nível de acesso

Todo usuário abre o relatório, mas o conteúdo muda conforme a permissão. Owner e admins veem todos os workflows, a aba Instance issues e o botão Refresh. Os demais usuários veem só os workflows que podem editar.

Faça esta leitura com um usuário owner ou admin. Assim, o resultado inclui as variáveis de ambiente e as configurações de implantação.

Leia o resumo de compatibilidade

O topo da página mostra uma barra com a quantidade de workflows compatíveis com o n8n 3.0. Um workflow compatível continua funcionando depois da atualização sem mudança.

Selecione Refresh para rodar uma verificação completa. O campo Last updated mostra quando ela aconteceu pela última vez. O n8n também verifica de novo cada workflow salvo, por isso o relatório acompanha as correções.

Entenda as duas abas

A aba Workflow issues lista as mudanças que alcançam workflows. Cada item mostra título, descrição, nível de impacto, quantidade de workflows afetados e link para a documentação.

A aba Instance issues lista mudanças de configuração da instância inteira, como variáveis de ambiente e forma de implantação. Esses itens valem para a instância toda e não mostram número de workflows.

Ordene pelo nível de impacto

Cada item recebe um de cinco níveis. A documentação recomenda corrigir nesta ordem:

Nível	O que significa
Upgrade blocked	A atualização não avança ou a instância pode não iniciar depois dela
Executions will fail	Workflows ou a instância falham depois da atualização
Executions might fail	Um valor padrão muda e algumas execuções podem falhar
Behavior changes	O workflow continua rodando, mas com outro comportamento
Capability removed	A execução segue igual, mas um recurso usado deixa de existir

Abra os workflows de cada item

Selecione o número de workflows de um item para abrir a lista detalhada. Cada linha mostra nome, responsável, nodes afetados, estado, publicação e uso.

Ordene por quantidade de execuções para começar pelos workflows mais usados. Workflows sem execução há mais de 12 meses recebem a sugestão de marcar Won’t fix.

Alguns itens oferecem o botão Migrate, que reescreve os nodes afetados. A troca de Cron por Schedule Trigger é um exemplo. O resultado vira uma nova versão do workflow. A versão publicada continua rodando até você publicar a nova. Teste antes de publicar, porque a migração automática cobre só a troca dos nodes.

Exporte o resultado

Selecione Export CSV para baixar o relatório. O arquivo tem uma linha por item, com a versão atual, a versão de destino, o nível de impacto e a quantidade de workflows em aberto. Guarde esse arquivo junto do registro da sua instalação. Ele serve de ponto de partida para as próximas etapas da série.

Siga a ordem indicada pelo n8n

O anúncio da versão 3.0 recomenda esta sequência:

1. Atualize para a última versão 2.x e abra o relatório.
2. Corrija ou marque como Won’t fix tudo o que ele apontar.
3. Faça um backup completo.
4. Atualize primeiro uma instância de teste ou homologação e só depois a instância principal.

A atualização para a 3.x não tem volta. O backup é a única forma de retornar à 2.x.

Quando o relatório vem vazio

As duas abas vazias indicam que a ferramenta não encontrou nada para corrigir. Segundo a documentação, algumas mudanças não aparecem no relatório. Revise a lista do tutorial anterior antes de seguir para a atualização.