ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

DockerとWSGIサーバーによる高可用性Python Webサービスのデプロイ

9月 10, 2025
# Misc

Olivia Novak

Dev Intern · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "DockerとWSGIサーバーによる高可用性Python Webサービスのデプロイ"

はじめに

今日のペースの速いデジタル環境において、Webアプリケーションを確実にデプロイおよびスケールする能力は最優先事項です。Python開発者にとって、堅牢でパフォーマンスの高いWebサービスを構築することは、エレガントなコードを書くだけでなく、洗練されたデプロイ戦略を必要とします。従来ののアプローチは、依存関係の管理、環境の不整合、パフォーマンスの低下といった問題につながる可能性があります。そこで登場するのが、Dockerによるコンテナ化と、uWSGIやGunicornのような強力なWSGIサーバーの組み合わせです。この記事では、これらのテクノロジーをどのように活用して高可用性Python Webサービスをデプロイし、アプリケーションが効率的であるだけでなく、回復力があり、変動するユーザー負荷を処理できることを保証するかについて掘り下げていきます。基礎となる原則を検討し、実践的な例をいくつか紹介することで、次世代のPython Webアプリケーションに自信を持って構築およびデプロイするための知識を身につけていただけます。

コアコンセプト解説

デプロイの詳細に入る前に、高可用性Python Webサービスを実現するために含まれる主要なコンポーネントを理解しましょう。

  • Docker: Dockerは、コンテナ化を使用してアプリケーションのデプロイ、スケーリング、管理を自動化するオープンソースプラットフォームです。コンテナは、コード、ランタイム、システムツール、システムライブラリ、設定など、アプリケーションの実行に必要なすべてを含む、軽量なスタンドアロンの実行可能なソフトウェアパッケージです。これにより、開発から本番環境まで、さまざまな環境で一貫性が保証されます。
  • WSGI (Web Server Gateway Interface): WSGIは、WebサーバーとPython Webアプリケーションまたはフレームワーク間の標準インターフェースです。WebサーバーがPythonアプリケーションとどのように通信するかを指定し、それらを互換性のあるものにします。これはサーバー自体ではありませんが、サーバーとアプリケーションが準拠する仕様です。
  • uWSGI/Gunicorn: これらは、Webサーバー（Nginxなど）とPython Webアプリケーションの間のインターフェースとして機能する、2つの人気のあるWSGI HTTPサーバーです。これらは本番環境向けに設計されており、プロセス管理、ロードバランシング（ワーカープロセス内部）、同時リクエストの堅牢な処理といった機能を提供します。
    • uWSGI: Cで書かれた、高速で自己復旧機能を備え、開発者に優しいWSGIサーバーです。さまざまなプロトコルをサポートし、広範な設定オプションを備えています。
    • Gunicorn (Green Unicorn): UNIX用のPython WSGI HTTPサーバーです。プリフォークワーカーモデルであり、セットアップが簡単で、パフォーマンスとシンプルさのバランスが取れています。
  • Nginx: 高パフォーマンスのWebサーバー、リバースプロキシ、ロードバランサーです。私たちのセットアップでは、Nginxは静的ファイルを配信し、SSL/TLS終端を行い、そして最も重要なことに、リバースプロキシとして機能し、リクエストをuWSGI/Gunicornサーバーに転送します。また、着信トラフィックを複数のアプリケーションインスタンスに分散することもでき、高可用性に貢献します。
  • 高可用性: これは、システムが長期間、障害なく連続して動作する能力を指します。Webサービスの場合、1つ以上のコンポーネントが失敗した場合でも、アプリケーションがアクセス可能で応答的であり続けることを保証することを意味します。これは通常、冗長性、ロードバランシング、および自動化された回復メカニズムによって達成されます。

高可用性の実現

高可用性の基本的な原則は冗長性です。アプリケーションの複数のインスタンスを実行することで、1つのインスタンスが失敗した場合でも、他のインスタンスがシームレスに引き継ぐことを保証します。Dockerは、同一のアプリケーションコンテナを簡単に起動できるため、これを容易にします。その後、ロードバランサーとして機能するNginxが、着信リクエストを着信しているコンテナ全体に分散します。

デプロイアーキテクチャ

一般的な高可用性アーキテクチャは、以下の要素を含みます。

  1. Nginx: インターネットに公開され、すべての受信Webトラフィックを処理し、静的ファイルを配信し、動的リクエストをアプリケーションサーバーにリバースプロキシします。
  2. 複数のアプリケーションコンテナ: 各コンテナは、uWSGIまたはGunicornによって提供されるPython Webアプリケーションを実行します。これらのコンテナは分離されており、スケーラブルです。
  3. Dockerネットワーク: Nginxとアプリケーションコンテナ間の通信を可能にするために使用されます。

実践的な実装

簡単なFlaskアプリケーションでこれを例示しましょう。

1. Flaskアプリケーション (app.py)

# app.py
from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/')
def hello_world():
    return jsonify(message="Hello from a highly available Python web service!")

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

2. 要件 (requirements.txt)

Flask
gunicorn # または、uwsgi を好む場合

