Ubuntu20.04でPostgres、Nginx、Uvicornを使用してASGIDjangoアプリをセットアップする方法

getdocs

2年前

序章

Django は、PythonアプリケーションまたはWebサイトを立ち上げるのに役立つ強力なWebフレームワークです。 Djangoには、コードをローカルでテストするための簡略化された開発サーバーが含まれていますが、本番環境に関連するものには、より安全で強力なWebサーバーが必要です。

Djangoアプリをデプロイする従来の方法は、Webサーバーゲートウェイインターフェイス（WSGI）を使用することです。ただし、Python 3の出現と非同期実行のサポートにより、非同期サーバーゲートウェイインターフェース（ASGI）を使用して非同期呼び出し可能ファイルを介してPythonアプリを実行できるようになりました。 WSGIの後継であるPythonのASGI仕様は、WSGIのスーパーセットであり、WSGIのドロップイン置換になります。

Djangoでは、コードを内部で同期できる「非同期外部、同期内部」モードが可能ですが、ASGIサーバーはリクエストを非同期で処理します。 Webサーバーに非同期呼び出し可能を許可することにより、アプリケーションごとに複数の着信イベントと発信イベントを処理できます。 Djangoアプリケーションは、下位互換性を可能にし、並列コンピューティングの複雑さを回避するために、内部で同期されています。これは、DjangoアプリがWSGIからASGIに切り替えるために変更を必要としないことも意味します。

このガイドでは、Djangoアプリケーションをサポートおよび提供するために、Ubuntu20.04にいくつかのコンポーネントをインストールして構成します。デフォルトのSQLiteデータベースを使用する代わりに、PostgreSQLデータベースをセットアップします。 ASGI実装であるUvicornとペアになっているGunicornアプリケーションサーバーを構成して、アプリケーションと非同期でインターフェイスします。次に、GunicornにリバースプロキシするようにNginxを設定し、アプリを提供するためのセキュリティ機能とパフォーマンス機能にアクセスできるようにします。

前提条件

このチュートリアルを完了するには、次のものが必要です。

Ubuntu20.04の初期サーバーセットアップガイドに従ってセットアップされた1つのUbuntu20.04サーバー。 sudo 特権。

ステップ1—Ubuntuリポジトリからパッケージをインストールする

プロセスを開始するには、Ubuntuリポジトリから必要なすべてのアイテムをダウンロードしてインストールします。 Pythonパッケージマネージャーを使用します pip 少し後で追加のコンポーネントをインストールします。

まず、ローカルを更新する必要があります apt パッケージインデックスを作成し、パッケージをダウンロードしてインストールします。インストールするパッケージは、プロジェクトで使用するPythonのバージョンによって異なります。

次のコマンドを使用して、必要なシステムパッケージをインストールします。

sudo apt update
sudo apt install python3-venv libpq-dev postgresql postgresql-contrib nginx curl

このコマンドは、仮想環境をセットアップするためのPythonライブラリ、Postgresデータベースシステムとそれと対話するために必要なライブラリ、およびNginxWebサーバーをインストールします。次に、Djangoアプリケーション用のPostgreSQLデータベースとユーザーを作成します。

ステップ2—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';

その後、作成したユーザーの接続パラメーターのいくつかを変更します。これにより、データベース操作が高速化されるため、接続が確立されるたびに正しい値を照会して設定する必要がなくなります。

デフォルトのエンコーディングをに設定します UTF-8、Djangoが期待しています。また、デフォルトのトランザクション分離スキームを「読み取りコミット」に設定します。これにより、コミットされていないトランザクションからの読み取りがブロックされます。最後に、タイムゾーンを設定します。デフォルトでは、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

これで、Djangoがデータベース情報に接続して管理できるようにPostgresが設定されました。

ステップ3—プロジェクト用のPython仮想環境を作成する

データベースができたので、残りのプロジェクト要件の準備を始めることができます。管理を容易にするために、Python要件を仮想環境内にインストールします。

まず、プロジェクトファイルを保持できるディレクトリを作成して移動します。

mkdir ~/myprojectdir
cd ~/myprojectdir

