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

파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 uwsgi를 이용해 실행

사실 uwsgi를 사용한다는 것은 서비스하겠다는 것이므로 WSL 환경에서 굳이 사용할 필요는 없습니다. 따라서 그냥 할 수 있다는 정도만 알고 (게다가 요즘은 gunicorn이 유명하다고 하니 더더욱) 넘어가셔도 무방한데요, 그래도 리눅스 서버에 올리기 전 확인을 해보고 싶은 분들이라면 간단하게 WSL을 이용해 볼 수도 있을 것입니다.

예를 들어, 다음과 같은 구조의 간단한 Django app을 만들었다고 가정하겠습니다.

./myapp
├───bbs
│   ├───migrations
│   ├───static
│   │   └───bbs
│   ├───templates
│   │   └───bbs
├───myapp
│   └───__pycache__
├───static
│   ├───admin
└───templates
    └───registration

(wsgi 파일은 ./myapp/myapp/wsgi.py에 있습니다.)

자, 그럼 우선 wsl 환경에 python을 위한 모듈을 먼저 설치하고,

$ sudo apt install python3

// ubuntu 20.04 + python 3.11
// https://ubuntuhandbook.org/index.php/2022/10/python-3-11-released-how-install-ubuntu/
$ sudo add-apt-repository ppa:deadsnakes/ppa
$ sudo apt update

$ sudo apt install python3.11
// 또는,
$ sudo apt install python3.11-full

$ python3.11 --version

이후의 다양한 환경 설정을 분리하기 위해 virtualenv도 설치 후,

$ sudo pip3 install virtualenv

가상 환경을 적당한 디렉터리(pyenv 하위의 myapp)에 활성화합니다.

$ cd ~
~$ mkdir pyenv
~$ cd pyenv
~/pyenv$ virtualenv myapp

~/pyenv$ source myapp/bin/activate
(myapp) testusr@TESTPC:~/pyenv$

마지막으로 (우여곡절 끝에 - 문제 1, 문제 2) Django와 uwsgi를 설치합니다.

(myapp) testusr@TESTPC:~/pyenv$ python3 -m pip install --upgrade pip

(myapp) testusr@TESTPC:~/pyenv$ pip3 install Django 
(myapp) testusr@TESTPC:~/pyenv$ pip3 install uwsgi




이제 uwsgi에서 호스팅하기 위한 Django App의 사전 준비를 합니다. 이 작업은 윈도우 개발 환경에서 해주시면 됩니다.

우선 settings.py에 정적 리소스를 위한 루트 디렉터리를 지정하고,

# settings.py

STATIC_ROOT = os.path.join(BASE_DIR, 'static/')

마이그레이션 후,

// 예를 들어 D:\pycharm\work\myapp에 Django 앱이 위치한 경우
c:\temp> cd D:\pycharm\work\myapp

// 개발하는 동안 수행한 적이 있으면 무시

d:\pycharm\work\myapp> python manage.py makemigrations
d:\pycharm\work\myapp> python manage.py migrate
d:\pycharm\work\myapp> python manage.py createsuperuser

정적 콘텐츠들을 모아줍니다.

D:\pycharm\work\myapp> python ./manage.py collectstatic

You have requested to collect static files at the destination
location as specified in your settings:

    D:\pycharm\work\myapp\static

This will overwrite existing files!
Are you sure you want to do this?

Type 'yes' to continue, or 'no' to cancel: yes

128 static files copied to 'D:\pycharm\work\myapp\static', 1 unmodified.




끝입니다. 이제 WSL에서 다음과 같은 옵션을 이용해,

-H|--home                               set PYTHONHOME/virtualenv
-H|--pyhome                             set PYTHONHOME/virtualenv

--http                                  add an http router/server on the specified address

--chdir                                 chdir to specified directory before apps loading
--chdir2                                chdir to specified directory after apps loading

--wsgi-file                             load .wsgi file
--file                                  load .wsgi file
-w|--module                             load a WSGI module
-w|--wsgi                               load a WSGI module

호스팅을 시작합니다.

uwsgi --http :[포트]
      --home [virtualenv_path]
      --chdir [webapp_path]
      --wsgi-file [chdir 기준 wsgi.py 경로]

