Enquanto que isso pode ser as vezes um processo complexo, atualizar a versão do Django tem muitos benefícios:
\nNovas características e melhorias são adicionadas.
Erros são ajustados.
Antigas versões do Django eventualmente não irão receber atualizações de segurança. (veja Versões suportadas).
Atualizando assim que cada versão do Django fica disponível faz com que futuras atualizações sejam menos dolorosas, por mantendo sua base de código atualizada.
Aqui alguns pontos para considerar para ajudar fazer seu process ode atualização mais suave tanto quanto possível.
\nSe esta é sua primeira vez fazendo uma atualização, é útil ler o guia sobre o proesso de atualizações diferente.
\nDepois você deveria familiarizar-se com as mudanças que foram feitas na(s) verõe(s) nova(s) do Django.
\nLeia o notas sobre a edição para cara edição a partir da sua versão de Django corrente, até e inclusive a versão do Django pra qual que você planeja atualizar.
Dê uma olhada no linha do tempo da depreciação para as versões relevantes.
Preste uma atenção particular a imcompatibilidades das mudanças nas versões anteriores para ter uma idéia clara do que será necessário para uma atualização de sucesso.
\nNa marioria dos casos para atualizar para a última versão do Django será necessário atualiar as dependências do Django também. Se a versão do Django foi lançada recentemente ou se algumas de suas dependências não são muito bem mantidas, algumas dependências podem não dar suporte a versão do Django. Nestes casos você terá que esperar até que a nova versão das dependências sejam lançadas.
\nBefore upgrading, it’s a good idea to resolve any deprecation warnings raised\nby your project while using your current version of Django. Fixing these\nwarnings before upgrading ensures that you’re informed about areas of the code\nthat need altering.
\nIn Python, deprecation warnings are silenced by default. You must turn them on\nusing the -Wall Python command line option or the PYTHONWARNINGS\nenvironment variable. For example, to show warnings while running tests:
$ python -Wall manage.py test\nIf you’re not using the Django test runner, you may need to also ensure that\nany console output is not captured which would hide deprecation warnings. For\nexample, if you use py.test:
\n$ PYTHONWARNINGS=all py.test tests --capture=no\nResolve any deprecation warnings with your current version of Django before\ncontinuing the upgrade process.
\nThird party applications might use deprecated APIs in order to support multiple\nversions of Django, so deprecation warnings in packages you’ve installed don’t\nnecessarily indicate a problem. If a package doesn’t support the latest version\nof Django, consider raising an issue or sending a pull request for it.
\nUma vez que esteja pronto, é hora de Instale a nova versão do Django. Se estiver usando o virtualenv e for uma atualização grande, você talvez queira configurar um novo ambiente com todas as depoendências primeiro.
\nOs passos exatos que serão necessários depende do seu processo de inatalação. O jeito mais conveniente é usar o pip com --upgrade ou o parametro -U:
$ pip install -U Django\nO pip também automaticamente desinstala as versões anteriores do Django.
\nSe você usa outros processos de instalação, tavez seja necessário manualmente desinstalar a versão antig do Django e deve dar uma olhada nas instruções completas de instalação.
\nWhen the new environment is set up, run the full test suite for your application. Again, it’s useful to turn\non deprecation warnings on so they’re shown in the test output (you can also\nuse the flag if you test your app manually using manage.py runserver):
$ python -Wall manage.py test\nDepois que rodar os testes, concerte as falhas. Enquanto você tem as notas da versão frescas na sa cabeça, talvez seja uma boa hora para tirar vantagem das novas caraceterísticas do Django refatorando o código para eliminar qualquer alerta de descontinuidade.
\nQuando você estiver suficientemente confiante que sua aplicação funciona com a nova versão do Django, você está pronto para ir em frente e implantar seu projeto com Django atualizado.
\nSe você estiver usando o cache fornecido pelo Django, você deve considerar limpar o cache depois da atualização. De outro modo você pode ter problemas, por exemplo, se você estiver mantendo em cache objetos serializados e estes objetos não tem garantia de compatibilidade de serialização entre as versões do Django. Um problema de imcompatibilidade no passado foi o cache de objetos HttpResponse serializados, diretamente ou indiretamente via o decorador cache_page().