序章
Djangoは、動的なWebサイトとアプリケーションを開発するためのフル機能のPythonWebフレームワークです。 Djangoを使用すると、Python Webアプリケーションをすばやく作成し、フレームワークを利用して手間のかかる作業を大幅に行うことができます。
このガイドでは、Debian8サーバーでDjangoを起動して実行する方法を説明します。 インストール後、サイトの基盤として使用する新しいプロジェクトを開始する方法を説明します。
前提条件
始める前に、root以外のユーザーが sudo
Debian8サーバーで利用可能な特権。 これを設定するには、Debian8初期サーバー設定ガイドに従ってください。
続行する準備ができたら、以下を読んで、状況に最適なインストール方法を決定してください。
利用可能なインストール方法
ニーズや開発環境の構成方法に応じて、Djangoをインストールする方法はいくつかあります。 これらにはさまざまな利点があり、1つの方法が他の方法よりも特定の状況に適している場合があります。
さまざまな方法のいくつかを以下に示します。
- パッケージからのグローバルインストール:公式のDebianリポジトリには、従来の方法で簡単にインストールできるDjangoパッケージが含まれています
apt
パッケージマネージャー。 これは非常に単純ですが、他の方法ほど柔軟ではありません。 また、リポジトリに含まれているバージョンは、プロジェクトから入手できる公式バージョンより遅れている可能性があります。 - pipによるグローバルインストール:
pip
ツールはPythonパッケージのパッケージマネージャーです。 インストールする場合pip
、Djangoをシステムレベルに簡単にインストールして、すべてのユーザーが使用できるようにすることができます。 これには、常に最新の安定したリリースが含まれている必要があります。 それでも、グローバルインストールは本質的に柔軟性が低くなります。 - Virtualenvにpipを介してインストール:Python
virtualenv
パッケージを使用すると、さまざまなプロジェクト用の自己完結型の環境を作成できます。 このテクノロジーを使用すると、システムレベルのパッケージに影響を与えることなく、プロジェクトディレクトリにDjangoをインストールできます。 これにより、プロジェクトごとのカスタマイズとパッケージを簡単に提供できます。 仮想環境は、グローバルにアクセス可能なインストールと比較して、精神的およびプロセスのオーバーヘッドをわずかに追加しますが、最も柔軟性があります。 - 開発バージョンgitを介したインストール:安定版リリースではなく最新の開発バージョンをインストールする場合は、からコードを取得する必要があります。
git
レポ。 これは、最新の機能/修正を取得するために必要な場合があり、グローバルまたはローカルで実行できます。 ただし、開発バージョンには同じ安定性の保証はありません。
上記の注意事項と品質を念頭に置いて、以下の手順からニーズに最適なインストール方法を選択してください。 その後、サンプルプロジェクトの作成のセクションを確認して、開始方法を確認してください。
パッケージからのグローバルインストール
Debianリポジトリを使用してDjangoをインストールしたい場合、プロセスは非常に簡単です。
まず、ローカルパッケージインデックスを次のように更新します apt
:
- sudo apt-get update
次に、Djangoで使用するPythonバージョンを選択します。 Python 2 の場合、次のように入力します。
- sudo apt-get install python-django
代わりに、 Python 3 をDjangoで使用する場合は、次のように入力します。
- sudo apt-get install python3-django
次のように入力して、インストールが成功したことをテストできます。
- django-admin --version
Output1.7.11
これは、ソフトウェアが正常にインストールされたことを意味します。 また、Djangoバージョンが最新の安定版ではないことに気付くかもしれません。 ソフトウェアの使用方法について少し学ぶには、スキップしてサンプルプロジェクトの作成方法を学びましょう。
pipを介したグローバルインストール
Djangoの最新バージョンをグローバルにインストールしたい場合は、より良いオプションを使用することです pip
、Pythonパッケージマネージャー。 まず、をインストールする必要があります pip
パッケージマネージャー。 更新する apt
パッケージインデックス:
- sudo apt-get update
これで、適切なパッケージをインストールして、インストールを完了することができます。 必要なパッケージとコマンドは、プロジェクトで使用する予定のPythonのバージョンによって異なります。
Python 2
Python 2の使用を計画している場合は、 pip
、Pythonパッケージマネージャー。次のコマンドを使用します。
- sudo apt-get install python-pip
今、あなたは pip
、次のように入力すると、Djangoを簡単にインストールできます。
- sudo pip install django
次のように入力すると、インストールが成功したことを確認できます。
- django-admin --version
Output1.10.4
ご覧のとおり、 pip
Debianリポジトリのものよりも最新です(あなたのリポジトリは上記とは異なる可能性があります)。
Python 3
Python 3 を使用する場合は、 pip
このコマンドの使用:
- sudo apt-get install python3-pip
次に、 pip
次のように入力してDjangoをインストールするパッケージマネージャー:
- sudo pip3 install django
インストールが正しく完了したことを確認するには、次のように入力します。
- django-admin --version
Output1.10.4
を介してインストールされたバージョン pip
最新の安定したリリースである必要があります(特定のバージョンは上記のものとは異なる場合があります)。
Virtualenvpipを介してインストール
おそらく、システムにDjangoをインストールする最も柔軟な方法は、 virtualenv
道具。 このツールを使用すると、システムの他の部分に影響を与えることなく、必要なPythonパッケージをインストールできる仮想Python環境を作成できます。 これにより、他のプロジェクトの要件との競合に関係なく、プロジェクトごとにPythonパッケージを選択できます。
インストールから始めます pip
Debianリポジトリから。 開始する前に、ローカルパッケージインデックスを更新してください。
- sudo apt-get update
Djangoのインストールに必要なパッケージとコマンドは、プロジェクトで使用するPythonのバージョンによって異なります。 使用する予定のPythonのバージョンについては、以下の手順に従ってください。
Python 2
最初のステップはインストールすることです pip
グローバルに。 Python 2を使用する場合、これを行うコマンドは次のとおりです。
- sudo apt-get install python-pip
一度 pip
がインストールされている場合は、それを使用してインストールできます virtualenv
次のように入力してパッケージ化します。
- sudo pip install virtualenv
これで、新しいプロジェクトを開始するたびに、そのプロジェクトの仮想環境を作成できます。 新しいプロジェクトディレクトリを作成して移動することから始めます。
- mkdir ~/projectname
- cd ~/projectname
次に、次のように入力して、プロジェクトディレクトリ内に仮想環境を作成します。
- virtualenv venv
これにより、スタンドアロンバージョンのPythonと、 pip
、プロジェクトディレクトリ内の分離されたディレクトリ構造に。 仮想環境と呼ぶことにしました venv
、ただし、わかりやすい名前を付けることができます。 選択した名前でディレクトリが作成され、パッケージがインストールされるファイル階層が保持されます。
分離された環境にパッケージをインストールするには、次のように入力してパッケージをアクティブ化する必要があります。
- cd ~/projectname
- source venv/bin/activate
プロンプトは、仮想環境にいることを反映するように変更されます。 それは次のようになります (venv)username@hostname:~/projectname$
.
新しい環境では、次を使用できます pip
Djangoをインストールします。 使用する必要はありません sudo
ローカルにインストールしているので:
- pip install django
次のように入力して、インストールを確認できます。
- django-admin --version
Output1.10.4
ご覧のとおり、Djangoは仮想環境にインストールされています。
注:仮想環境を終了するには、 deactivate
システム上のどこからでもコマンド:
- deactivate
プロンプトは従来の表示に戻るはずです。
プロジェクトで再度作業する場合は、プロジェクトディレクトリに戻ってアクティブ化することにより、仮想環境を再度アクティブ化する必要があります。
- cd ~/projectname
- source venv/bin/activate
Python 3
最初のステップはインストールすることです pip
グローバルに。 Python 3でこれを行うには、次のように入力します。
- sudo apt-get install python3-pip
次に、インストールしたパッケージマネージャーを使用して virtualenv
Pythonパッケージ:
- sudo pip3 install virtualenv
次に、新しいプロジェクトのパッケージを保持する仮想環境を作成します。 新しいプロジェクトディレクトリを作成して移動することから始めます。
- mkdir ~/projectname
- cd ~/projectname
次のように入力して、プロジェクトディレクトリ内に仮想環境を作成します。
- virtualenv venv
これにより、スタンドアロンバージョンのPythonと、 pip
、プロジェクトディレクトリ内の分離されたディレクトリ構造に。 引数として渡された名前でディレクトリが作成されます。 選択しました venv
ここ。 このディレクトリは、パッケージがインストールされるファイル階層を保持します。
パッケージを仮想環境にインストールする前に、次のように入力してパッケージをアクティブ化する必要があります。
- cd ~/projectname
- source venv/bin/activate
これで、コマンドプロンプトの前に仮想環境の名前を付ける必要があります。 それは次のようになります (venv)username@hostname:~/projectname$
.
新しい環境では、 pip
Djangoをインストールします。 Python 3を使用している場合でも、仮想環境内のコマンドはであることに注意してください。 pip
(いいえ pip3
). また、はを使用する必要がないことに注意してください sudo
ローカルにインストールしているので:
- pip install django
次のように入力して、インストールを確認できます。
- django-admin --version
Output1.10.4
ご覧のとおり、Djangoは仮想環境にインストールされています。
注:仮想環境を終了するには、 deactivate
システム上のどこからでもコマンド:
- deactivate
プロンプトは従来の表示に戻るはずです。
プロジェクトで再度作業する場合は、プロジェクトディレクトリに戻ってアクティブ化することにより、仮想環境を再度アクティブ化する必要があります。
- cd ~/projectname
- source venv/bin/activate
開発バージョンgitを介してインストール
Djangoの開発バージョンが必要な場合は、プロジェクトのからDjangoをダウンロードしてインストールする必要があります。 git
リポジトリ。
そのためには、最初にインストールします git
システム上で apt
. 私たちも必要になります pip
、ダウンロードしたソースコードからインストールするために使用されます。 パッケージ名とコマンドは、Djangoで使用する予定のPythonのバージョンによって異なります。
Python 2
Python 2を使用している場合は、次のように入力して、パッケージインデックスを更新し、必要なパッケージをインストールできます。
- sudo apt-get update
- sudo apt-get install git python-pip
あなたが持ったら git
、Djangoリポジトリのクローンを作成できます。 リリース間で、このリポジトリには、安定性を犠牲にして、より最新の機能とバグ修正が含まれるようになります。 リポジトリをというディレクトリに複製できます django-dev
ホームディレクトリ内で次のように入力します。
- git clone git://github.com/django/django ~/django-dev
リポジトリのクローンが作成されたら、次を使用してリポジトリをインストールできます。 pip
. を使用します -e
「編集可能」モードでインストールするオプション。これは、バージョン管理からインストールする場合に必要です。 Pythonのバージョン2を使用している場合は、次のように入力します。
- sudo pip install -e ~/django-dev
次のように入力すると、インストールが成功したことを確認できます。
- django-admin --version
Output1.11.dev20161220175814
この戦略を次のように組み合わせることができることに注意してください virtualenv
単一の環境に開発バージョンのDjangoをインストールする場合。
Python 3
Python 3 を使用している場合は、パッケージインデックスを更新してインストールします git
と pip
次のように入力します。
- sudo apt-get update
- sudo apt-get install git python3-pip
次に、Djangoリポジトリをというディレクトリに複製できます django-dev
ホームディレクトリ内で次のように入力します。
- git clone git://github.com/django/django ~/django-dev
Djangoはから直接インストールできます git
ディレクトリと pip
. The -e
オプションを使用すると、バージョン管理リポジトリからインストールするときに必要な「編集可能」モードでインストールできます。
- sudo pip3 install -e ~/django-dev
次のように入力すると、インストールが成功したことを確認できます。
- django-admin --version
Output1.11.dev20161220175814
分離された環境内に開発バージョンをインストールする場合は、この戦略を virtualenv
ストラテジー。
サンプルプロジェクトの作成
Djangoをインストールしたら、プロジェクトを開始する方法を紹介します。
プロジェクトの基本を作成する
使用 django-admin
プロジェクトを作成するコマンド。 これにより、というディレクトリが作成されます projectname
現在のディレクトリ内。 この新しいディレクトリ内に、管理スクリプトが作成され、別のディレクトリが呼び出されます。 projectname
実際のコードで作成されます。
注:で使用するために作成した親プロジェクトディレクトリがすでにある場合 virtualenv
コマンドを使用すると、管理スクリプトと内部ディレクトリを既存のディレクトリに直接配置するようにDjangoに指示できます。 これにより、プロジェクトディレクトリの余分なレイヤーを回避できます。
- cd ~/projectname
- source venv/bin/activate
- django-admin startproject projectname .
コマンドの最後にある終了ドットに注意してください。
完全なディレクトリ構造(親プロジェクトディレクトリ、管理スクリプト、および内部プロジェクトディレクトリ)を作成するには、次のように入力します。
- django-admin startproject projectname
- cd projectname
データベースをブートストラップするには(これはデフォルトでSQLiteを使用します)、次のように入力します。
- ./manage.py migrate
次に、次のように入力して管理ユーザーを作成します。
- ./manage.py createsuperuser
ユーザーのユーザー名、電子メールアドレス、およびパスワードを選択するように求められます。
Django設定でALLOWED_HOSTSを変更する
アプリケーションをテストする前に、Django設定のディレクティブの1つを変更する必要があります。
次のように入力して、設定ファイルを開きます。
- nano ~/projectname/projectname/settings.py
内部で、 ALLOWED_HOSTS
指令。 これは、Djangoインスタンスへの接続に使用できるアドレスまたはドメイン名のホワイトリストを定義します。 このリストにないHostヘッダーを持つ着信要求は、例外を発生させます。 Djangoでは、特定のクラスのセキュリティの脆弱性を防ぐためにこれを設定する必要があります。
角かっこ内に、Djangoサーバーに関連付けられているIPアドレスまたはドメイン名をリストします。 各項目は、引用符で、エントリをコンマで区切ってリストする必要があります。 ドメインおよびサブドメインの要求に応答する場合は、エントリの先頭にピリオドを追加します。 以下のスニペットには、エントリをフォーマットする正しい方法を示すために使用されるコメントアウトされた例がいくつかあります。
. . .
# The simplest case: just add the domain name(s) and IP addresses of your Django server
# ALLOWED_HOSTS = [ 'example.com', '203.0.113.5']
# To respond to 'example.com' and any subdomains, start the domain with a dot
# ALLOWED_HOSTS = ['.example.com', '203.0.113.5']
ALLOWED_HOSTS = ['your_server_domain_or_IP', 'second_domain_or_IP', . . .]
終了したら、ファイルを保存して閉じます。
開発サーバーでのテスト
次に、Django開発サーバーを起動して、新しいDjangoプロジェクトがどのように見えるかを確認します。 これは開発目的でのみ使用してください。
注:開発サーバーを試す前に、ファイアウォールでポートを開いていることを確認してください。
あなたがたまたま実行している場合 ufw
ファイアウォールの場合、次のように入力して適切なポートを開くことができます。
- sudo ufw allow 8000
あなたが実行している場合 iptables
ファイアウォール。必要な正確なコマンドは、現在のファイアウォール構成によって異なります。 ほとんどの構成の場合、次のコマンドが機能するはずです。
- sudo iptables -I INPUT -p tcp --dport 8000 -j ACCEPT
次のように入力して、開発サーバーを起動します。
- ~/projectname/manage.py runserver 0.0.0.0:8000
サーバーのIPアドレスにアクセスしてから :8000
Webブラウザで
http://server_ip_address:8000
次のようなものが表示されます。
今、追加 /admin
URLの最後に移動して、管理者ログインページにアクセスします。
server_ip_address:8000/admin
作成した管理者のユーザー名とパスワードを入力すると、サイトの管理者セクションに移動します。
デフォルトサイトの確認が終了したら、次のように入力して開発サーバーを停止できます。 CTRL-C
あなたのターミナルで。
作成したDjangoプロジェクトは、より完全なサイトを設計するための構造的な基盤を提供します。 アプリケーションを構築してサイトをカスタマイズする方法の詳細については、Djangoのドキュメントを確認してください。
結論
これで、Debian 8サーバーにDjangoがインストールされ、強力なWebアプリケーションを作成するために必要な主要なツールが提供されます。 また、新しいプロジェクトを開始して開発者サーバーを起動する方法も知っておく必要があります。 Djangoのような完全なWebフレームワークを活用すると、開発が高速化され、アプリケーションの固有の側面にのみ集中できるようになります。