次に、Pythonの組み込み仮想環境ツールを使用して、新しい仮想環境を作成します。

python3 -m venv myprojectenv

これにより、というディレクトリが作成されます myprojectenv あなたの中で myprojectdir ディレクトリ。内部には、Pythonのローカルバージョンとのローカルバージョンがインストールされます pip. これを使用して、プロジェクト用に分離されたPython環境をインストールおよび構成できます。

プロジェクトのPython要件をインストールする前に、仮想環境をアクティブ化する必要があります。次のように入力すると、次のように入力できます。

source myprojectenv/bin/activate

プロンプトが変化して、Python仮想環境内で操作していることを示します。次のようになります。 (myprojectenv)user@host:~/myprojectdir$.

Djangoを仮想環境にインストールします。プロジェクトに固有の環境にDjangoをインストールすると、プロジェクトとその要件を個別に処理できるようになります。仮想環境をアクティブにして、Django、Gunicorn、Uvicorn、および psycopg2 ローカルインスタンスが pip:

注：仮想環境がアクティブ化されたとき（プロンプトが (myprojectenv) その前に）、使用する pip それ以外の pip3、Python3を使用している場合でも。ツールの仮想環境のコピーには常に名前が付けられます pip、Pythonのバージョンに関係なく。

pip install django gunicorn uvicorn psycopg2-binary

これで、Djangoプロジェクトを開始するために必要なすべてのソフトウェアが揃いました。

ステップ4—新しいDjangoプロジェクトの作成と構成

Pythonコンポーネントをインストールすると、実際のDjangoプロジェクトファイルを作成できます。

Djangoプロジェクトの作成

すでにプロジェクトディレクトリがあるので、ここでファイルをインストールするようにDjangoに指示できます。通常の実際のコードを使用して第2レベルのディレクトリを作成し、このディレクトリに管理スクリプトを配置します。これの鍵は、Djangoが現在のディレクトリに関連する決定を行うことを許可するのではなく、ディレクトリを明示的に定義していることです。

django-admin startproject myproject ~/myprojectdir

この時点で、プロジェクトディレクトリ（~/myprojectdir このチュートリアルでは）次の内容が含まれている必要があります。

~/myprojectdir/manage.py：Djangoプロジェクト管理スクリプト。
~/myprojectdir/myproject/：Djangoプロジェクトパッケージ。これには、 __init__.py, asgi.py, settings.py, urls.py、と wsgi.py ファイル。
~/myprojectdir/myprojectenv/：前に作成した仮想環境ディレクトリ。

プロジェクト設定の調整

プロジェクトファイルを作成したら、いくつかの設定を調整する必要があります。テキストエディタで設定ファイルを開きます。

nano ~/myprojectdir/myproject/settings.py

を見つけることから始めます ALLOWED_HOSTS 指令。これは、Djangoインスタンスへの接続に使用できるサーバーのアドレスまたはドメイン名のリストを定義します。このリストにないHostヘッダーを持つ着信要求は、例外を発生させます。 Djangoでは、特定のクラスのセキュリティの脆弱性を防ぐためにこれを設定する必要があります。

角かっこ内に、Djangoサーバーに関連付けられているIPアドレスまたはドメイン名をリストします。エントリをコンマで区切って、各項目を引用符で囲んでリストします。ドメイン全体とサブドメインを許可するには、エントリの先頭にピリオドを追加します。以下のスニペットには、これを行う方法を示すために使用されるコメントアウトされた例がいくつかあります。

注：必ず含めてください localhost ローカルのNginxインスタンスを介して接続をプロキシするため、オプションの1つとして。

〜/ myprojectdir / myproject / settings.py

. . .
# 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', . . ., 'localhost']

次に、データベースアクセスを構成するセクションを見つけます。それはで始まります DATABASES. ファイル内の構成はSQLiteデータベース用です。プロジェクト用のPostgreSQLデータベースはすでに作成されているため、設定を調整する必要があります。

PostgreSQLデータベース情報で設定を変更します。 Djangoに使用するように指示します psycopg2 インストールしたアダプター pip. データベース名、データベースユーザー名、データベースユーザーのパスワードを指定してから、データベースがローカルコンピューター上にあることを指定する必要があります。あなたは去ることができます PORT 空の文字列として設定：

