Apesar de ser um processo complexo as vezes, atualizar a versão do Django tem muitos benefícios:
\nNovas características e melhorias são adicionadas.
Erros são ajustados.
Versões anteriores 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 processo de atualização mais suave tanto quanto possível.
\nSe esta é sua primeira vez fazendo uma atualização, é útil ler o guia sobre o processo de atualizações diferente.
\nDepois você deveria familiarizar-se com as mudanças que foram feitas na(s) nova(s) versõe(s) do Django.
\nLeia as 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 incompatibilidades das mudanças nas versões anteriores para ter uma idéia clara do que será necessário para uma atualização de sucesso.
\nSe você está atualizando entre mais de uma versão (ex.: A.B para A.B+2), é normalmente mais fácil de atualizar cada versão incrementalmente (A.B para A.B+1 para A.B+2) ao invés de precisar fazer todas as modificações de cada versão lançada de uma vez só. Para cada versão lançada, use o patch de lançamento (A.B.C).
\nA mesma abordagem de atualização incremental é recomendada quando for atualizar de um lançamento LTS para outro.
\nNa maioria dos casos para atualizar para a última versão do Django será necessário atualizar 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.
\nAntes de atualizar, é uma boa idéia resolver qualquer alerta de descontinuidade emitido pelo projeto enquanto estiver usando sua versão do Django atual. Resolvendo estes alertas antes da atualização assegure-se que você tenha informações de todas as áreas do código que precisam de alteração.
\nEm Python, avisos de código obsoleto são silenciados por padrão. Você deve ativá-los usando a opção de linha de comando Python -Wa, ou então a variável de ambiente PYTHONWARNINGS. Por exemplo, para exibir alerta durante a execução de testes:
Linux / macOS
$ python -Wa manage.py test\nWindows
...\\> py -Wa manage.py test\nSe não estiver usando os testes do Django, você deve ter certeza que qualquer saída para o console não está sendo capturada o qual poderia esconder alertas de descontinuidade. Por exemplo, se usar o py.test:
\n$ PYTHONWARNINGS=always py.test tests --capture=no\nResolva qualquer alerta de descontinuidade com sua versão atual do Django antes de continuar o processo de atualização.
\nAplicações de terceiros talvez usem APIs obsoletas para suporta múltiplas versões do Django, então alertas de descontinuidade em pacotes que você tenha instalado não indicam necessariamente um problema. Se um pacote não dá suporte a última versão do Django, considere enviar uma “issue” ou um “pull request” para ele.
\nUma vez que esteja pronto, é hora de instalar 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 dependências primeiro.
\nSe você tiver instalado Django com pip, você pode usar a flag --upgrade ou -U.
Linux / macOS
$ pip install -U Django\nWindows
...\\> pip install -U Django\nQuando o novo ambiente estiver definido, rode todo pacote de teste para sua aplicação. De novo, é útil ligar os alertas de descontinuidade de modo que sejam mostrados na saída dos testes (você também pode usar a “flag” se testar sua aplicação manualmente usando manage.py runserver):
Linux / macOS
$ python -Wa manage.py test\nWindows
...\\> py -Wa manage.py test\nDepois que rodar os testes, concerte as falhas. Enquanto você tem as notas da versão frescas na sua cabeça, talvez seja uma boa hora para tirar vantagem das novas caracterí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 incompatibilidade no passado foi o cache de objetos HttpResponse serializados, diretamente ou indiretamente via o decorador cache_page().