Ubuntu16.04でPostgres、Nginx、Gunicornを使用してDjangoを設定する方法
序章
Djangoは、PythonアプリケーションまたはWebサイトを立ち上げるのに役立つ強力なWebフレームワークです。 Djangoには、コードをローカルでテストするための簡略化された開発サーバーが含まれていますが、本番環境に少しでも関連する場合は、より安全で強力なWebサーバーが必要です。
このガイドでは、Djangoアプリケーションをサポートおよび提供するためにUbuntu16.04にいくつかのコンポーネントをインストールして構成する方法を示します。 デフォルトのSQLiteデータベースを使用する代わりに、PostgreSQLデータベースをセットアップします。 アプリケーションとインターフェイスするようにGunicornアプリケーションサーバーを構成します。 次に、GunicornにリバースプロキシするようにNginxを設定し、アプリを提供するためのセキュリティ機能とパフォーマンス機能にアクセスできるようにします。
前提条件と目標
このガイドを完了するには、root以外のユーザーがいる新しいUbuntu16.04サーバーインスタンスが必要です。 sudo
構成された特権。 初期サーバーセットアップガイドを実行すると、これをセットアップする方法を学ぶことができます。
仮想環境内にDjangoをインストールします。 プロジェクトに固有の環境にDjangoをインストールすると、プロジェクトとその要件を個別に処理できるようになります。
データベースとアプリケーションを起動して実行したら、Gunicornアプリケーションサーバーをインストールして構成します。 これは、アプリケーションへのインターフェイスとして機能し、HTTPのクライアントリクエストをアプリケーションが処理できるPython呼び出しに変換します。 次に、Gunicornの前にNginxをセットアップして、その高性能接続処理メカニズムと実装が容易なセキュリティ機能を活用します。
始めましょう。
Ubuntuリポジトリからパッケージをインストールします
プロセスを開始するには、Ubuntuリポジトリから必要なすべてのアイテムをダウンロードしてインストールします。 Pythonパッケージマネージャーを使用します pip
少し後で追加のコンポーネントをインストールします。
ローカルを更新する必要があります apt
パッケージインデックスを作成し、パッケージをダウンロードしてインストールします。 インストールするパッケージは、プロジェクトで使用するPythonのバージョンによって異なります。
Python 2 を使用している場合は、次のように入力します。
- sudo apt-get update
- sudo apt-get install python-pip python-dev libpq-dev postgresql postgresql-contrib nginx
Python 3 でDjangoを使用している場合は、次のように入力します。
- sudo apt-get update
- sudo apt-get install python3-pip python3-dev libpq-dev postgresql postgresql-contrib nginx
これによりインストールされます pip
、後でGunicornを構築するために必要なPython開発ファイル、Postgresデータベースシステムとそれと対話するために必要なライブラリ、およびNginxWebサーバー。
PostgreSQLデータベースとユーザーを作成する
すぐに参加して、Djangoアプリケーション用のデータベースとデータベースユーザーを作成します。
デフォルトでは、Postgresはローカル接続に「ピア認証」と呼ばれる認証スキームを使用します。 基本的に、これは、ユーザーのオペレーティングシステムのユーザー名が有効なPostgresユーザー名と一致する場合、そのユーザーはそれ以上の認証なしでログインできることを意味します。
Postgresのインストール中に、 postgres
に対応するために作成されました postgres
PostgreSQL管理ユーザー。 このユーザーを使用して管理タスクを実行する必要があります。 sudoを使用して、-uオプションを指定してユーザー名を渡すことができます。
次のように入力して、インタラクティブなPostgresセッションにログインします。
- sudo -u postgres psql
要件を設定できるPostgreSQLプロンプトが表示されます。
まず、プロジェクトのデータベースを作成します。
- CREATE DATABASE myproject;
ノート
すべてのPostgresステートメントはセミコロンで終了する必要があるため、問題が発生している場合は、コマンドがセミコロンで終了していることを確認してください。
次に、プロジェクトのデータベースユーザーを作成します。 安全なパスワードを選択してください。
- CREATE USER myprojectuser WITH PASSWORD 'password';
その後、作成したユーザーの接続パラメーターのいくつかを変更します。 これにより、データベース操作が高速化されるため、接続が確立されるたびに正しい値を照会して設定する必要がなくなります。
Djangoが期待するデフォルトのエンコーディングをUTF-8に設定しています。 また、デフォルトのトランザクション分離スキームを「読み取りコミット」に設定しています。これは、コミットされていないトランザクションからの読み取りをブロックします。 最後に、タイムゾーンを設定します。 デフォルトでは、Djangoプロジェクトは使用するように設定されます UTC
. これらはすべて、Djangoプロジェクト自体からの推奨事項です。
- ALTER ROLE myprojectuser SET client_encoding TO 'utf8';
- ALTER ROLE myprojectuser SET default_transaction_isolation TO 'read committed';
- ALTER ROLE myprojectuser SET timezone TO 'UTC';
これで、新しいユーザーに新しいデータベースを管理するためのアクセス権を与えることができます。
- GRANT ALL PRIVILEGES ON DATABASE myproject TO myprojectuser;
終了したら、次のように入力してPostgreSQLプロンプトを終了します。
- \q
プロジェクト用のPython仮想環境を作成します
データベースができたので、残りのプロジェクト要件の準備を始めることができます。 管理を容易にするために、Python要件を仮想環境内にインストールします。
これを行うには、最初ににアクセスする必要があります virtualenv
指図。 これをインストールできます pip
.
Python 2 を使用している場合は、アップグレードしてください pip
次のように入力してパッケージをインストールします。
- sudo -H pip install --upgrade pip
- sudo -H pip install virtualenv
Python 3 を使用している場合は、アップグレードしてください pip
次のように入力してパッケージをインストールします。
- sudo -H pip3 install --upgrade pip
- sudo -H pip3 install virtualenv
と virtualenv
インストールすると、プロジェクトの形成を開始できます。 プロジェクトファイルを保持できるディレクトリを作成して移動します。
- mkdir ~/myproject
- cd ~/myproject
プロジェクトディレクトリ内で、次のように入力してPython仮想環境を作成します。
- virtualenv myprojectenv
これにより、というディレクトリが作成されます myprojectenv
あなたの中で myproject
ディレクトリ。 内部には、Pythonのローカルバージョンとのローカルバージョンがインストールされます pip
. これを使用して、プロジェクト用に分離されたPython環境をインストールおよび構成できます。
プロジェクトのPython要件をインストールする前に、仮想環境をアクティブ化する必要があります。 次のように入力すると、次のように入力できます。
- source myprojectenv/bin/activate
プロンプトが変化して、Python仮想環境内で操作していることを示します。 次のようになります。 (myprojectenv)user@host:~/myproject$
.
仮想環境をアクティブにして、Django、Gunicorn、および psycopg2
ローカルインスタンスが pip
:
ノート
使用しているPythonのバージョンに関係なく、仮想環境がアクティブ化されている場合は、 pip
コマンド(ではない pip3
).
- pip install django gunicorn psycopg2
これで、Djangoプロジェクトを開始するために必要なすべてのソフトウェアが揃いました。
新しいDjangoプロジェクトを作成して構成する
Pythonコンポーネントをインストールすると、実際のDjangoプロジェクトファイルを作成できます。
Djangoプロジェクトを作成する
すでにプロジェクトディレクトリがあるので、ここにファイルをインストールするようにDjangoに指示します。 通常の実際のコードを使用して第2レベルのディレクトリを作成し、このディレクトリに管理スクリプトを配置します。 これの鍵は、Djangoが現在のディレクトリに関連して決定を下せるようにするのではなく、ディレクトリを明示的に定義していることです。
- django-admin.py startproject myproject ~/myproject
この時点で、プロジェクトディレクトリ(~/myproject
この場合)には、次の内容が含まれている必要があります。
~/myproject/manage.py
:Djangoプロジェクト管理スクリプト。~/myproject/myproject/
:Djangoプロジェクトパッケージ。 これには、__init__.py
,settings.py
,urls.py
、 とwsgi.py
ファイル。~/myproject/myprojectenv/
:前に作成した仮想環境ディレクトリ。
プロジェクト設定を調整する
新しく作成したプロジェクトファイルで最初に行うべきことは、設定を調整することです。 テキストエディタで設定ファイルを開きます。
- nano ~/myproject/myproject/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', . . .]
次に、データベースアクセスを構成するセクションを見つけます。 それはで始まります DATABASES
. ファイル内の構成はSQLiteデータベース用です。 プロジェクト用にPostgreSQLデータベースを作成済みなので、設定を調整する必要があります。
PostgreSQLデータベース情報で設定を変更します。 Djangoに使用するように指示します psycopg2
一緒にインストールしたアダプター pip
. データベース名、データベースユーザー名、データベースユーザーのパスワードを指定してから、データベースがローカルコンピューター上にあることを指定する必要があります。 あなたは去ることができます PORT
空の文字列として設定:
. . .
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql_psycopg2',
'NAME': 'myproject',
'USER': 'myprojectuser',
'PASSWORD': 'password',
'HOST': 'localhost',
'PORT': '',
}
}
. . .
次に、ファイルの一番下に移動し、静的ファイルを配置する場所を示す設定を追加します。 これは、Nginxがこれらのアイテムのリクエストを処理できるようにするために必要です。 次の行は、Djangoにそれらをというディレクトリに配置するように指示しています static
ベースプロジェクトディレクトリ:
. . .
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static/')
終了したら、ファイルを保存して閉じます。
プロジェクトの初期設定を完了する
これで、管理スクリプトを使用して、初期データベーススキーマをPostgreSQLデータベースに移行できます。
- ~/myproject/manage.py makemigrations
- ~/myproject/manage.py migrate
次のように入力して、プロジェクトの管理ユーザーを作成します。
- ~/myproject/manage.py createsuperuser
ユーザー名を選択し、メールアドレスを入力し、パスワードを選択して確認する必要があります。
次のように入力して、構成したディレクトリの場所にすべての静的コンテンツを収集できます。
- ~/myproject/manage.py collectstatic
操作を確認する必要があります。 静的ファイルは、次のディレクトリに配置されます。 static
プロジェクトディレクトリ内。
サーバーの初期設定ガイドに従った場合は、サーバーを保護するUFWファイアウォールが必要です。 開発サーバーをテストするには、使用するポートへのアクセスを許可する必要があります。
次のように入力して、ポート8000の例外を作成します。
- sudo ufw allow 8000
最後に、次のコマンドを使用してDjango開発サーバーを起動することにより、プロジェクトをテストできます。
- ~/myproject/manage.py runserver 0.0.0.0:8000
Webブラウザーで、サーバーのドメイン名またはIPアドレスにアクセスし、その後にアクセスします。 :8000
:
http://server_domain_or_IP:8000
デフォルトのDjangoインデックスページが表示されます。
追加する場合 /admin
アドレスバーのURLの最後に、で作成した管理ユーザー名とパスワードの入力を求められます。 createsuperuser
指図:
認証後、デフォルトのDjango管理インターフェースにアクセスできます。
探索が終了したら、ターミナルウィンドウで CTRL-C を押して、開発サーバーをシャットダウンします。
プロジェクトにサービスを提供するGunicornの能力をテストする
仮想環境を離れる前に最後にやりたいことは、Gunicornをテストして、アプリケーションに対応できることを確認することです。 これを行うには、プロジェクトディレクトリに入り、 gunicorn
プロジェクトのWSGIモジュールをロードするには:
- cd ~/myproject
- gunicorn --bind 0.0.0.0:8000 myproject.wsgi
これにより、Django開発サーバーが実行されていたのと同じインターフェースでGunicornが起動します。 戻ってアプリをもう一度テストできます。
注: Gunicornはこれに関与する静的CSSコンテンツを認識していないため、管理インターフェースにはスタイルが適用されません。
Djangoへの相対ディレクトリパスを指定して、Gunicornにモジュールを渡しました。 wsgi.py
ファイル。これは、Pythonのモジュール構文を使用したアプリケーションへのエントリポイントです。 このファイル内で、 application
が定義され、アプリケーションとの通信に使用されます。 WSGI仕様の詳細については、ここをクリックをクリックしてください。
テストが終了したら、ターミナルウィンドウでCTRL-Cを押してGunicornを停止します。
これで、Djangoアプリケーションの構成が完了しました。 次のように入力すると、仮想環境から戻ることができます。
- deactivate
プロンプトの仮想環境インジケーターが削除されます。
Gunicornsystemdサービスファイルを作成する
GunicornがDjangoアプリケーションと対話できることをテストしましたが、アプリケーションサーバーを起動および停止するためのより堅牢な方法を実装する必要があります。 これを実現するために、systemdサービスファイルを作成します。
Gunicornのsystemdサービスファイルを作成して開きます。 sudo
テキストエディタの権限:
- sudo nano /etc/systemd/system/gunicorn.service
から始めます [Unit]
セクション。メタデータと依存関係を指定するために使用されます。 ここにサービスの説明を入力し、ネットワークターゲットに到達した後にのみこれを開始するようにinitシステムに指示します。
[Unit]
Description=gunicorn daemon
After=network.target
次に、 [Service]
セクション。 実行する処理を行うユーザーとグループを指定します。 プロセスは関連するすべてのファイルを所有しているため、通常のユーザーアカウントにプロセスの所有権を付与します。 グループの所有権を www-data
NginxがGunicornと簡単に通信できるようにグループ化します。
次に、作業ディレクトリをマップし、サービスの開始に使用するコマンドを指定します。 この場合、仮想環境内にインストールされているGunicorn実行可能ファイルへのフルパスを指定する必要があります。 Nginxは同じコンピューターにインストールされているため、プロジェクトディレクトリ内のUnixソケットにバインドします。 これは、ネットワークポートを使用するよりも安全で高速です。 ここでは、オプションのGunicornの微調整を指定することもできます。 たとえば、この場合、3つのワーカープロセスを指定しました。
[Unit]
Description=gunicorn daemon
After=network.target
[Service]
User=sammy
Group=www-data
WorkingDirectory=/home/sammy/myproject
ExecStart=/home/sammy/myproject/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/home/sammy/myproject/myproject.sock myproject.wsgi:application
最後に、 [Install]
セクション。 これにより、起動時にサービスを開始できるようにした場合に、このサービスを何にリンクするかがsystemdに通知されます。 このサービスは、通常のマルチユーザーシステムが稼働しているときに開始する必要があります。
[Unit]
Description=gunicorn daemon
After=network.target
[Service]
User=sammy
Group=www-data
WorkingDirectory=/home/sammy/myproject
ExecStart=/home/sammy/myproject/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/home/sammy/myproject/myproject.sock myproject.wsgi:application
[Install]
WantedBy=multi-user.target
これで、systemdサービスファイルが完成しました。 今すぐ保存して閉じます。
これで、作成したGunicornサービスを開始し、起動時に開始するように有効にすることができます。
- sudo systemctl start gunicorn
- sudo systemctl enable gunicorn
ソケットファイルを確認することで、操作が成功したことを確認できます。
Gunicornソケットファイルを確認してください
プロセスのステータスをチェックして、プロセスを開始できたかどうかを確認します。
- sudo systemctl status gunicorn
次に、の存在を確認します myproject.sock
プロジェクトディレクトリ内のファイル:
- ls /home/sammy/myproject
Outputmanage.py myproject myprojectenv myproject.sock static
の場合 systemctl status
コマンドは、エラーが発生したこと、またはエラーが見つからない場合に myproject.sock
ディレクトリ内のファイルは、Gunicornが正しく起動できなかったことを示しています。 次のように入力して、Gunicornのプロセスログを確認します。
- sudo journalctl -u gunicorn
ログのメッセージを見て、Gunicornが問題に遭遇した場所を見つけてください。 問題が発生した理由はたくさんありますが、Gunicornがソケットファイルを作成できなかった場合は、次のいずれかの理由が考えられます。
- プロジェクトファイルは、
root
の代わりにユーザーsudo
ユーザー - The
WorkingDirectory
内のパス/etc/systemd/system/gunicorn.service
ファイルがプロジェクトディレクトリを指していない - に与えられた構成オプション
gunicorn
のプロセスExecStart
ディレクティブが正しくありません。 次の項目を確認してください。- への道
gunicorn
バイナリは、仮想環境内のバイナリの実際の場所を指します - The
--bind
ディレクティブは、Gunicornがアクセスできるディレクトリ内に作成するファイルを定義します - The
myproject.wsgi:application
WSGI呼び出し可能オブジェクトへの正確なパスです。 これは、あなたがWorkingDirectory
、あなたは名前の呼び出し可能な名前に到達できるはずですapplication
で見ることによってmyproject.wsgi
モジュール(これは、というファイルに変換されます./myproject/wsgi.py
)
- への道
に変更を加えた場合 /etc/systemd/system/gunicorn.service
ファイル、デーモンをリロードしてサービス定義を再読み込みし、次のように入力してGunicornプロセスを再起動します。
- sudo systemctl daemon-reload
- sudo systemctl restart gunicorn
続行する前に、上記の問題のいずれかをトラブルシューティングしてください。
NginxをGunicornへのプロキシパスに設定する
Gunicornがセットアップされたので、トラフィックをプロセスに渡すようにNginxを構成する必要があります。
Nginxで新しいサーバーブロックを作成して開くことから始めます sites-available
ディレクトリ:
- sudo nano /etc/nginx/sites-available/myproject
内部で、新しいサーバーブロックを開きます。 まず、このブロックが通常のポート80でリッスンし、サーバーのドメイン名またはIPアドレスに応答するように指定します。
server {
listen 80;
server_name server_domain_or_IP;
}
次に、ファビコンの検索に関する問題を無視するようにNginxに指示します。 また、収集した静的アセットの場所も教えてくれます ~/myproject/static
ディレクトリ。 これらのファイルはすべて「/static」の標準URIプレフィックスを持っているため、これらのリクエストに一致するロケーションブロックを作成できます。
server {
listen 80;
server_name server_domain_or_IP;
location = /favicon.ico { access_log off; log_not_found off; }
location /static/ {
root /home/sammy/myproject;
}
}
最後に、 location / {}
他のすべてのリクエストに一致するようにブロックします。 この場所の中に、標準が含まれます proxy_params
Nginxインストールに含まれているファイル。次に、Gunicornプロセスが作成したソケットにトラフィックを渡します。
server {
listen 80;
server_name server_domain_or_IP;
location = /favicon.ico { access_log off; log_not_found off; }
location /static/ {
root /home/sammy/myproject;
}
location / {
include proxy_params;
proxy_pass http://unix:/home/sammy/myproject/myproject.sock;
}
}
終了したら、ファイルを保存して閉じます。 これで、ファイルをにリンクして有効にできます。 sites-enabled
ディレクトリ:
- sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled
次のように入力して、構文エラーについてNginx構成をテストします。
- sudo nginx -t
エラーが報告されていない場合は、次のように入力してNginxを再起動してください。
- sudo systemctl restart nginx
最後に、ファイアウォールをポート80の通常のトラフィックに開放する必要があります。 開発サーバーにアクセスする必要がなくなったため、ルールを削除してポート8000を開くこともできます。
- sudo ufw delete allow 8000
- sudo ufw allow 'Nginx Full'
これで、サーバーのドメインまたはIPアドレスに移動してアプリケーションを表示できるようになります。
ノート
Nginxを構成したら、次のステップはSSL/TLSを使用してサーバーへのトラフィックを保護することです。 これがないと、パスワードを含むすべての情報がプレーンテキストでネットワーク経由で送信されるため、これは重要です。
ドメイン名をお持ちの場合、トラフィックを保護するためにSSL証明書を取得する最も簡単な方法は、Let’sEncryptを使用することです。 このガイドに従って、Ubuntu16.04でLet’sEncryptwithNginxを設定します。
ドメイン名をお持ちでない場合でも、自己署名SSL証明書を使用して、テストと学習のためにサイトを保護できます。
NginxとGunicornのトラブルシューティング
この最後の手順でアプリケーションが表示されない場合は、インストールのトラブルシューティングを行う必要があります。
NginxはDjangoアプリケーションの代わりにデフォルトページを表示しています
Nginxがアプリケーションにプロキシする代わりにデフォルトのページを表示する場合、それは通常、調整する必要があることを意味します server_name
以内 /etc/nginx/sites-available/myproject
サーバーのIPアドレスまたはドメイン名を指すファイル。
Nginxは server_name
要求に応答するために使用するサーバーブロックを決定します。 デフォルトのNginxページが表示されている場合は、Nginxがリクエストをサーバーブロックに明示的に一致させることができなかったことを示しているため、で定義されているデフォルトのブロックにフォールバックしています。 /etc/nginx/sites-available/default
.
The server_name
プロジェクトのサーバーブロック内は、選択するデフォルトのサーバーブロック内のものよりも具体的である必要があります。
NginxはDjangoアプリケーションの代わりに502BadGatewayエラーを表示しています
502エラーは、Nginxがリクエストを正常にプロキシできないことを示します。 さまざまな構成の問題が502エラーで表されるため、適切にトラブルシューティングするには、より多くの情報が必要です。
詳細情報を探す主な場所は、Nginxのエラーログです。 一般に、これにより、プロキシイベント中に問題が発生した条件がわかります。 次のように入力して、Nginxエラーログを追跡します。
- sudo tail -F /var/log/nginx/error.log
次に、ブラウザで別のリクエストを実行して、新しいエラーを生成します(ページを更新してみてください)。 ログに新しいエラーメッセージが書き込まれるはずです。 メッセージを見ると、問題を絞り込むのに役立つはずです。
次のメッセージが表示される場合があります。
connect()to unix:/home/sammy/myproject/myproject.sock failed(2:そのようなファイルまたはディレクトリはありません)
これは、Nginxがを見つけることができなかったことを示しています myproject.sock
指定された場所にファイルします。 比較する必要があります proxy_pass
内で定義された場所 /etc/nginx/sites-available/myproject
の実際の場所にファイル myproject.sock
プロジェクトディレクトリに生成されたファイル。
見つからない場合 myproject.sock
プロジェクトディレクトリ内のファイル、それは一般的に意味します gunicorn
プロセスはそれを作成できませんでした。 Gunicornソケットファイルの確認に関するセクションに戻り、Gunicornのトラブルシューティング手順を実行します。
connect()からunix:/home/sammy/myproject/myproject.sockに失敗しました(13:アクセスが拒否されました)
これは、権限の問題のためにNginxがGunicornソケットに接続できなかったことを示しています。 通常、これは、手順が、の代わりにrootユーザーを使用して実行された場合に発生します。 sudo
ユーザー。 Gunicornプロセスはソケットファイルを作成できますが、Nginxはそれにアクセスできません。
これは、ルートディレクトリ間の任意の時点でアクセス許可が制限されている場合に発生する可能性があります(/
) myproject.sock
ファイル。 ソケットファイルへの絶対パスをに渡すことで、ソケットファイルとその各親ディレクトリのアクセス許可と所有権の値を確認できます。 namei
指図:
- namei -nom /home/sammy/myproject/myproject.sock
Outputf: /home/sammy/myproject/myproject.sock
drwxr-xr-x root root /
drwxr-xr-x root root home
drwxr-xr-x sammy sammy sammy
drwxrwxr-x sammy sammy myproject
srwxrwxrwx sammy www-data myproject.sock
出力には、各ディレクトリコンポーネントの権限が表示されます。 アクセス許可(最初の列)、所有者(2番目の列)、およびグループ所有者(3番目の列)を確認することで、ソケットファイルに許可されているアクセスの種類を把握できます。
上記の例では、ソケットファイルとソケットファイルにつながる各ディレクトリには、ワールド読み取りおよび実行権限があります(ディレクトリの権限列はで終わります r-x
それ以外の ---
). Nginxプロセスはソケットに正常にアクセスできるはずです。
ソケットにつながるディレクトリのいずれかにワールド読み取りおよび実行権限がない場合、Nginxは、ワールド読み取りおよび実行権限を許可するか、Nginxが含まれるグループにグループ所有権が付与されていることを確認しない限り、ソケットにアクセスできません。の。 のようなデリケートな場所の場合 /root
ディレクトリ、上記のオプションの両方が危険です。 プロジェクトファイルをディレクトリの外に移動することをお勧めします。この場所では、セキュリティを損なうことなくアクセスを安全に制御できます。
Djangoが表示されています:「サーバーに接続できませんでした:接続が拒否されました」
Webブラウザでアプリケーションの一部にアクセスしようとしたときにDjangoから表示される可能性のあるメッセージの1つは次のとおりです。
OperationalError at /admin/login/
could not connect to server: Connection refused
Is the server running on host "localhost" (127.0.0.1) and accepting
TCP/IP connections on port 5432?
これは、DjangoがPostgresデータベースに接続できないことを示しています。 次のように入力して、Postgresインスタンスが実行されていることを確認します。
- sudo systemctl status postgresql
そうでない場合は、次のように入力して、起動し、起動時に自動的に起動できるようにすることができます(まだ設定されていない場合)。
- sudo systemctl start postgresql
- sudo systemctl enable postgresql
それでも問題が解決しない場合は、データベース設定が ~/myproject/myproject/settings.py
ファイルは正しいです。
さらなるトラブルシューティング
追加のトラブルシューティングについては、ログが根本原因の絞り込みに役立ちます。 それぞれを順番にチェックし、問題のある領域を示すメッセージを探します。
次のログが役立つ場合があります。
- 次のように入力して、Nginxプロセスログを確認します。
sudo journalctl -u nginx
- 次のように入力して、Nginxアクセスログを確認します。
sudo less /var/log/nginx/access.log
- 次のように入力して、Nginxエラーログを確認します。
sudo less /var/log/nginx/error.log
- 次のように入力して、Gunicornのアプリケーションログを確認します。
sudo journalctl -u gunicorn
構成またはアプリケーションを更新するときに、変更に適応するためにプロセスを再起動する必要がある場合があります。
Djangoアプリケーションを更新する場合は、Gunicornプロセスを再起動して、次のように入力することで変更を取得できます。
- sudo systemctl restart gunicorn
変更した場合 gunicorn
systemdサービスファイル、デーモンをリロードし、次のように入力してプロセスを再起動します。
- sudo systemctl daemon-reload
- sudo systemctl restart gunicorn
Nginxサーバーブロックの構成を変更する場合は、次のように入力して構成をテストしてからNginxをテストします。
- sudo nginx -t && sudo systemctl restart nginx
これらのコマンドは、構成を調整するときに変更を取得するのに役立ちます。
結論
このガイドでは、独自の仮想環境でDjangoプロジェクトをセットアップしました。 Djangoがクライアントリクエストを処理できるように、クライアントリクエストを変換するようにGunicornを設定しました。 その後、クライアント接続を処理し、クライアントの要求に応じて正しいプロジェクトを提供するリバースプロキシとして機能するようにNginxを設定しました。
Djangoは、多くの一般的な要素を提供することでプロジェクトとアプリケーションの作成を簡単にし、独自の要素に集中できるようにします。 この記事で説明する一般的なツールチェーンを活用することで、単一のサーバーから作成したアプリケーションを簡単に提供できます。