3. アプリケーション用のDockerfile（Gunicornを使用）

# Dockerfile
FROM python:3.9-slim-buster

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY app.py .

# Gunicornがリッスンするポートを公開
EXPOSE 8000

# Gunicornを実行するコマンド
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "app:app"]

4. Nginx設定 (nginx.conf)

# nginx.conf
worker_processes auto;

events {
    worker_connections 1024;
}

http {
    upstream app_servers {
        # docker-compose.yml で定義されたサービス
        # Nginx はそれらの間でリクエストをロードバランシングします
        server app_instance_1:8000;
        server app_instance_2:8000;
        # より高い可用性/スケーラビリティのために必要に応じてインスタンスを追加
    }

    server {
        listen 80;
        server_name your_domain.com localhost; # あなたのドメインに置き換えてください

        location / {
            proxy_pass http://app_servers;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        # オプション：静的ファイルを Nginx から直接配信（より効率的）
        # location /static/ {
        #     alias /app/static/; # コンテナ内の /app/static/ に静的ファイルがあると仮定
        # }
    }
}

5. オーケストレーション用のDocker Compose (docker-compose.yml)

このファイルは、マルチコンテナDockerアプリケーションを定義して実行します。

# docker-compose.yml
version: '3.8'

services:
  nginx:
    image: nginx:1.21-alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      - app_instance_1
      - app_instance_2
    networks:
      - app_network

  app_instance_1:
    build: .
    environment:
      NAME: instance_1
    networks:
      - app_network

  app_instance_2:
    build: .
    environment:
      NAME: instance_2
    networks:
      - app_network
    # `docker-compose up --scale app_instance=N` を使用して、さらにこのサービスをスケーリングできます
    # または、app_instance_3 のように、より明示的に定義されたサービスを追加できます。

networks:
  app_network:
    driver: bridge

説明:

  • 私たちのFlaskアプリケーションの2つのインスタンス（app_instance_1、app_instance_2）を定義しており、どちらも同じDockerfileからビルドされます。これにより冗長性が提供されます。
  • nginxサービスはエントリーポイントとして機能し、app_serversアップストリームグループ（アプリケーションインスタンスを含む）にリクエストを転送します。
  • Nginxはポート80でリッスンし、リクエストをポート8000のGunicornサーバーにプロキシするように設定されています。
  • カスタムDockerネットワーク（app_network）により、サービスはサービス名（例：app_instance_1）を使用して互いに通信できます。

このセットアップを実行するには:

  1. ファイルをディレクトリに保存します。
  2. そのディレクトリでターミナルを開きます。
  3. docker compose up --build -d を実行します。
  4. http://localhost でアプリケーションにアクセスします。Flaskアプリからのメッセージが表示されるはずです。複数回リフレッシュすると、Nginxはapp_instance_1とapp_instance_2間でリクエストを分散し、ロードバランシングと高可用性を示します。app_instanceコンテナのいずれかを手動で停止して障害をテストできます。Nginxは自動的に正常な方にトラフィックをリダイレクトします。

uWSGIの使用（代替）

uWSGIを好む場合は、DockerfileとCMDがわずかに変更されます。

requirements.txt

Flask
uwsgi

Dockerfile（uWSGI用）

FROM python:3.9-slim-buster

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY app.py .
# uwsgi設定ファイルも使用できますが、簡単のため、ここではオプションを直接渡します
# COPY uwsgi.ini .

EXPOSE 8000

# uWSGIを実行するコマンド
# Nginxがソケット経由で通信するために `--socket` を使用（通常は高速）
# 簡単のためとDockerネットワーキングのために、ここではTCPポートを使用します
# CMD ["uwsgi", "--http", "0.0.0.0:8000", "--wsgi-file", "app.py", "--callable", "app", "--processes", "4", "--threads", "2"]
CMD ["uwsgi", "--socket", "0.0.0.0:8000", "--protocol", "http", "--wsgi-file", "app.py", "--callable", "app", "--processes", "4", "--threads", "2"]

nginx.confとdocker-compose.ymlは、実質的にNginxからWSGIサーバーの選択を抽象化する形で、ほぼ同じままです。

結論

高可用性Python Webサービスのデプロイには、堅牢なアーキテクチャが必要です。Dockerのコンテナ化機能と、GunicornまたはuWSGIのような本番グレードのWSGIサーバー、そしてNginxをリバースプロキシおよびロードバランサーとして活用することで、開発者はスケーラブルで、回復力があり、保守可能なアプリケーションを作成できます。このセットアップにより、Python Webサービスはトラフィックの増加に対応し、個々のコンポーネントの障害が発生しても運用を継続できることが保証されます。これは、あらゆる成功した現代のアプリケーションにとって重要な要件です。最終的に、このアプローチにより、開発者は強力で本質的に信頼性の高いPython Webサービスを構築およびデプロイできるようになります。

Share this article

HackerNews

More Posts from Leapcell

cover

FastAPIとDjangoでStrawberryを使ってモダンなGraphQL APIを構築する

cover

状態管理のメンタルモデル：Jotai/Zustandの原子的アプローチ vs Reduxの単一ソース

Popular Posts