時には更新作業は複雑な手順になってしまうことがありますが、Django の最新版に更新すると、以下ような恩恵が受けられます。
\n新しい機能や改善点が追加される。
バグが修正される。
古いバージョンの Django は最終的にはセキュリティアップデートが受けられなくなる (サポートバージョン を参照してください)。
Django が新しくリリースされた時に更新して、コードベースを最新の状態に保っておけば、将来の更新作業が楽になる。
このセクションでは、更新作業ができるかぎりスムーズに行う助けになるよう、特に注意するべきことをいくつか説明しています。
\nはじめて Django を更新する時には、Django のリリースプロセスガイド を読んでおくと役に立つでしょう。
\n更新を行う前には、新しいバージョンの Django ではどのような点が変更されたのかをよく知っておく必要があります。
\nまず、リリースノート を読みましょう。読む必要があるのは、現在の Django のバージョンの1つ後から、更新しようと考えているターゲットのバージョンまでの、それぞれの「最後の (final) リリース」のリリースノートです。
そして、対応するバージョンの 非推奨機能のタイムライン にも目を通します。
中でも特に、後方互換性のない変更点に注意してください。この点に注目すると、正しく更新するために必要なことがはっきりとわかるようになります。
\nIf you're upgrading through more than one feature version (e.g. A.B to A.B+2),\nit's usually easier to upgrade through each feature release incrementally\n(A.B to A.B+1 to A.B+2) rather than to make all the changes for each feature\nrelease at once. For each feature release, use the latest patch release (A.B.C).
\nThe same incremental upgrade approach is recommended when upgrading from one\nLTS to the next.
\nほとんどの場合、Django が依存しているパッケージも最新版に更新する必要があるでしょう。その Django のバージョンがリリースされたばかりで、依存関係にあるパッケージがきちんとメンテナンスされていなかった場合、新バージョンの Django に必要なパッケージがまだインストールできないかもしれません。そのような場合には、そうした Django の依存パッケージの新バージョンが使えるようになるまで、少し待たなければならない場合があります。
\nアップグレードの前、Django の現在のバージョンを使っている間に、プロジェクトが挙げてくる廃止予定警告を解決しておくのがよいでしょう。アップグレードの前にこれらの警告を解決することで、コードが警告を必要とする領域について通知されるようにできます。
\nPython では、デフォルトでは廃止予定警告は無効化されています。-Wall Python コマンドラインオプションか PYTHONWARNINGS 環境変数を使って有効化する必要があります。例えば、テスト実行中に警告を表示するには:
$ python -Wall manage.py test\nDjango のテスト実行環境を使用していない場合は、廃止予定警告を隠すような、コンソール出力がキャプチャされていないことを確認する必要があります。例えば、py.test を使っている場合:
\n$ PYTHONWARNINGS=all py.test tests --capture=no\nアップグレードプロセスを続ける前に、Django の現在のバージョンで廃止予定警告を解決してください。
\nDjango の複数バージョンをサポートするために、サードパーティアプリケーションは廃止される API を使用しているかもしれません。そのため、インストールしたパッケージの廃止予定警告は必ずしも問題を示しません。パッケージが Django の最新のバージョンをサポートしていない場合、問題を提起するかプルリクエストを送ることを考えてみてください。
\nさあ、準備ができたら、新しいバージョンの Django をインストールする 時です。virtualenv を使っていて、これが Django のメジャーアップデートなら、virtualenv で新しい環境をセットアップして、そこに Django を依存パッケージとともにインストールしてもいいでしょう。
\n次にどのステップを踏むべきかはあなたのインストールの進め方によって変わりますが、一番簡単な方法は、次のように pip に --upgrade または -U フラグを付けて実行するというものです。
$ pip install -U Django\npip を使えば、過去のバージョンの Django も自動的にアンインストールしてくれます。
\nこれ以外のインストールの進め方を選んだ人は、手動で 古いバージョンの Django をアンインストール して、完全なインストール手順を読む必要があるかもしれません。
\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\nテストを実行したら、テストに失敗した点をすべて修正しましょう。リリースノートの内容を心に留めながらコードをリファクタリングして、非推奨の警告が出ないようにすれば、Django の新しい機能の恩恵も受けられるかもしれません。
\n新しいバージョンの Django でもアプリケーションが動作すると自信を持って言えるようになったならば、更新した Django プロジェクトを デプロイ する準備ができたことになります．
\nDjango が提供するキャッシュを利用している場合には、更新後にキャッシュをクリアしなければなりません。クリアしなかった場合にはどんな問題が起こり得るでしょうか？ たとえば、pickle 化したオブジェクトをキャッシュしていた場合には、複数のバージョンの Django にわたって pickle の互換性が保証されません。A past instance of incompatibility was caching pickled HttpResponse objects, either directly or indirectly via the cache_page() decorator.