時には更新作業は複雑な手順になってしまうことがありますが、Django の最新版に更新すると、以下ような恩恵が受けられます。
\n新しい機能や改善点が追加される。
バグが修正される。
Older version of Django will eventually no longer receive security updates.\n(see サポートバージョン).
Django が新しくリリースされた時に更新して、コードベースを最新の状態に保っておけば、将来の更新作業が楽になる。
このセクションでは、更新作業ができるかぎりスムーズに行う助けになるよう、特に注意するべきことをいくつか説明しています。
\nはじめて Django を更新する時には、Django のリリースプロセスガイド を読んでおくと役に立つでしょう。
\n更新を行う前には、新しいバージョンの Django ではどのような点が変更されたのかをよく知っておく必要があります。
\nまず、リリースノート を読みましょう。読む必要があるのは、現在の Django のバージョンの1つ後から、更新しようと考えているターゲットのバージョンまでの、それぞれの「最後の (final) リリース」のリリースノートです。
そして、対応するバージョンの 非推奨機能のタイムライン にも目を通します。
中でも特に、後方互換性のない変更点に注意してください。この点に注目すると、正しく更新するために必要なことがはっきりとわかるようになります。
\nたとえば A.B から A.B+2 のように複数の機能バージョンをアップグレードする場合は、各機能リリースのすべての変更を一度に行うのではなく、各機能リリースを A.B → A.B+1 → A.B+2 のように段階的にアップグレードする方が簡単です。 機能リリースごとに、最新のパッチリリース (A.B.C) を使用してください。
\nあるLTSから次のLTSにアップグレードする場合は、インクリメンタルなアップグレードする方法を推奨します。
\nほとんどの場合、Django が依存しているパッケージも最新版に更新する必要があるでしょう。その Django のバージョンがリリースされたばかりで、依存関係にあるパッケージがきちんとメンテナンスされていなかった場合、新バージョンの Django に必要なパッケージがまだインストールできないかもしれません。そのような場合には、そうした Django の依存パッケージの新バージョンが使えるようになるまで、少し待たなければならない場合があります。
\nアップグレードの前、Django の現在のバージョンを使っている間に、プロジェクトが挙げてくる廃止予定警告を解決しておくのがよいでしょう。アップグレードの前にこれらの警告を解決することで、コードが警告を必要とする領域について通知されるようにできます。
\nIn Python, deprecation warnings are silenced by default. You must turn them on\nusing the -Wa Python command line option or the PYTHONWARNINGS\nenvironment variable. For example, to show warnings while running tests:
Linux / macOS
$ python -Wa manage.py test\nWindows
...\\> py -Wa manage.py test\nDjango のテスト実行環境を使用していない場合は、廃止予定警告を隠すような、コンソール出力がキャプチャされていないことを確認する必要があります。例えば、py.test を使っている場合:
\n$ PYTHONWARNINGS=always py.test tests --capture=no\nアップグレードプロセスを続ける前に、Django の現在のバージョンで廃止予定警告を解決してください。
\nDjango の複数バージョンをサポートするために、サードパーティアプリケーションは廃止される API を使用しているかもしれません。そのため、インストールしたパッケージの廃止予定警告は必ずしも問題を示しません。パッケージが Django の最新のバージョンをサポートしていない場合、問題を提起するかプルリクエストを送ることを考えてみてください。
\nさあ、準備ができたら、新しいバージョンの Django をインストールする 時です。virtualenv を使っていて、これが Django のメジャーアップデートなら、virtualenv で新しい環境をセットアップして、そこに Django を依存パッケージとともにインストールしてもいいでしょう。
\nDjango を pip でインストールした場合は、--upgrade か -U フラグが使用できます。
Linux / macOS
$ pip install -U Django\nWindows
...\\> pip install -U Django\n新しい環境が設定されたら、 run the full test suite 。テストの出力に表示されるように、廃止予定の警告を有効にすると便利です。 (manage.py runserver を使用してアプリケーションを手動でテストする場合は、フラグを使用することもできます)
Linux / macOS
$ python -Wa manage.py test\nWindows
...\\> py -Wa manage.py test\nテストを実行したら、テストに失敗した点をすべて修正しましょう。リリースノートの内容を心に留めながらコードをリファクタリングして、非推奨の警告が出ないようにすれば、Django の新しい機能の恩恵も受けられるかもしれません。
\n新しいバージョンの Django でもアプリケーションが動作すると自信を持って言えるようになったならば、更新した Django プロジェクトを デプロイ する準備ができたことになります．
\nDjango が提供するキャッシュを利用している場合には、更新後にキャッシュをクリアしなければなりません。クリアしなかった場合にはどんな問題が起こり得るでしょうか？ たとえば、pickle 化したオブジェクトをキャッシュしていた場合には、複数のバージョンの Django にわたって pickle の互換性が保証されません。過去の非互換性の例では、pickle 化された HttpResponse オブジェクトを、 cache_page() デコレータを介して直接的または間接的にキャッシュしていました。