開発運用

Flask uWSGI Nginx デプロイ

最終更新： 2月 21, 2025
1分未満

FlaskアプリケーションをuWSGIとNginxを使用してデプロイする方法について、詳細で包括的な記事を日本語でお届けします。このガイドでは、Flaskアプリケーションの設定からuWSGIとNginxを用いた本番環境での実行までの全てのステップを順を追って説明します。

Flaskとは？

FlaskはPythonで書かれた軽量なWebアプリケーションフレームワークで、シンプルで拡張性が高いことから多くのプロジェクトに利用されています。Flaskはデフォルトで開発環境でのサーバーを提供しますが、本番環境で運用する場合は、より安定したパフォーマンスを提供するWebサーバーが必要です。そのため、uWSGIとNginxの組み合わせが広く使われています。

関連記事

uWSGIとは？

uWSGIは、WSGI (Web Server Gateway Interface)をサポートする高性能なアプリケーションサーバーです。PythonなどのWebアプリケーションの実行環境として広く使われており、Flaskアプリケーションを本番環境で効率的に実行するために最適です。uWSGIは、リクエストを受け取ってFlaskアプリケーションに渡し、その応答をWebサーバーに返す役割を担います。

Nginxとは？

Nginxは、高性能で軽量なWebサーバーです。静的コンテンツの配信に優れており、リバースプロキシとしても使用されることが多いです。Nginxは、uWSGIや他のアプリケーションサーバーとの連携において、リクエストの負荷分散やセキュリティ強化を行うために利用されます。

必要なパッケージのインストール

まず、FlaskアプリケーションをuWSGIとNginxで運用するために必要なパッケージをインストールします。以下の手順でインストールを行います。

1. Python環境とFlaskのインストール

bash
sudo apt update
sudo apt install python3-pip python3-dev build-essential
pip3 install flask

2. uWSGIのインストール

uWSGIは、WSGIサーバーとしてFlaskアプリケーションを実行するために使用します。

bash
pip3 install uwsgi

3. Nginxのインストール

NginxはWebサーバーとしてインストールします。

bash
sudo apt install nginx

Flaskアプリケーションの作成

次に、簡単なFlaskアプリケーションを作成します。以下のコードをapp.pyという名前のファイルに保存します。

python
from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return "Hello, Flask with uWSGI and Nginx!"

if __name__ == "__main__":
    app.run()

uWSGIの設定

uWSGIは、FlaskアプリケーションをWSGIインターフェース経由で実行します。以下の手順でuWSGIの設定を行います。

1. uWSGIの設定ファイルを作成

/etc/uwsgi/apps-enabledディレクトリに、uWSGIの設定ファイルを作成します。例えば、flask_app.iniという名前のファイルを作成します。

ini
[uwsgi]
module = wsgi:app

master = true
processes = 5

socket = 127.0.0.1:5000
chmod-socket = 660
vacuum = true

die-on-term = true

ここで、module = wsgi:appは、Flaskアプリケーションのエントリーポイントを指定しています。wsgi.pyというファイルにFlaskアプリケーションのインスタンスを定義する必要があります。

2. wsgi.pyの作成

wsgi.pyという名前で、Flaskアプリケーションをインスタンス化したファイルを作成します。

python
from app import app

if __name__ == "__main__":
    app.run()

Nginxの設定

次に、Nginxを設定して、uWSGIとの接続を行います。Nginxは、HTTPリクエストを受け取ってuWSGIに転送します。

1. Nginxの設定ファイルを編集

Nginxの設定ファイルを編集し、uWSGIにリクエストを転送する設定を行います。設定ファイルは/etc/nginx/sites-available/defaultにあります。以下の設定を追加します。

nginx
server {
    listen 80;
    server_name your_domain_or_IP;

    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:5000;
    }
}

2. 設定ファイルのテストと再起動

設定が正しく行われたことを確認したら、Nginxを再起動します。

bash
sudo nginx -t
sudo systemctl restart nginx

Flaskアプリケーションの実行

uWSGIとNginxの設定が完了したら、Flaskアプリケーションを実行します。

1. uWSGIの実行

以下のコマンドでuWSGIを実行します。

bash
uwsgi --ini /etc/uwsgi/apps-enabled/flask_app.ini

2. Nginxで確認

ブラウザでhttp://your_domain_or_IPにアクセスして、Flaskアプリケーションが正しく表示されることを確認します。

トラブルシューティング

もしアプリケーションが正しく動作しない場合、以下の点を確認してみてください。

  1. ログファイルの確認
    NginxやuWSGIのログファイルを確認して、エラーがないかチェックします。

    • Nginx: /var/log/nginx/error.log
    • uWSGI: /var/log/uwsgi/app/flask_app.log

  2. 設定ファイルの確認
    NginxやuWSGIの設定ファイルに誤りがないか再度確認します。

  3. ポートの競合
    他のアプリケーションが同じポートを使用していないか確認します。

結論

FlaskアプリケーションをuWSGIとNginxでデプロイすることで、高いパフォーマンスと信頼性を持つWebアプリケーションを本番環境で実行できます。uWSGIはアプリケーションの処理を効率的に行い、Nginxは静的ファイルの配信やリバースプロキシとして機能します。これにより、Flaskアプリケーションはスケーラブルで高可用性のあるシステムとなります。

最終更新： 2月 21, 2025
1分未満
Back to top button