〜/ myprojectdir / myproject / settings.py

. . .

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'myproject',
        'USER': 'myprojectuser',
        'PASSWORD': 'password',
        'HOST': 'localhost',
        'PORT': '',
    }
}

. . .

次に、ファイルの一番下に移動し、静的ファイルを配置する場所を示す設定を追加します。これは、Nginxがこれらのアイテムのリクエストを処理できるようにするために必要です。次の行は、Djangoにそれらをというディレクトリに配置するように指示しています static ベースプロジェクトディレクトリ：

〜/ myprojectdir / myproject / settings.py

. . .

STATIC_URL = '/static/'
import os
STATIC_ROOT = os.path.join(BASE_DIR, 'static/')

終了したら、ファイルを保存して閉じます。

プロジェクトの初期設定の完了

これで、管理スクリプトを使用して、初期データベーススキーマをPostgreSQLデータベースに移行できます。

~/myprojectdir/manage.py makemigrations
~/myprojectdir/manage.py migrate

次のように入力して、プロジェクトの管理ユーザーを作成します。

~/myprojectdir/manage.py createsuperuser

ユーザー名を選択し、メールアドレスを入力し、パスワードを選択して確認する必要があります。

次のように入力して、構成したディレクトリの場所にすべての静的コンテンツを収集できます。

~/myprojectdir/manage.py collectstatic

操作を確認する必要があります。静的ファイルは、次のディレクトリに配置されます。 static プロジェクトディレクトリ内。

サーバーの初期設定ガイドに従った場合は、サーバーを保護するUFWファイアウォールが必要です。開発サーバーをテストするには、使用するポートへのアクセスを許可する必要があります。

次のように入力して、ポート8000の例外を作成します。

sudo ufw allow 8000

最後に、次のコマンドを使用してDjango開発サーバーを起動することにより、プロジェクトをテストできます。

~/myprojectdir/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をUvicornと組み合わせて使用して、アプリケーションをデプロイします。 Gunicornは伝統的にWSGIアプリケーションの展開に使用されますが、ASGI展開を提供するためのプラグ可能なインターフェイスも提供します。これは、ASGIサーバーによって公開されているワーカークラスを使用できるようにすることで実現します（uvicorn). Gunicornはより成熟した製品であり、Uvicornよりも多くの構成を提供するため、Uvicornのメンテナは gunicorn とともに uvicorn フル機能のサーバーおよびプロセスマネージャーとしてのワーカークラス。

仮想環境を離れる前に、Gunicornをテストして、アプリケーションに対応できることを確認します。

使用するには uvicorn との労働者 gunicorn サーバー、プロジェクトディレクトリを入力し、以下を使用します gunicorn プロジェクトのASGIモジュールをロードするコマンド：

cd ~/myprojectdir
gunicorn --bind 0.0.0.0:8000 myproject.asgi -w 4 -k uvicorn.workers.UvicornWorker

これにより、Django開発サーバーが実行されていたのと同じインターフェースでGunicornが起動します。戻ってアプリをもう一度テストできます。

注：ASGIアプリケーションを実行するためにGunicornを使用する必要はありません。のみ使用するには uvicorn、次のコマンドを使用します。

uvicorn myproject.asgi:application --host 0.0.0.0 --port 8080

注： Gunicornはこれに関与する静的CSSコンテンツを見つける方法を知らないため、管理インターフェースにはスタイルが適用されません。

これらのコマンドを開始した後もDjangoウェルカムページが表示される場合、これは次のことの確認です。 gunicorn ページを提供し、意図したとおりに機能しています。を使用して gunicorn コマンド、Djangoへの相対ディレクトリパスを指定してGunicornにモジュールを渡しました asgi.py ファイル。Pythonのモジュール構文を使用した、アプリケーションへのエントリポイントです。このファイル内で、 application が定義され、アプリケーションとの通信に使用されます。 ASGI仕様の詳細については、公式ASGIWebサイトにアクセスしてください。

