n8n v2.0: o que muda (e se quebra seus workflows)
n8n v2.0 antes do lançamento: nova interface, botão Publicar, Migration Report e breaking changes (Code Node, MySQL). O que fazer antes da migração.
O n8n tem data marcada pra virar de versão: v2.0.0 beta no dia 8 de dezembro e v2.0.x estável no dia 15, segundo o anúncio oficial. E, junto do anúncio, três perguntas tomaram conta das conversas de quem tem automação no ar: a v1 vai parar de funcionar? Vai quebrar o que está rodando em produção? O que muda no jeito de publicar workflow?
O Lucas testou a v2.0 antes do lançamento, pelo programa de pré-lançamento do n8n, que libera as atualizações pra um grupo seleto de testers, e mostra tudo rodando no vídeo acima. Este post resume o que vem por aí: as mudanças, os pontos de atenção e o que já dá pra fazer hoje, sem pânico. Um aviso, o mesmo do vídeo: é pré-lançamento, detalhes podem mudar até o beta sair.
O n8n v1 vai parar de funcionar?
Vale separar o boato do anúncio. O que foi comunicado é que a v1 deixa de receber atualização em cerca de três meses, não que a sua instância apaga do dia pra noite. A resposta do Lucas no vídeo é literal: "calma, jovem".
O caminho é método, não pressa: atualizar a v1 pra uma versão que já inclui o Migration Report, conferir a compatibilidade dos seus workflows e só então planejar a virada. O plano completo está mais abaixo.
O que muda na interface do n8n 2.0
Na prévia, a cara nova é o que salta aos olhos: ícones redesenhados, visual mais moderno, execução mais agradável de acompanhar. Mas o que pesa no dia a dia são três mudanças:
- Sidebar configurável: agora dá pra ajustar o tamanho da barra lateral do jeito que você trabalha.
- Botão de ação: você digita o que quer fazer ("executar o flow", "publicar", "adicionar node", "desativar workflow") e a ação acontece. A função já existia na versão anterior, mas era pouco usada; na v2 ela ganhou destaque. O Lucas usa direto e recomenda: é do tipo que aumenta a produtividade de quem passa o dia no canvas.
- Settings mais acessível: os menus de configuração ficaram visíveis num clique, sem caminho escondido. E é ali que mora a função que o Lucas aponta como a mais importante da versão: o Migration Report.
Fim da chavinha: na v2, workflow entra em produção com "Publicar"
Na v1, ativar um workflow era virar uma chavinha. Na v2, o paradigma muda: entra em cena o botão Publicar.
A lógica por trás: o n8n vai ganhar auto save (previsto pra chegar por volta de janeiro, segundo o que o Lucas mostra na prévia). Se salvar automaticamente jogasse tudo em produção, qualquer mexida num workflow ativo viraria risco. No novo modelo, você salva e testa à vontade, e só quando clica em Publicar a mudança vai pro ar.
Junto disso vêm três recursos que quem mantém automação de cliente vai agradecer:
- Versões com nome e descrição: dá pra nomear cada publicação ("versão 1.0 de produção") e descrever o que mudou ("integrei com a ferramenta tal"). Pra quem mexe em automação com mudança frequente, isso facilita demais mapear em qual versão cada coisa está.
- Checklist de publicação: o n8n aponta o que pode estar faltando no workflow na hora de publicar.
- Webhooks seguem a mesma regra: workflow que recebe webhook só passa a responder depois de publicado. É o equivalente ao "ativo" da versão antiga.
Migration Report: o passo mais importante da migração
Pro Lucas, essa é a função que define como você vai sair da v1 pra v2, e ela já está disponível hoje.
Funciona assim: a partir da versão 1.121 do n8n, o Migration Report aparece em Settings. Ele analisa os seus workflows e lista quais são incompatíveis com a v2. No teste do vídeo, o relatório apontou quatro workflows com pendência. E, a partir da lista, dá pra abrir cada um e adaptar pra nova versão.
Ou seja: você descobre o que quebraria na sua instância atual, com calma, sem migrar no escuro.
Breaking changes que mais pegam em produção
A lista completa está na documentação oficial (link nas fontes). O time da fazer.ai destacou as mudanças que mais impactam quem roda n8n em produção:
Code Node perde acesso a variáveis de ambiente
Por segurança, a v2 bloqueia o acesso a variáveis de ambiente dentro do Code Node. Pra quem gerencia muitas credenciais (de vários clientes, por exemplo), é um ponto positivo: variável de ambiente costuma guardar credencial, e o bloqueio reduz o risco de ela vazar por um script dentro do fluxo.
Execute Command e Local File Trigger desativados por padrão
Os nodes Execute Command e Local File Trigger, que vinham habilitados, agora chegam desativados. Se alguma automação sua dá comando no Linux (acionar um processo que roda em outro container, por exemplo), você vai precisar habilitar a função manualmente pra continuar usando.
Fim do MySQL/MariaDB como banco interno
A v2 descontinua o suporte a MySQL/MariaDB como banco de dados interno do n8n: quem usa esse storage vai ter que migrar pra Postgres. Atenção à diferença: o node MySQL, aquele que consulta uma base externa dentro dos seus fluxos, continua funcionando normalmente. O que muda é onde o próprio n8n guarda os dados dele.
Quando atualizar: calendário e plano sem pânico
As datas oficiais: beta no dia 8 de dezembro, estável no dia 15, já com correções dos bugs que aparecerem no beta. Até lá, o plano que o Lucas recomenda no vídeo:
- Hoje: atualize a sua instância pra v1.121 ou superior e rode o Migration Report.
- Revise os itens de segurança: Code Node, Execute Command e Local File Trigger. Veja se alguma automação sua depende deles.
- Se usa MySQL/MariaDB como banco interno: comece a planejar a migração pra Postgres.
- Depois do dia 8: quer testar o beta? Use uma instância separada, que não atende ninguém. No n8n de produção, não mexe.
- Do dia 15 em diante: com a estável no ar e o Migration Report limpo, aí sim a migração entra no calendário.
Se você montou um agente de IA no WhatsApp com n8n, esse checklist vale dobrado: automação que atende cliente não pode descobrir breaking change em produção.
Perguntas frequentes
Preciso atualizar pra v2 no dia 8?
Não. O dia 8 é o beta, serve pra testar numa instância separada, nunca na de produção. A estável chega no dia 15, e a migração só entra no plano com o Migration Report limpo.
Meu workflow com webhook muda alguma coisa?
Na v2, ele só passa a responder depois de publicado. O botão Publicar substitui a chavinha de ativação.
O node MySQL vai parar de funcionar?
Não. O que acaba é o MySQL/MariaDB como banco interno do n8n. Consulta a base MySQL externa via node continua normal.
Pra ir além
No dia 15, data da versão estável, o Lucas e o Gabriel (seu sócio na fazer.ai, também engenheiro) fazem uma live testando o n8n v2.0 ao vivo no canal do Lucas Moreira. E o passo a passo completo da prévia, com o Migration Report rodando na tela, está no vídeo acima.
O ecossistema de automação não para (um concorrente pro n8n apareceu no AWS Summit), e acompanhar essas viradas cedo é o que evita dor de cabeça em produção. Pra ver esses testes de perto e tirar dúvida da sua migração: a comunidade tá em lucasmoreira.ai. Vem fazer junto.
Fontes
Faça junto com a comunidade
Mais de 10 mil pessoas fazendo IA na prática. Tire dúvidas, pegue arquivos prontos e veja os bastidores.