Migração de versões

Migração de versão do Odoo com teste antes da troca

Planejamos a migração considerando edição, módulos da OCA e personalizações, testamos em uma cópia da base e validamos os processos críticos com a sua equipe antes da virada.

Para quem é indicado

Quando este serviço faz sentido

Enterprise em versão antiga

Empresas com Odoo Enterprise em versão antiga.

Community com OCA

Empresas com Odoo Community e módulos da OCA a migrar.

Bases personalizadas

Bases com personalizações próprias ou de terceiros.

Revisão de processos

Empresas que querem aproveitar a migração para revisar processos.

O desafio

Ficar para trás tem custo. Migrar sem teste também.

A Odoo S.A. dá suporte a cada versão principal por três anos. Depois disso, correções e compatibilidade ficam mais difíceis, e módulos da comunidade deixam de evoluir para versões antigas. Migrar, porém, envolve dados, personalizações e integrações — e cada item precisa estar pronto na versão de destino.

Sinais de alerta:

  • Versão fora do período de suporte da Odoo S.A.
  • Módulos ou integrações sem compatibilidade com versões recentes
  • Personalizações que impedem a atualização
  • Recursos novos que a empresa não consegue adotar
Pessoas caminham por corredor de escritório com salas de vidro, em imagem com efeito de movimento
Tela de computador com linhas de código em destaque sobre fundo escuro
Enterprise e Community

Dois caminhos de migração, conforme a edição

Odoo Enterprise — serviço oficial de upgrade

A assinatura Enterprise inclui o serviço de atualização da Odoo S.A., que cobre os aplicativos padrão e as personalizações feitas no Studio. Módulos próprios ou de terceiros precisam ser adaptados à versão de destino antes da atualização, e a limpeza de dados antigos não faz parte do serviço oficial.

Odoo Community — OpenUpgrade (OCA)

O Community não inclui ferramenta oficial de migração entre versões principais. O caminho usual é o OpenUpgrade, projeto aberto da OCA, que avança uma versão por vez, passando por todas as intermediárias. A cobertura varia por módulo, e módulos da OCA e próprios precisam existir na versão de destino.

Metodologia SPACE

Abordagem em cinco etapas

  1. Situar. Inventário de versão, edição, módulos instalados, personalizações, integrações e volume de dados.
  2. Planejar. Caminho de migração, módulos a portar, substituir ou remover, roteiro de testes e janela de virada.
  3. Aplicar. Migração em cópia da base, adaptação do código próprio e correção de dados, em rodadas de teste.
  4. Consolidar. Validação dos processos críticos com usuários-chave, virada planejada e acompanhamento posterior.
  5. Evoluir. Adoção dos recursos da nova versão que fazem sentido para a operação.
Duas pessoas organizam notas adesivas em uma parede de vidro durante o planejamento de um projeto
Equipe reunida em torno de mesa revisa documentos com atenção, com um colega de pé conduzindo a conversa
Escopo

Entregáveis e limites

Entregáveis

  • Diagnóstico de migração, com riscos e dependências
  • Plano de migração e de virada
  • Personalizações adaptadas, substituídas ou descontinuadas, com justificativa
  • Base de teste migrada para validação
  • Roteiro de testes dos processos críticos
  • Relatório pós-migração com pendências e recomendações

Limites

  • A cobertura do OpenUpgrade varia por módulo e pode exigir scripts próprios.
  • Módulos de terceiros sem versão de destino precisam ser portados, trocados ou removidos.
  • Troca de edição (Community para Enterprise) não é atualização de versão.
  • Integrações externas podem exigir ajustes do lado do outro sistema.
Dúvidas frequentes

Perguntas sobre migração de versões

No Enterprise, o serviço da Odoo S.A. leva a base de uma versão suportada até a versão de destino. No Community, com OpenUpgrade, a migração passa por cada versão intermediária, uma de cada vez. Em ambos os casos, as personalizações precisam estar prontas para a versão final.

A virada é planejada para a menor janela possível, de preferência fora do horário de operação. O tempo depende do volume de dados e do número de módulos; medimos isso nas rodadas de teste para definir a janela com segurança.

A troca de edição não é uma atualização de versão e é tratada à parte. As duas mudanças podem ser planejadas no mesmo projeto, mas cada uma tem passos e testes próprios.

Cada uma é avaliada: algumas são adaptadas, outras podem ser substituídas por recursos que passaram a existir no padrão ou na OCA, e outras deixam de ser necessárias. A decisão fica registrada no plano de migração.

Na OCA, os módulos da localização brasileira (l10n-brazil) têm ritmo próprio de migração entre versões. Verificamos a disponibilidade e a maturidade dos módulos que a sua empresa usa antes de definir a versão de destino.

Próximo passo

Vamos avaliar a sua versão atual

Informe versão, edição e principais personalizações, se souber. Com isso, indicamos o caminho de migração mais adequado e o que precisa ser verificado antes.