テストが終了したら、 CTRL+C ターミナルウィンドウでGunicornを停止します。

これで、Djangoアプリケーションの構成が完了しました。次のように入力すると、仮想環境から戻ることができます。

deactivate

プロンプトの仮想環境インジケーターが削除されます。

ステップ5—Gunicorn用のsystemdソケットおよびサービスファイルの作成

前のセクションでは、GunicornがDjangoアプリケーションと対話できることをテストしました。このステップでは、systemdサービスとソケットファイルを作成することにより、アプリケーションサーバーを起動および停止するより堅牢な方法を実装します。

Gunicornソケットは起動時に作成され、接続をリッスンします。接続が発生すると、systemdは接続を処理するためにGunicornプロセスを自動的に開始します。

まず、Gunicornのsystemdソケットファイルを作成して開きます。 sudo 特権：

sudo nano /etc/systemd/system/gunicorn.socket

内部では、を作成します [Unit] ソケットを説明するセクション、 [Socket] ソケットの位置を定義するセクション、および [Install] ソケットが適切なタイミングで作成されていることを確認するセクション：

/etc/systemd/system/gunicorn.socket

[Unit]
Description=gunicorn socket

[Socket]
ListenStream=/run/gunicorn.sock

[Install]
WantedBy=sockets.target

終了したら、ファイルを保存して閉じます。

次に、Gunicornのsystemdサービスファイルを作成して開きます。 sudo テキストエディタの権限。サービスファイル名は、拡張子のソケットファイル名例外と一致する必要があります。

sudo nano /etc/systemd/system/gunicorn.service

から始めます [Unit] セクション。メタデータと依存関係を指定するために使用されます。ここにサービスの説明を入力し、ネットワークターゲットに到達した後にのみこれを開始するようにinitシステムに指示します。サービスはソケットファイルのソケットに依存しているため、 Requires その関係を示すディレクティブ：

/etc/systemd/system/gunicorn.service