예1) 18080 포트로, 윈도우의 d:\pycharm\work\myapp에 Django 앱을 개발한 경우
uwsgi --http :18080 
      --home $HOME/pyenv/myapp 
      --chdir /mnt/d/pycharm/work/myapp 
      --wsgi-file ./myapp/wsgi.py

예2) virtualenv를 사용하지 않겠다면,
uwsgi --http :18080 
      --chdir /mnt/d/pycharm/work/myapp 
      --wsgi-file ./myapp/wsgi.py

예3) 이미 current directory가 Django App의 경로라면,
/mnt/d/pycharm/work/myapp$ uwsgi --http :18080 --wsgi-file ./myapp/wsgi.py

그래서 이렇게 실행하고,

$ uwsgi --http :18080 --home $HOME/pyenv/myapp --chdir /mnt/d/pycharm/work/myapp --wsgi-file ./myapp/wsgi.py
*** Starting uWSGI 2.0.19.1 (64bit) on [Wed Aug 11 17:40:05 2021] ***
compiled with version: 9.3.0 on 10 August 2021 10:28:41
os: Linux-5.10.16.3-microsoft-standard-WSL2 #1 SMP Fri Apr 2 22:23:49 UTC 2021
nodename: TESTPC
machine: x86_64
clock source: unix
detected number of CPU cores: 4
current working directory: /mnt/d/pycharm/work/myapp
detected binary path: /home/testusr/pyenv/myapp/bin/uwsgi
!!! no internal routing support, rebuild with pcre support !!!
chdir() to /mnt/d/pycharm/work/myapp
*** WARNING: you are running uWSGI without its master process manager ***
your processes number limit is 102268
your memory page size is 4096 bytes
detected max file descriptor number: 1024
lock engine: pthread robust mutexes
thunder lock: disabled (you can enable it with --thunder-lock)
uWSGI http bound on :18080 fd 4
spawned uWSGI http 1 (pid: 20543)
uwsgi socket 0 bound to TCP address 127.0.0.1:40761 (port auto-assigned) fd 3
Python version: 3.8.10 (default, Jun  2 2021, 10:49:15)  [GCC 9.4.0]
PEP 405 virtualenv detected: /home/testusr/pyenv/myapp
Set PythonHome to /home/testusr/pyenv/myapp
*** Python threads support is disabled. You can enable it with --enable-threads ***
Python main interpreter initialized at 0x563d77ee7080
your server socket listen backlog is limited to 100 connections
your mercy for graceful operations on workers is 60 seconds
mapped 72904 bytes (71 KB) for 1 cores
*** Operational MODE: single process ***
WSGI app 0 (mountpoint='') ready in 0 seconds on interpreter 0x563d77ee7080 pid: 20542 (default app)
*** uWSGI is running in multiple interpreter mode ***
spawned uWSGI worker 1 (and the only) (pid: 20542, cores: 1)
/mnt/d/pycharm/work/myapp

/* uwsgi 이름을 가진 모든 프로세스를 종료하고 싶다면?
sudo pkill -f uwsgi -9
*/

"http://localhost:18080/bbs"로 요청을 보내면 정상적으로 ./bbs/views.py가 요청을 처리하는 것을 확인할 수 있습니다.

참고로, wsgi.py의 의미는 다음의 문서를 읽어보시면 이해가 되실 것입니다.

Quickstart for Python/WSGI applications
; https://uwsgi-docs.readthedocs.io/en/latest/WSGIquickstart.html




만약 uwsgi로 실행했는데 페이지 요청 시 "Internal Server Error"가 발생한다면? 아마 거의 대부분 uwsgi 출력 화면에 다음과 같은 메시지가 있을 것입니다.

...[생략]...
failed to open python file wsgi.py
unable to load app 0 (mountpoint='') (callable not found or import error)
*** no app loaded. going in full dynamic mode ***
*** uWSGI is running in multiple interpreter mode ***
spawned uWSGI worker 1 (and the only) (pid: 20588, cores: 1)
--- no python application found, check your startup logs for errors ---
[pid: 20588|app: -1|req: -1/1] 127.0.0.1 () {52 vars in 1114 bytes} [Wed Aug 11 15:09:37 2021] GET /bbs/ => generated 21 bytes in 0 msecs (HTTP/1.1 500) 2 headers in 83 bytes (0 switches on core 0)

