Aivis Engineを​本番環境向けに​リファクタリングする

1
"""Gunicorn 設定ファイル
2

3
本番環境で Gunicorn + Uvicorn Workers を使用する際の推奨設定
4
使用方法: gunicorn -c gunicorn_conf.py voicevox_engine.app.application:app
5
"""
6

7
import multiprocessing
8
import os
9

10
# ワーカー設定
11
# CPU コア数 * 2 + 1 を推奨（環境変数で上書き可能）
12
workers = int(os.getenv("VV_WORKERS", multiprocessing.cpu_count() * 2 + 1))
13
worker_class = "uvicorn.workers.UvicornWorker"
14

15
# バインドアドレス
16
bind = os.getenv("VV_BIND", "0.0.0.0:10101")
17

18
# タイムアウト設定
19
timeout = int(os.getenv("VV_TIMEOUT", "120"))  # ワーカータイムアウト（秒）
20
keepalive = int(os.getenv("VV_KEEPALIVE", "5"))  # Keep-Alive 接続のタイムアウト
21
graceful_timeout = int(os.getenv("VV_GRACEFUL_TIMEOUT", "30"))  # グレースフルシャットダウン時間
22

23
# ログ設定
24
accesslog = os.getenv("VV_ACCESS_LOG", "-")  # アクセスログ ("-" は stdout)
25
errorlog = os.getenv("VV_ERROR_LOG", "-")  # エラーログ
26
loglevel = os.getenv("VV_LOG_LEVEL", "info")  # ログレベル
27

28
# プロセス名
29
proc_name = "aivisspeech-engine"
30

31
# プリロード設定（メモリ効率化）
32
preload_app = True
33

34
# 最大リクエスト数（メモリリーク対策）
35
max_requests = int(os.getenv("VV_MAX_REQUESTS", "1000"))
36
max_requests_jitter = int(os.getenv("VV_MAX_REQUESTS_JITTER", "50"))
37

38
# ワーカー接続数制限
39
worker_connections = int(os.getenv("VV_WORKER_CONNECTIONS", "1000"))
40

41
# Uvicorn 固有の設定（環境変数経由）
42
# これらは UvicornWorker に渡される
43
raw_env = [
44
    f"UVICORN_LIMIT_CONCURRENCY={os.getenv('VV_LIMIT_CONCURRENCY', '100')}",
45
    f"UVICORN_TIMEOUT_KEEP_ALIVE={os.getenv('VV_TIMEOUT_KEEP_ALIVE', '5')}",
46
]
47

48

49
def on_starting(server):
50
    """サーバー起動時のフック"""
51
    server.log.info(f"Starting Gunicorn with {workers} workers")
52

53

54
def on_reload(server):
55
    """リロード時のフック"""
56
    server.log.info("Reloading Gunicorn")
57

58

59
def worker_int(worker):
60
    """ワーカー中断時のフック"""
61
    worker.log.info(f"Worker {worker.pid} received INT or QUIT signal")
62

63

64
def worker_abort(worker):
65
    """ワーカー異常終了時のフック"""
66
    worker.log.error(f"Worker {worker.pid} received SIGABRT signal")