Django の新しいバージョンへの更新¶

更新時に読むべきドキュメント¶

はじめて Django を更新する時には、Django のリリースプロセスガイド を読んでおくと役に立つでしょう。

更新を行う前には、新しいバージョンの Django ではどのような点が変更されたのかをよく知っておく必要があります。

• まず、リリースノート を読みましょう。読む必要があるのは、現在の Django のバージョンの1つ後から、更新しようと考えているターゲットのバージョンまでの、それぞれの「最後の (final) リリース」のリリースノートです。
• そして、対応するバージョンの 非推奨機能のタイムライン にも目を通します。

中でも特に、後方互換性のない変更点に注意してください。この点に注目すると、正しく更新するために必要なことがはっきりとわかるようになります。

たとえば A.B から A.B+2 のように複数の機能バージョンをアップグレードする場合は、各機能リリースのすべての変更を一度に行うのではなく、各機能リリースを A.B → A.B+1 → A.B+2 のように段階的にアップグレードする方が簡単です。 機能リリースごとに、最新のパッチリリース (A.B.C) を使用してください。

あるLTSから次のLTSにアップグレードする場合は、インクリメンタルなアップグレードする方法を推奨します。

依存関係¶

ほとんどの場合、Django が依存しているパッケージも最新版に更新する必要があるでしょう。その Django のバージョンがリリースされたばかりで、依存関係にあるパッケージがきちんとメンテナンスされていなかった場合、新バージョンの Django に必要なパッケージがまだインストールできないかもしれません。そのような場合には、そうした Django の依存パッケージの新バージョンが使えるようになるまで、少し待たなければならない場合があります。

廃止予定警告を解決する¶

アップグレードの前、Django の現在のバージョンを使っている間に、プロジェクトが挙げてくる廃止予定警告を解決しておくのがよいでしょう。アップグレードの前にこれらの警告を解決することで、コードが警告を必要とする領域について通知されるようにできます。

In Python, deprecation warnings are silenced by default. You must turn them on using the -Wa Python command line option or the PYTHONWARNINGS environment variable. For example, to show warnings while running tests:

$ python -Wa manage.py test

...\> py -Wa manage.py test

Django のテスト実行環境を使用していない場合は、廃止予定警告を隠すような、コンソール出力がキャプチャされていないことを確認する必要があります。例えば、py.test を使っている場合:

$ PYTHONWARNINGS=always py.test tests --capture=no

アップグレードプロセスを続ける前に、Django の現在のバージョンで廃止予定警告を解決してください。

Django の複数バージョンをサポートするために、サードパーティアプリケーションは廃止される API を使用しているかもしれません。そのため、インストールしたパッケージの廃止予定警告は必ずしも問題を示しません。パッケージが Django の最新のバージョンをサポートしていない場合、問題を提起するかプルリクエストを送ることを考えてみてください。

インストール¶

さあ、準備ができたら、新しいバージョンの Django をインストールする 時です。virtualenv を使っていて、これが Django のメジャーアップデートなら、virtualenv で新しい環境をセットアップして、そこに Django を依存パッケージとともにインストールしてもいいでしょう。

Django を pip でインストールした場合は、--upgrade か -U フラグが使用できます。

$ pip install -U Django

...\> pip install -U Django

テスト¶

新しい環境が設定されたら、 run the full test suite 。テストの出力に表示されるように、廃止予定の警告を有効にすると便利です。 (manage.py runserver を使用してアプリケーションを手動でテストする場合は、フラグを使用することもできます)

$ python -Wa manage.py test

...\> py -Wa manage.py test

テストを実行したら、テストに失敗した点をすべて修正しましょう。リリースノートの内容を心に留めながらコードをリファクタリングして、非推奨の警告が出ないようにすれば、Django の新しい機能の恩恵も受けられるかもしれません。

デプロイ¶

新しいバージョンの Django でもアプリケーションが動作すると自信を持って言えるようになったならば、更新した Django プロジェクトを デプロイ する準備ができたことになります．

Django が提供するキャッシュを利用している場合には、更新後にキャッシュをクリアしなければなりません。クリアしなかった場合にはどんな問題が起こり得るでしょうか？ たとえば、pickle 化したオブジェクトをキャッシュしていた場合には、複数のバージョンの Django にわたって pickle の互換性が保証されません。過去の非互換性の例では、pickle 化された HttpResponse オブジェクトを、 cache_page() デコレータを介して直接的または間接的にキャッシュしていました。