🤔WSGI는 무엇일까?

startproject를 이용해 새로운 django 프로젝트를 만들면 다음과 같은 디렉토리 구조가 생성된다.

(이미지 출처 - django 공식 튜토리얼)

오늘 알아볼 내용은 생성된 파일 중 wsgi.py의 역할이다.

1. WSGI?

WSGI is the Web Server Gateway Interface. It is a specification that describes how a web server communicates with web applications, and how web applications can be chained together to process one request.

WSGI 공식 문서에 나와있는 내용이다.

WSGI는 python application(python script)이 웹 서버와 통신하기 위한 표준 인터페이스이며, 파이썬 프레임워크이다.
프로토콜과 비슷하게 웹서버와 파이썬 애플리케이션이 통신하기 위한 규약이라고 생각하면 된다.

Nginx, Apache와 같은 서버들은 django, flask로 작성한 web application을 이해하지 못한다. 이 때 WSGI를 이용해 웹 서버와 우리가 작성한 애플리케이션이 서로 통신할 수 있다. (외국인과 나 사이에 번역기가 필요한 것과 비슷하다)

2. WSGI Server(Middleware)

웹 서비스를 개발하다 보면 공통적으로 사용하는 기능들이 있다.하지만 WSGI 자체는 서버나 프레임워크 자체가 아니라 서버가 어플리케이션과 통신하는 명세를 다루고 있는 것이기 때문에 우리가 이 기능들을 매번 개발해야 한다.
(쿠키, 세션, 인증, 라우팅 등)

이러한 기능등을 구현해 확장할 수 있게 한 것이 WSGI Middleware이다.

WSGI Middleware는 Web Application 의 실행 전과 후에 이러한 기능들을 추가해주고, 그 자체로도 WSGI Application 이다.

대표적인 WSGI 서버로는 Gunicorn, uWSGI, Werkzeug, mod_wsgie등이 있다.

3. Django의 wsgi.py

이제 django project의 wsgi.py가 어떤 일을 하는지 알아보자.

wsgi.py는 django project와 web server를 연결해준다. 이 파일은 로컬에서 테스트할 때 쓰이는 개발 서버(runserver)와 프로덕션 WSGI 배포에서 모두 이용된다.

wsgi서버는 호출 가능한 애플리케이션 경로를 얻는다. django의 default server(runserver)는 이 경로를 settings.py에 있는 WSGI_APPLICATION에서 얻는다.

기본적으로 이 경로는 wsgi.py에서 호출 가능한 애플리케이션을 가리키는 프로젝트명.application.wsgi로 되어있다.

WSGI 서버가 애플리케이션을 로드 할 때 Django는 전체 애플리케이션이 정의 된 설정 모듈을 가져와야 한다. django는 이 설정 모듈을 DJANGO_SETTINGS_MODULE를 이용해 가져온다.

wsgi.py

import os

from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')

application = get_wsgi_application()

기본적으로 DJANGO_SETTINGS_MODULE의 설정을 따르지만, 개발이나 배포를 할 때 다른 설정을 이용할 수도 있다.

django app을 배포할 때 우리는 wsgi.py파일을 이용해 실행한다. 예를 들어 django를 gunicorn을 이용해 heroku에 배포할 때 Procfile에 다음과 같은 내용을 작성해야 한다.

Procile

web: gunicorn 프로젝트명.wsgi --log-file -

위 코드의 뜻은 프로젝트명.wsgi모듈에 있는 설정 정보를 이용해 gunicorn을 구동시킨다는 뜻이다.

django의 wsgi.py는 웹서버와 django project 사이의 인터페이스 역할을 한다. 그렇기 때문에 배포를 할 때 wsgi.py에 있는 설정을 이용해 wsgi server를 구동하고, nginx와 같은 웹 서버와 연결해 실행시킨다.

참고 사이트
django 공식 문서 - WSGI로 배포하는 방법
MDN Docs Django 튜토리얼 파트 11 - Django 웹사이트 공개하기
Spoaq 기술블로그 - Flask로 만들어 보는 WSGI 어플리케이션