Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

파이썬 - WSGI를 만족하는 최소한의 구현 코드 및 PyCharm에서의 디버깅 방법

uwsgi나 gunicorn이,

파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 uwsgi를 이용해 실행
; https://www.sysnet.pe.kr/2/0/12772

파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 gunicorn을 이용해 실행
; https://www.sysnet.pe.kr/2/0/12775

Django App을 동일하게 실행시킬 수 있는 건 2개의 응용 프로그램 사이에 WSGI라는 공통 규약이 있기 때문입니다.

PEP 333 -- Python Web Server Gateway Interface v1.0
; https://www.python.org/dev/peps/pep-0333/

PEP 3333 -- Python Web Server Gateway Interface v1.0.1
; https://www.python.org/dev/peps/pep-3333/

그렇다는 건, 꼭 Django를 사용하지 않더라도 저 WSGI 규약만 맞춰주면 우리가 만든 앱을 uwsgi/gunicorn을 이용해 동일하게 실행시킬 수 있다는 것을 의미합니다.

실제로 "PEP 3333 -- Python Web Server Gateway Interface v1.0.1" 문서에 실린 코드가 바로 WSGI 규약을 만족하는 최소한의 구현 코드입니다.

# main.py

HELLO_WORLD = b"Hello world!\n"


def simple_app(environ, start_response):
    """Simplest possible application object"""
    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers)
    return [HELLO_WORLD]


application = simple_app

(닷넷과 비교하면 ASP.NET의 Route-to-code 방식과 유사합니다. ^^)

저렇게만 만들어 두면 이제 다음과 같이 gunicorn을 사용해 실행하는 것이 가능합니다.

$ gunicorn --bind 0.0.0.0:18090 main
[2021-08-18 18:14:02 +0900] [1670] [INFO] Starting gunicorn 20.0.4
[2021-08-18 18:14:02 +0900] [1670] [INFO] Listening at: http://0.0.0.0:18090 (1670)
[2021-08-18 18:14:02 +0900] [1670] [INFO] Using worker: sync
[2021-08-18 18:14:02 +0900] [1672] [INFO] Booting worker with pid: 1672

즉, uwsgi/gunicorn은 파이썬 애플리케이션으로부터 무조건 "application" 전역 변수에 설정된 웹 프레임워크 인스턴스를 받아와 Request/Response 처리를 넘겨주는 것입니다. 사실 여기서 application은 기본값에 불과하므로 이것을 정의하지 않는다면 다음과 같이 직접 simple_app을 지정하는 것도 가능합니다.

$ gunicorn --bind 0.0.0.0:18090 main:simple_app

어쨌든 이렇게 준비를 마쳤으면, 웹 브라우저에서 "http://localhost:18090"으로 접속해 "Hello world!"라는 문자열을 볼 수 있습니다.




그런데, 저렇게 구현한 코드를 어떻게 디버깅해야 하는 걸까요? 가령, PyCharm IDE 같은 환경에서 main.py의 simple_app 함수를 실행하는 순간 디버깅하고 싶으면 어떻게 해야 하냐는 것입니다.

(Visual Studio를 사용하는) 윈도우 개발자라면 이런 경우 시작 프로세스를 "gunicorn"으로, 명령행 인자에 "--bind 0.0.0.0:18090 main"으로 지정하고 F5 키를 누르면 실행 시 디버깅이 될 것이라는... 사용자 경험을 가지고 있습니다.

하지만, PyCharm의 경우에는 무조건 "Python Interpreter"의 'python'이 시작 프로세스로 지정돼 있어야 하고 이후의 명령행을 지정하는 식입니다. 이로 인해 시작 프로세스가 gunicorn/uwsgi라면 디버깅이 안 되는 것입니다.

이런 때 사용할 수 있는 서버가 바로 wsgiref입니다.

wsgiref — WSGI Utilities and Reference Implementation
; https://docs.python.org/3/library/wsgiref.html#module-wsgiref.simple_server

따라서 위의 문서에 나온 예제 코드에 따라 다음과 같이 간단하게 (uwsgi/gunicorn을 대체하는) Web Server를 python 코드로 완성할 수 있습니다.

# runserver.py

from wsgiref.validate import validator
from wsgiref.simple_server import make_server
import main

validator_app = validator(main.simple_app)

with make_server('', 18090, validator_app) as httpd:
    print("Listening on port 18090....")
    httpd.serve_forever()