[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target

次に、 [Service] セクション。プロセスを実行するユーザーとグループを指定します。プロセスはすべての関連ファイルを所有しているため、通常のユーザーアカウントにプロセスの所有権を付与します。グループの所有権を www-data NginxがGunicornと簡単に通信できるようにグループ化します。

次に、作業ディレクトリをマップし、サービスの開始に使用するコマンドを指定します。この場合、仮想環境内にインストールされているGunicorn実行可能ファイルへのフルパスを指定する必要があります。プロセスを、内で作成したUnixソケットにバインドします。 /run プロセスがNginxと通信できるようにディレクトリ。すべてのデータを標準出力に記録して、 journald プロセスはGunicornのログを収集できます。ここで、オプションのGunicornの微調整を指定することもできます。 3つのワーカープロセスを指定する例を次に示します。

/etc/systemd/system/gunicorn.service

[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target

[Service]
User=sammy
Group=www-data
WorkingDirectory=/home/sammy/myprojectdir
ExecStart=/home/sammy/myprojectdir/myprojectenv/bin/gunicorn \
          --access-logfile - \
          -k uvicorn.workers.UvicornWorker \
          --workers 3 \
          --bind unix:/run/gunicorn.sock \
          myproject.asgi:application

最後に、 [Install] セクション。これにより、起動時にサービスを開始できるようにした場合に、このサービスを何にリンクするかがsystemdに通知されます。通常のマルチユーザーシステムが稼働しているときに、このサービスを開始する必要があります。

/etc/systemd/system/gunicorn.service

[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target

[Service]
User=sammy
Group=www-data
WorkingDirectory=/home/sammy/myprojectdir
ExecStart=/home/sammy/myprojectdir/myprojectenv/bin/gunicorn \
          --access-logfile - \
          -k uvicorn.workers.UvicornWorker \
          --workers 3 \
          --bind unix:/run/gunicorn.sock \
          myproject.asgi:application

[Install]
WantedBy=multi-user.target

これで、systemdサービスファイルが完成しました。今すぐ保存して閉じます。

これで、Gunicornソケットを起動して有効にできます。これにより、ソケットファイルが次の場所に作成されます。 /run/gunicorn.sock 今そして起動時に。そのソケットに接続が確立されると、systemdは自動的に gunicorn.service それを処理するには：

sudo systemctl start gunicorn.socket
sudo systemctl enable gunicorn.socket

systemdサービスとソケットファイルを作成したので、ソケットファイルをチェックして操作が成功したことを確認します。

ステップ6—Gunicornソケットファイルを確認する

このステップでは、Gunicornソケットファイルを確認します。まず、プロセスのステータスをチェックして、プロセスを開始できたかどうかを確認します。

sudo systemctl status gunicorn.socket

出力は次のようになります。

Output● gunicorn.socket - gunicorn socket
     Loaded: loaded (/etc/systemd/system/gunicorn.socket; enabled; vendor prese>
     Active: active (listening) since Fri 2020-06-26 17:53:10 UTC; 14s ago
   Triggers: ● gunicorn.service
     Listen: /run/gunicorn.sock (Stream)
      Tasks: 0 (limit: 1137)
     Memory: 0B
     CGroup: /system.slice/gunicorn.socket

次に、の存在を確認します gunicorn.sock 内のファイル /run ディレクトリ：

file /run/gunicorn.sock

Output/run/gunicorn.sock: socket

の場合 systemctl status コマンドはエラーが発生したことを示した、またはあなたが見つからない場合 gunicorn.sock ディレクトリ内のファイル。これは、Gunicornソケットが正しく作成されなかったことを示します。次のように入力して、Gunicornソケットのログを確認します。

sudo journalctl -u gunicorn.socket

あなたのをもう一度見てください /etc/systemd/system/gunicorn.socket 続行する前に問題を修正するためのファイル。

ステップ7—ソケットアクティベーションのテスト

このステップでは、ソケットのアクティブ化をテストします。現在、始めたばかりの場合 gunicorn.socket ユニット、 gunicorn.service ソケットはまだ接続を受信していないため、まだアクティブにはなりません。次のように入力して、これを確認できます。

sudo systemctl status gunicorn

Output● gunicorn.service - gunicorn daemon
   Loaded: loaded (/etc/systemd/system/gunicorn.service; disabled; vendor preset: enabled)
   Active: inactive (dead)

ソケットアクティベーションメカニズムをテストするには、を介してソケットに接続を送信できます。 curl 次のように入力します。

curl --unix-socket /run/gunicorn.sock localhost

ターミナルでアプリケーションからHTML出力を受け取る必要があります。これは、Gunicornが起動され、Djangoアプリケーションを提供できたことを示しています。次のように入力して、Gunicornサービスが実行されていることを確認できます。

sudo systemctl status gunicorn

Output

● gunicorn.service - gunicorn daemon
     Loaded: loaded (/etc/systemd/system/gunicorn.service; disabled; vendor preset: enabled)
     Active: active (running) since Thu 2021-06-10 21:03:29 UTC; 13s ago
TriggeredBy: ● gunicorn.socket
   Main PID: 11682 (gunicorn)
      Tasks: 4 (limit: 4682)
     Memory: 98.5M
     CGroup: /system.slice/gunicorn.service
             ├─11682 /home/sammy/myprojectdir/myprojectenv/bin/python3 /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 -k uvicorn.workers.UvicornWorker --bind unix:/run/gunicorn.sock myproject.asgi:application
             ├─11705 /home/sammy/myprojectdir/myprojectenv/bin/python3 /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 -k uvicorn.workers.UvicornWorker --bind unix:/run/gunicorn.sock myproject.asgi:application
             ├─11707 /home/sammy/myprojectdir/myprojectenv/bin/python3 /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 -k uvicorn.workers.UvicornWorker --bind unix:/run/gunicorn.sock myproject.asgi:application
             └─11708 /home/sammy/myprojectdir/myprojectenv/bin/python3 /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 -k uvicorn.workers.UvicornWorker --bind unix:/run/gunicorn.sock myproject.asgi:application

Jun 10 21:03:29 django gunicorn[11705]: [2021-06-10 21:03:29 +0000] [11705] [INFO] ASGI 'lifespan' protocol appears unsupported.
Jun 10 21:03:29 django gunicorn[11705]: [2021-06-10 21:03:29 +0000] [11705] [INFO] Application startup complete.
Jun 10 21:03:30 django gunicorn[11707]: [2021-06-10 21:03:30 +0000] [11707] [INFO] Started server process [11707]
Jun 10 21:03:30 django gunicorn[11707]: [2021-06-10 21:03:30 +0000] [11707] [INFO] Waiting for application startup.
Jun 10 21:03:30 django gunicorn[11707]: [2021-06-10 21:03:30 +0000] [11707] [INFO] ASGI 'lifespan' protocol appears unsupported.
Jun 10 21:03:30 django gunicorn[11707]: [2021-06-10 21:03:30 +0000] [11707] [INFO] Application startup complete.
Jun 10 21:03:30 django gunicorn[11708]: [2021-06-10 21:03:30 +0000] [11708] [INFO] Started server process [11708]
Jun 10 21:03:30 django gunicorn[11708]: [2021-06-10 21:03:30 +0000] [11708] [INFO] Waiting for application startup.
Jun 10 21:03:30 django gunicorn[11708]: [2021-06-10 21:03:30 +0000] [11708] [INFO] ASGI 'lifespan' protocol appears unsupported.
Jun 10 21:03:30 django gunicorn[11708]: [2021-06-10 21:03:30 +0000] [11708] [INFO] Application startup complete.

からの出力の場合 curl またはの出力 systemctl status 問題が発生したことを示します。詳細については、ログを確認してください。

sudo journalctl -u gunicorn

あなたの /etc/systemd/system/gunicorn.service 問題のファイル。に変更を加えた場合 /etc/systemd/system/gunicorn.service ファイル、デーモンをリロードしてサービス定義を再読み込みし、次のように入力してGunicornプロセスを再起動します。

sudo systemctl daemon-reload
sudo systemctl restart gunicorn

続行する前に、必ず上記の問題のトラブルシューティングを行ってください。

ステップ8—GunicornへのプロキシパスにNginxを構成する

Gunicornがセットアップされたので、トラフィックをプロセスに渡すようにNginxを構成する必要があります。このステップでは、Gunicornの前にNginxをセットアップして、その高性能な接続処理メカニズムと実装が容易なセキュリティ機能を利用します。

Nginxで新しいサーバーブロックを作成して開くことから始めます sites-available ディレクトリ：

sudo nano /etc/nginx/sites-available/myproject

内部で、新しいサーバーブロックを開きます。まず、このブロックが通常のポート80でリッスンし、サーバーのドメイン名またはIPアドレスに応答するように指定します。

/ etc / nginx / sites-available / myproject

server {
    listen 80;
    server_name server_domain_or_IP;
}

次に、ファビコンの検索に関する問題を無視するようにNginxに指示します。また、収集した静的アセットの場所も教えてください。 ~/myprojectdir/static ディレクトリ。これらのファイルはすべて「/static」の標準URIプレフィックスを持っているため、これらのリクエストに一致するロケーションブロックを作成できます。

/ etc / nginx / sites-available / myproject

server {
    listen 80;
    server_name server_domain_or_IP;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /home/sammy/myprojectdir;
    }
}

最後に、 location / {} 他のすべてのリクエストに一致するようにブロックします。この場所の中に、標準を含めます proxy_params Nginxインストールに含まれているファイルを使用すると、トラフィックをGunicornソケットに直接渡します。

/ etc / nginx / sites-available / myproject

server {
    listen 80;
    server_name server_domain_or_IP;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /home/sammy/myprojectdir;
    }

    location / {
        include proxy_params;
        proxy_pass http://unix:/run/gunicorn.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アドレスに移動して、ロケットの画像が表示されたDjangoウェルカムページを表示できるようになります。

注： Nginxを構成したら、次のステップはSSL/TLSを使用してサーバーへのトラフィックを保護する必要があります。これがないと、パスワードを含むすべての情報がプレーンテキストでネットワーク経由で送信されるため、これは重要です。

ドメイン名をお持ちの場合、トラフィックを保護するためにSSL証明書を取得する最も簡単な方法は、 Let’sEncryptを使用することです。このガイドに従って、Ubuntu20.04でLet’sEncryptwithNginxを設定します。このチュートリアルで作成したNginxサーバーブロックを使用して手順に従います。

ステップ9—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:/run/gunicorn.sock failed (2: No such file or directory)

これは、Nginxがを見つけることができなかったことを示しています gunicorn.sock 指定された場所にファイルします。比較する必要があります proxy_pass 内で定義された場所 /etc/nginx/sites-available/myproject の実際の場所にファイル gunicorn.sock によって生成されたファイル gunicorn.socket systemdユニット。

見つからない場合 gunicorn.sock 内のファイル /run ディレクトリ、それは一般的にsystemdソケットファイルがそれを作成できなかったことを意味します。 Gunicornソケットファイルの確認に関するセクションに戻り、Gunicornのトラブルシューティング手順を実行します。

connect() to unix:/run/gunicorn.sock failed (13: Permission denied)

これは、権限の問題のためにNginxがGunicornソケットに接続できなかったことを示しています。これは、プロシージャがルートユーザーの代わりにrootユーザーを使用する場合に発生する可能性があります。 sudo ユーザー。 systemdはGunicornソケットファイルを作成できますが、Nginxはそれにアクセスできません。

これは、ルートディレクトリ間の任意の時点でアクセス許可が制限されている場合に発生する可能性があります（/）そしてその gunicorn.sock ファイル。ソケットファイルへの絶対パスをに渡すことにより、ソケットファイルとその各親ディレクトリのアクセス許可と所有権の値を確認できます。 namei 指図：

namei -l /run/gunicorn.sock

Outputf: /run/gunicorn.sock
drwxr-xr-x root root /
drwxr-xr-x root root run
srw-rw-rw- root root gunicorn.sock

出力には、各ディレクトリコンポーネントの権限が表示されます。アクセス許可（最初の列）、所有者（2番目の列）、およびグループ所有者（3番目の列）を確認することで、ソケットファイルに許可されているアクセスの種類を把握できます。

上記の例では、ソケットファイルとソケットファイルにつながる各ディレクトリには、ワールド読み取りおよび実行権限があります（ディレクトリの権限列はで終わります r-x それ以外の ---). Nginxプロセスはソケットに正常にアクセスできるはずです。

ソケットにつながるディレクトリのいずれかにワールド読み取りおよび実行権限がない場合、Nginxは、ワールド読み取りおよび実行権限を許可するか、Nginxが含まれるグループにグループ所有権が付与されていることを確認しない限り、ソケットにアクセスできません。の。

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

それでも問題が解決しない場合は、データベース設定が ~/myprojectdir/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
次のように入力して、Gunicornソケットログを確認します。 sudo journalctl -u gunicorn.socket

構成またはアプリケーションを更新するときに、変更に適応するためにプロセスを再起動する必要がある場合があります。

Djangoアプリケーションを更新する場合は、Gunicornプロセスを再起動して、次のように入力することで変更を取得できます。

sudo systemctl restart gunicorn

Gunicornのソケットまたはサービスファイルを変更した場合は、デーモンをリロードし、次のように入力してプロセスを再開します。

sudo systemctl daemon-reload
sudo systemctl restart gunicorn.socket gunicorn.service

Nginxサーバーブロックの構成を変更する場合は、次のように入力して構成をテストしてからNginxをテストします。

sudo nginx -t && sudo systemctl restart nginx

これらのコマンドは、構成を調整するときに変更を取得するのに役立ちます。

結論

このガイドでは、独自の仮想環境でASGIDjangoプロジェクトをセットアップしました。クライアントリクエストを非同期に変換してDjangoが処理できるように、GunicornとUvicornを設定しました。その後、クライアント接続を処理し、クライアントの要求に応じて正しいプロジェクトを提供するリバースプロキシとして機能するようにNginxを設定します。

Djangoは、多くの一般的な要素を提供することでプロジェクトとアプリケーションの作成プロセスを合理化し、独自の要素に集中できるようにします。この記事で説明する一般的なツールチェーンを活用することで、単一のサーバーから作成したアプリケーションを提供できます。