이런 경우 uwsgi 실행 시 넘겨 준 "--wsgi-file" 옵션의 경로가 올바른지 확인해 보세요. 또는, "-w" 옵션으로 모듈 경로를 넘겨주는 것도 볼 수 있는데요,

$ uwsgi --http :18080 --home $HOME/pyenv/myapp --chdir /mnt/d/pycharm/work/myapp -w test.wsgi

이럴 때는 로그에 ModuleNotFoundError 메시지가 남습니다.

...[생략]...
ModuleNotFoundError: No module named 'test.wsgi'
unable to load app 0 (mountpoint='') (callable not found or import error)
*** no app loaded. going in full dynamic mode ***
...[생략]...

이번 예제와 같은 경우에는 (wsgi.py가 current directory 기준으로 myapp 디렉터리 하위에 있으므로) "-w myapp.wsgi"라고 설정해야 합니다.




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 11/15/2022]

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

비밀번호

댓글 작성자
 



2021-12-13 02시17분
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13186정성태12/6/202217오류 유형: 831. The framework 'Microsoft.AspNetCore.App', version '...' was not found.
13185정성태12/6/202238개발 환경 구성: 653. Windows 환경에서의 Hello World x64 어셈블리 예제 (NASM 버전)
13184정성태12/5/202276개발 환경 구성: 652. ml64.exe와 link.exe x64 실행 환경 구성
13183정성태12/4/202252오류 유형: 830. MASM + CRT 함수를 사용하는 경우 발생하는 컴파일 오류 정리
13182정성태12/4/202286Windows: 217. Windows 환경에서의 Hello World x64 어셈블리 예제 (MASM 버전)
13181정성태12/3/202281Linux: 54. 리눅스/WSL - hello world 어셈블리 코드 x86/x64 (nasm)
13180정성태12/2/202287.NET Framework: 2074. C# - 스택 메모리에 대한 여유 공간 확인하는 방법파일 다운로드1
13179정성태12/2/202254Windows: 216. Windows 11 - 22H2 업데이트 이후 Terminal 대신 cmd 창이 뜨는 경우
13178정성태12/1/2022146Windows: 215. Win32 API 금지된 함수 - IsBadXxxPtr 유의 함수들이 안전하지 않은 이유파일 다운로드1
13177정성태11/30/202298오류 유형: 829. uwsgi 설치 시 fatal error: Python.h: No such file or directory
13176정성태11/29/202274오류 유형: 828. gunicorn - ModuleNotFoundError: No module named 'flask'
13175정성태11/29/2022105오류 유형: 827. Python - ImportError: cannot import name 'html5lib' from 'pip._vendor'
13174정성태11/28/2022131.NET Framework: 2073. C# - VMMap처럼 스택 메모리의 reserve/guard/commit 상태 출력파일 다운로드1
13173정성태11/27/2022217.NET Framework: 2072. 닷넷 응용 프로그램의 스레드 스택 크기 변경
13172정성태11/25/2022267.NET Framework: 2071. 닷넷에서 ESP/RSP 레지스터 값을 구하는 방법파일 다운로드1
13171정성태11/25/2022223Windows: 214. 윈도우 - 스레드 스택의 "red zone"
13170정성태11/24/2022369Windows: 213. 윈도우 - 싱글 스레드는 컨텍스트 스위칭이 없을까요?
13169정성태11/23/2022382Windows: 212. 윈도우의 Protected Process (Light) 보안 [1]파일 다운로드2
13168정성태11/22/2022339제니퍼 .NET: 31. 제니퍼 닷넷 적용 사례 (9) - DB 서비스에 부하가 걸렸다?!
13167정성태11/21/2022331.NET Framework: 2070. .NET 7 - Console.ReadKey와 리눅스의 터미널 타입
13166정성태11/20/2022259개발 환경 구성: 651. Windows 사용자 경험으로 WSL 환경에 dotnet 런타임/SDK 설치 방법
13165정성태11/18/2022271개발 환경 구성: 650. Azure - "scm" 프로세스와 엮인 서비스 모음
13164정성태11/18/2022429개발 환경 구성: 649. Azure - 비주얼 스튜디오를 이용한 AppService 원격 디버그 방법
13163정성태11/17/2022280개발 환경 구성: 648. 비주얼 스튜디오에서 안드로이드 기기 인식하는 방법
13162정성태11/15/2022669.NET Framework: 2069. .NET 7 - AOT(ahead-of-time) 컴파일
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...