Flask Gunicorn Nginx systemd 배포 예제 스크립트 완벽 가이드

mkdir -p /var/www/flaskapp
cd /var/www/flaskapp
python3 -m venv venv
source venv/bin/activate
pip install flask gunicorn
pip freeze > requirements.txt

/var/www/flaskapp
 ├── venv/                # 가상환경
 ├── app/                 # Flask 소스코드
 │    ├── __init__.py
 │    └── routes.py
 ├── wsgi.py              # Gunicorn 엔트리 포인트
 ├── requirements.txt
 └── logs/                # 로그 디렉터리

from app import create_app

app = create_app()

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

cd /var/www/flaskapp
source venv/bin/activate
gunicorn --workers 3 --bind 0.0.0.0:8000 wsgi:app

[Unit]
Description=Gunicorn instance to serve FlaskApp
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/flaskapp
Environment="PATH=/var/www/flaskapp/venv/bin"
ExecStart=/var/www/flaskapp/venv/bin/gunicorn --workers 3 --bind unix:/var/www/flaskapp/flaskapp.sock wsgi:app
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl start flaskapp
sudo systemctl enable flaskapp

# /etc/nginx/sites-available/flaskapp
upstream flaskapp {
    server unix:/var/www/flaskapp/flaskapp.sock fail_timeout=0;
}

server {
    listen 80;
    server_name example.com www.example.com;
    # HTTP를 HTTPS로 리다이렉트
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;

    # 기본 TLS 설정 (임시 인증서 경로 예시)
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    # 프록시 기본 설정
    location / {
        include proxy_params;
        proxy_pass http://flaskapp;
        proxy_read_timeout 60s;
        proxy_connect_timeout 5s;
        proxy_send_timeout 60s;
        proxy_buffering on;
        proxy_buffers 16 16k;
        proxy_busy_buffers_size 24k;
    }

    # 정적 파일 서빙(선택)
    location /static/ {
        alias /var/www/flaskapp/app/static/;
        access_log off;
        expires 7d;
    }

    # 보안 헤더(필요시 조정)
    add_header X-Content-Type-Options nosniff;
    add_header X-Frame-Options DENY;
    add_header Referrer-Policy strict-origin-when-cross-origin;
    add_header X-XSS-Protection "1; mode=block";
}

sudo ln -s /etc/nginx/sites-available/flaskapp /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# 예시: Debian/Ubuntu
sudo apt-get update
sudo apt-get install -y certbot python3-certbot-nginx

# Nginx 플러그인으로 자동 구성
sudo certbot --nginx -d example.com -d www.example.com

# 갱신 테스트
sudo certbot renew --dry-run

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;

# 업로드 사이즈 제한(필요 시 증가)
client_max_body_size 16m;

# 압축
gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

# 캐시 헤더(필요 시 정적 위치에서 사용)
# add_header Cache-Control "public, max-age=86400";

[Service]
Restart=always
RestartSec=5s
StartLimitBurst=5
StartLimitInterval=60s

# /etc/systemd/system/flaskapp-healthcheck.service
[Unit]
Description=Health check for FlaskApp

[Service]
Type=oneshot
ExecStart=/usr/bin/curl -f http://127.0.0.1:8000/health || systemctl restart flaskapp

# /etc/systemd/system/flaskapp-healthcheck.timer
[Unit]
Description=Run FlaskApp health check every 5 minutes

[Timer]
OnBootSec=1min
OnUnitActiveSec=5min
Unit=flaskapp-healthcheck.service

[Install]
WantedBy=timers.target

sudo systemctl daemon-reload
sudo systemctl enable --now flaskapp-healthcheck.timer

# Gunicorn 서비스 로그 확인
sudo journalctl -u flaskapp -f

# 최근 100줄만 확인
sudo journalctl -u flaskapp -n 100

# 접근 로그
/var/log/nginx/access.log

# 에러 로그
/var/log/nginx/error.log

# 실시간 모니터링
sudo tail -f /var/log/nginx/error.log