이제 PyCharm의 "Run/Debug Configuration"에서 "Script path"를 "...[프로젝트 경로]...\runserver.py"로 지정하고 실행하면 simple_app의 코드에 BP를 걸고 디버깅을 할 수 있습니다. (PyCharm과 관련한 디버깅 방법은 이후로도 쭉 소개하겠습니다. ^^)

아울러 아래의 글들도 참고하시고. ^^

Quickstart uwsgi
; https://brunch.co.kr/@ddangdol/8

wsgi를 왜 쓰나요
; https://uiandwe.tistory.com/1268

[python] 서버의 기본 동작 방식
; https://uiandwe.tistory.com/1240




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]


donaricano-btn



[최초 등록일: ]
[최종 수정일: 8/20/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 쓴 사람
 



2021-08-24 10시16분
정성태

1  2  [3]  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12812정성태8/28/2021532.NET Framework: 1108. C# 10 - (10) 개선된 #line 지시자
12811정성태8/27/2021548Linux: 44. 윈도우 개발자를 위한 리눅스 fork 동작 방식 설명 (파이썬 코드)
12810정성태8/27/2021406.NET Framework: 1107. .NET Core/5+에서 동적 컴파일한 C# 코드를 (Breakpoint도 활용하며) 디버깅하는 방법 - #line 지시자파일 다운로드1
12809정성태8/26/2021539.NET Framework: 1106. .NET Core/5+에서 C# 코드를 동적으로 컴파일/사용하는 방법파일 다운로드1
12808정성태8/25/2021383오류 유형: 758. go: ...: missing go.sum entry; to add it: go mod download ...
12807정성태8/25/2021467.NET Framework: 1105. C# 10 - (9) 비동기 메서드가 사용할 AsyncMethodBuilder 선택 가능파일 다운로드1
12806정성태8/24/2021371개발 환경 구성: 601. PyCharm - 다중 프로세스 디버깅 방법
12805정성태8/24/2021426.NET Framework: 1104. C# 10 - (8) 분해 구문에서 기존 변수의 재사용 가능파일 다운로드1
12804정성태8/24/2021372.NET Framework: 1103. C# 10 - (7)
12803정성태8/23/2021414개발 환경 구성: 600. pip cache 디렉터리 옮기는 방법
12802정성태8/23/2021580.NET Framework: 1102. .NET Conf Mini 21.08 - WinUI 3 따라해 보기
12801정성태8/23/2021412.NET Framework: 1101. C# 10 - (6) record class 타입의 ToString 메서드를 sealed 처리 허용파일 다운로드1
12800정성태8/22/2021396개발 환경 구성: 599. PyCharm - (반대로) 원격 프로세스가 PyCharm에 디버그 연결하는 방법
12799정성태8/22/2021554.NET Framework: 1100. C# 10 - (5) 속성 패턴의 개선파일 다운로드1
12798정성태8/21/2021700개발 환경 구성: 598. PyCharm - 원격 프로세스를 디버그하는 방법
12797정성태8/21/2021357Windows: 197. TCP의 MSS(Maximum Segment Size) 크기는 고정된 것일까요?
12796정성태8/21/2021449.NET Framework: 1099. C# 10 - (4) 상수 문자열에 포맷 식 사용 가능파일 다운로드1
12795정성태8/20/2021553.NET Framework: 1098. .NET 6에 포함된 신규 BCL API - 스레드 관련
12794정성태8/20/2021821스크립트: 23. 파이썬 - WSGI를 만족하는 최소한의 구현 코드 및 PyCharm에서의 디버깅 방법 [1]
12793정성태8/20/2021955.NET Framework: 1097. C# 10 - (3) 개선된 변수 초기화 판정파일 다운로드1
12792정성태8/19/2021553.NET Framework: 1096. C# 10 - (2) 전역 네임스페이스 선언파일 다운로드1
12791정성태8/19/2021459.NET Framework: 1095. C# COM 개체를 C++에서 사용하는 예제 [3]파일 다운로드1
12790정성태8/18/2021613.NET Framework: 1094. C# 10 - (1) 구조체를 생성하는 record struct파일 다운로드1
12789정성태8/18/2021483개발 환경 구성: 597. PyCharm - 윈도우 환경에서 WSL을 이용해 파이썬 앱 개발/디버깅하는 방법
12788정성태8/17/2021843.NET Framework: 1093. C# - 인터페이스의 메서드가 다형성을 제공할까요? (virtual일까요?)파일 다운로드1
12787정성태8/17/2021978.NET Framework: 1092. (책 내용 수정) "4.5.1.4 인터페이스"의 "인터페이스와 다형성"
1  2  [3]  4  5  6  7  8  9  10  11  12  13  14  15  ...