O Umbraco 17 é a versão atual de suporte estendido (LTS) do Umbraco e roda em .NET 10. Se o seu site ainda está no Umbraco 13, 10 ou anterior, o upgrade vai chegar, planejado ou não. Este guia mostra o que mudou, como escolher entre upgrade direto e migração e como proteger o posicionamento no Google durante a mudança.
O que mudou entre o Umbraco 13 e o Umbraco 17
A maior mudança veio no Umbraco 14: o back office foi reconstruído do zero com web components. O antigo back office em AngularJS deixou de existir. Para os editores os conceitos continuam os mesmos, mas para os desenvolvedores todo dashboard, editor de propriedade e extensão do back office precisa ser reconstruído.
Back office: nova interface com web components (Lit). Extensões em AngularJS não são aproveitadas.
Pacotes: todo pacote sem versão para Umbraco 17 precisa ser substituído ou reconstruído.
Editores antigos: editores de propriedade legados foram removidos em favor do Block List e do Block Grid, então parte do conteúdo precisa ser convertida.
Runtime: o Umbraco 17 roda em .NET 10, então o código personalizado e a hospedagem migram para o runtime .NET atual.
Upgrade direto ou migração?
A partir do Umbraco 13, o upgrade direto costuma ser possível: atualize os pacotes, rode as migrações do banco e reconstrua as extensões do back office. A partir do Umbraco 8 ou anterior, o modelo de dados e as APIs estão tão distantes que construir um novo site em Umbraco 17 e migrar o conteúdo costuma sair mais limpo e mais barato. Ferramentas da comunidade como o uSync Migrations ajudam a mover conteúdo entre versões.
Faça o upgrade direto quando estiver no Umbraco 13, usar poucos pacotes de terceiros e o modelo de conteúdo ainda servir.
Migre quando estiver no Umbraco 8 ou anterior, depender de pacotes abandonados ou quiser redesenhar o modelo de conteúdo.
Um plano prático de upgrade
Auditoria: liste a versão, todos os pacotes, código personalizado, integrações e tarefas agendadas.
Decida pacote a pacote: atualizar, substituir ou reconstruir. Isso define a maior parte do esforço.
Ensaie em uma cópia: rode o upgrade ou a migração completa em uma cópia de homologação com dados de produção, nunca direto em produção.
Reconstrua as extensões do back office para o novo back office.
Teste com os editores: deixe que publiquem conteúdo real na homologação antes do lançamento.
Faça a virada: congele o conteúdo por pouco tempo, sincronize o conteúdo final, troque o tráfego e monitore.
Proteja o seu SEO na mudança
A maior parte do tráfego perdido em mudanças de CMS vem de URLs que mudam sem redirecionamento. Antes do lançamento, exporte todas as URLs publicadas do sitemap e do analytics, compare com o novo site e crie um redirecionamento 301 para cada URL que mudar. Verifique títulos, meta descrições, canonical, hreflang e sitemap na homologação e rode um rastreamento completo logo após o lançamento.
Aprendemos isso no nosso próprio site: quando reconstruímos o splatdev.com em Umbraco 17, os rastreamentos depois do lançamento encontraram problemas que uma verificação manual não pegaria. Veja os detalhes no nosso estudo de caso.
Quanto tempo leva?
Depende da quantidade de tipos de documento, templates, pacotes e integrações. Um site institucional pequeno pode migrar em poucas semanas. Sites multilíngues grandes com ferramentas próprias no back office levam mais tempo, e a maior parte desse tempo vai para pacotes e extensões, não para o conteúdo.
Precisa de ajuda?
Planejamos e executamos upgrades e migrações para Umbraco 17 e desenvolvemos plugins Umbraco para Umbraco 13 e 17. Fale conosco para uma avaliação de upgrade.