Resumo do upgrade

1. Request an upgraded test database (see obtaining an upgraded test database <upgrade-request-test>).

2. If applicable, upgrade the source code of your custom module to be compatible with the new version of Odoo (see /developer/howtos/upgrade_custom_db).

3. Thoroughly test the upgraded database (see testing the new version of the database <upgrade-testing>).

4. Report any issue encountered during the testing to Odoo by going to the Support page and selecting "An issue related to my future upgrade (I am testing an upgrade)".

5. Once all issues are resolved and you are confident that the upgraded database can be used as your main database without any issues, plan the upgrade of your production database.

6. Request the upgrade for the production database, rendering it unavailable for the time it takes to complete the process (see upgrading the production database <upgrade-production>).

7. Report any issue encountered during the upgrade to Odoo by going to the Support page and selecting "An issue related to my upgrade (production)".

Obter upgrade de uma base de dados de teste

A Página de upgrade é a principal plataforma para solicitar um upgrade da base de dados. No entanto, dependendo do tipo de hospedagem, você pode fazer upgrade a partir da linha de comando (local), do gerenciador de bases de dados do Odoo Online ou do seu projeto do Odoo.sh.

Para fazer upgrade de um banco de dados Odoo Online:

1. Open the database manager.

2. Select the database and click fa-gears Manage.

3. Click Upgrade in the Database section.

4. In the popup:

   • Select the version of Odoo you want to upgrade to, usually the latest version.

   • Enter the Email to notify, which will receive a link to the upgraded database.

   • Select the Purpose of the upgrade, which is automatically set to Test for your first upgrade request.

   • Click Upgrade.

No gerenciador de banco de dados, o botão Conectar será substituído por um botão não clicável Atualizando... até a conclusão. Após o sucesso do processo, um email contendo um link para o banco de dados de teste atualizado é enviado para o endereço fornecido. O banco de dados de teste também pode ser acessado a partir do gerenciador de banco de dados clicando no botão fa-caret-down (seta para baixo) antes do nome do banco de dados para exibir o banco de dados de teste e, em seguida, clicando em Conectar.

O Odoo.sh é integrado à plataforma de upgrade para simplificar o processo.

O último backup automático diário de produção é então enviado para a plataforma de upgrade.

Quando a plataforma de upgrade termina de atualizar o backup e de carregá-lo na filial, ela é colocada em um modo especial: toda vez que um commit é enviado para a ramificação, ocorre uma operação de restauração do backup atualizado e uma atualização de todos os módulos personalizados. Isso permite que você teste seus módulos personalizados em uma cópia original da base de dados com upgrade. O arquivo de registro do processo de upgrade pode ser encontrado na compilação de teste recém-atualizada, acessando ~/logs/upgrade.log.

Nas bases de dados com módulos personalizados instalados, o código-fonte deve estar atualizado com a versão de destino do Odoo antes que o upgrade possa ser realizado. Se não houver nenhum, o modo "atualizar ao fazer commit" é ignorado, a base de dados com upgrade é compilada assim que é transferida da plataforma de upgrade e o modo de upgrade é fechado.

Consulte a página /developer/howtos/upgrade_custom_db para obter mais informações.

O processo de upgrade padrão pode ser iniciado digitando a seguinte linha de comando na máquina em que a base de dados está hospedada:

$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>

Esse comando tem alguns requisitos sobre o ambiente em que é executado:

• Some external commands that must be provided by the operating system, normally found in any Linux distribution (including WSL). An error will be displayed if one or several of them are missing.

• The system user that executes the command needs to be configured with access to the database. Please refer to the PostgreSQL documentation of the client environment or the client password file for this requirement.

• The script needs to be able to reach one or multiple servers of the upgrade platform both on TCP port 443 and to any random TCP port in the range between 32768 and 60999. This can be in conflict with your restrictive firewall and may need an exception added to the firewall configuration.

O seguinte comando pode ser usado para exibir a ajuda geral e os principais comandos:

