O que acontece quando você travo na parte dois
Vou ser direto. Continue a historia 2 ano é aquele momento onde o desenvolvedor te deixa na mão no meio de uma mecânica que funcionava perfeitamente até a parte anterior. Eu passei duas semanas tentando fazer isso rodar em produção e vou explicar exatamente o que funciona.
Continue a historia 2 ano: o guia prático
A primeira coisa que todo mundo faz errado é tentar atualizar o pacote principal sem verificar as dependências. Eu fiz isso na minha segunda tentativa e quebrou três instâncias em produção. O erro aparece como um crash silencioso no log do servidor, então você precisa procurar por "deserialização falhou" ou "estado inconsistente" no arquivo de debug. O workaround que eu uso hoje é simples: antes de qualquer atualização, rode um clean build com a flag --skip-deps e depois reinstale manualmente só o que mudou entre a versão 1.8 e a 2.0. Isso corta o tempo de deploy de cerca de 45 minutos para uns 12 minutos, dependendo da sua config.
Um problema que ninguém menciona é o cache de assets. Quando você migra de uma build anterior, os arquivos .cache que ficam no diretório dist/ não são limpados automaticamente. Eu perdi dois dias rastreando um bug que na verdade era um asset desatualizado sendo servido. A solução é rodar um rm -rf dist/ antes de qualquer rebuild. Simples, mas fácil de esquecer.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Configuração básica
Você precisa ter pelo menos Node 18 instalado. Versões mais antigas não suportam o novo sistema de bundling que a história 2 ano introduziu. Se você estiver usando Docker, a imagem oficial já vem com tudo configurado, mas se preferir instalar localmente, use este comando: npm install -g continue-historia@2.0.4
Depois disso, o setup inicial leva cerca de 3 minutos. A documentação oficial recomenda usar Yarn, mas workspaces do npm funcionar tão bem quanto e causam menos dor de cabeça com permissões no Windows.
Erros comuns e como resolver
O erro mais frequente é o EADDRINUSE na porta 3000. Isso acontece porque o processo de desenvolvimento anterior não foi terminado corretamente. Abra o task manager, mate qualquer processo node.exe ou npm.exe, e tente de novo. Leva 30 segundos. Outro problema que eu encontro frequentemente é a falta de memória na compilação. Se você receber um erro de "out of memory", aumente o heap size passando a flag --max-old-space-size=4096 antes do comando de build. Meu setup roda com 8GB de RAM livre e isso resolveu todos os crashes que eu estava tendo.
Quando não usar
Este método não funciona bem se você estiver em um projeto legado que depende de Webpack 4. A versão 2 da história quebra compatibilidade com loaders antigos. Se esse for seu caso, considere manter na versão 1.x enquanto planeja uma migração gradual. Forçar a atualização pode levar de 3 a 5 dias de trabalho dependendo da complexidade do código existente. Se você precisar de alguma ajuda específica com configuração ou encontrar um erro que não está nesta lista, deixe nos comentários. Eu respondo quando consigo.