$ python <(curl -s https://upgrade.odoo.com/upgrade) --help

Uma base de dados de teste com upgrade também pode ser solicitada por meio da Página de upgrade.

Nas bases de dados com módulos personalizados instalados, o código-fonte deve estar atualizado com a versão de destino do Odoo antes que o upgrade possa ser realizado. Consulte a página /developer/howtos/upgrade_custom_db para obter mais informações.

Testar a nova versão da base de dados

É essencial testar a base de dados de teste com upgrade para garantir que você não se perca em suas atividades diárias por causa de uma alteração nas visualizações, no comportamento ou em uma mensagem de erro quando o upgrade entrar em operação.

É altamente recomendável testar o maior número possível de fluxos de negócios para garantir que estejam funcionando corretamente e para se familiarizar com a nova versão.

Essa lista é não exaustiva. Estenda o exemplo para os outros aplicativos com base no seu uso do Odoo.

Se você enfrentar um problema ao testar sua base de dados de teste do upgrade, poderá solicitar a assistência da Odoo acessando a página Suporte e selecionando "Problema relacionado ao meu upgrade futuro (estou testando um upgrade)". Em qualquer caso, é essencial relatar qualquer problema encontrado durante o teste para corrigi-lo antes de fazer upgrade da sua base de dados de produção.

Você pode encontrar diferenças significativas com visualizações, recursos, campos e modelos padrão durante o teste. Essas alterações não podem ser revertidas caso a caso. No entanto, se uma alteração introduzida por uma nova versão interromper uma personalização, é responsabilidade do mantedor do seu módulo personalizado torná-lo compatível com a nova versão do Odoo.

Fazer upgrade da base de dados de produção

Depois que os testes <upgrade-testing> forem concluídos e você tiver certeza de que a base de dados do upgrade pode ser usada como sua base de dados principal sem problemas, é hora de planejar o dia do go-live.

Sua base de dados de produção ficará indisponível durante o upgrade. Por isso, recomendamos planejar o upgrade em um momento de uso mínimo da base de dados.

Como os scripts de upgrade padrão e sua base de dados estão em constante evolução, também é recomendável solicitar com frequência outra base de dados de teste com upgrade para garantir que o processo de upgrade ainda seja bem-sucedido, especialmente se demorar muito para ser concluído. Recomenda-se também ensaiar completamente o processo de upgrade um dia antes de fazer o upgrade da base de dados de produção.

O processo de upgrade de uma base de dados de produção é semelhante ao upgrade de uma base de dados de teste, mas com algumas exceções.

O processo é semelhante ao obtenção de uma base de dados de teste do upgrade <upgrade-request-test>, exceto pela opção de finalidade, que deve ser definida como Produção em vez de Teste.

Após a solicitação de upgrade, a base de dados ficará indisponível até que o upgrade seja concluído. Depois que o processo for concluído, será impossível reverter para a versão anterior.

O processo é semelhante à obtenção de uma base de dados de teste de upgrade <upgrade-request-test> na ramificação Produção.

O processo é acionado assim que um novo commit é feito na ramificação. Isso permite que o processo de upgrade seja sincronizado com a implementação do código-fonte atualizado dos módulos personalizados. Se não houver módulos personalizados, o processo de upgrade será acionado imediatamente.

A base de dados fica indisponível durante todo o processo. Se algo der errado, a plataforma reverterá automaticamente o upgrade, como aconteceria em uma atualização regular. Em caso de sucesso, é criado um backup da base de dados antes do upgrade.

A atualização de seus módulos personalizados deve ser bem-sucedida para concluir todo o processo de upgrade. Certifique-se de que o status de seu upgrade de teste seja bem-sucedido antes de tentar fazer upgrade na de produção. Mais informações sobre como atualizar seus módulos personalizados podem ser encontradas em /developer/howtos/upgrade_custom_db.

O comando para upgrade uma base de dados para produção é semelhante ao de upgrade de uma base de dados de teste, exceto pelo argumento test, que deve ser substituído por production:

$ python <(curl -s https://upgrade.odoo.com/upgrade) production -d <your db name> -t <target version>

Uma base de dados de produção com upgrade também pode ser solicitada pela Página de upgrade.

Depois que a base de dados for carregada, as modificações da sua base de dados de produção não estarão presentes na base de dados com upgrade. É por isso que recomendamos não usá-la durante o processo de upgrade.

Ao solicitar um upgrade de base de dados para fins de produção, a cópia é enviada sem um armazenamento de arquivos. Portanto, o armazenamento de arquivos da base de dados com upgrade deve ser mesclado com o armazenamento de arquivos de produção antes de implementar a nova versão.

No caso de um problema com sua base de dados de produção, você pode solicitar a assistência da Odoo acessando a Página de Suporte e selecionando "Um problema relacionado à minha atualização (produção)".

Acordos de Nível de Serviço (SLA)

Com o Odoo Enterprise, o upgrade de uma base de dados para a versão mais recente do Odoo é gratuito, incluindo qualquer suporte necessário para corrigir possíveis discrepâncias na base de dados com upgrade.

As informações sobre os serviços de upgrade incluídos na licença Enterprice estão disponíveis no Contrato de Assinatura Enterprise da Odoo <upgrade>. No entanto, esta seção esclarece quais serviços de upgrade você pode esperar.