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

이후의 다양한 환경 설정을 분리하기 위해 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"라고 설정해야 합니다.




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

[연관 글]


donaricano-btn



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

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

비밀번호

댓글 쓴 사람
 




1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12787정성태8/17/2021978.NET Framework: 1092. (책 내용 수정) "4.5.1.4 인터페이스"의 "인터페이스와 다형성"
12786정성태8/16/2021695.NET Framework: 1091. C# - Python range 함수 구현 (2) INumber<T>를 이용한 개선 [1]파일 다운로드1
12785정성태8/16/2021454.NET Framework: 1090. .NET 6 Preview 7에 추가된 숫자 형식에 대한 제네릭 연산 지원파일 다운로드1
12784정성태8/15/2021326오류 유형: 757. 구글 메일 - 아웃룩에서 메일 전송 시 Sending' reported error (0x800CCC0F)
12783정성태8/15/2021435.NET Framework: 1089. C# - Indexer에 Range 및 람다 식을 이용한 필터 구현파일 다운로드1
12782정성태8/14/2021392오류 유형: 756. 파이썬 - 윈도우 환경에서 pytagcloud의 한글 출력 방법
12781정성태8/14/2021713오류 유형: 755. 파이썬 - konlpy 사용 시 JVM과 jpype1 관련 오류
12780정성태8/13/2021456.NET Framework: 1088. C# - 버스 노선 및 위치 정보 조회 API 사용을 위한 기초 라이브러리 [2]
12779정성태8/13/2021462개발 환경 구성: 596. 공공 데이터 포털에서 버스 노선 및 위치 정보 조회 API 사용법
12778정성태8/12/2021290오류 유형: 755. PyCharm - "Manage Repositories"의 목록이 나오지 않는 문제
12777정성태8/12/2021368오류 유형: 754. Visual Studio - Input or output cannot be redirected because the specified file is invalid.
12776정성태8/12/2021920오류 유형: 753. gunicorn과 uwsgi 함께 사용 시 ERR_CONNECTION_REFUSED
12775정성태8/12/2021893스크립트: 22. 파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 gunicorn을 이용해 실행
12774정성태8/11/2021742.NET Framework: 1087. C# - Collection 개체의 다중 스레드 접근 시 "Operations that change non-concurrent collections must have exclusive access" 예외 발생
12773정성태8/11/2021912개발 환경 구성: 595. PyCharm - WSL과 연동해 Django App을 윈도우에서 리눅스 대상으로 개발
12772정성태8/11/2021732스크립트: 21. 파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 uwsgi를 이용해 실행
12771정성태8/11/2021584Windows: 196. "Microsoft Windows Subsystem for Linux Background Host" / "Vmmem"을 종료하는 방법
12770정성태8/11/2021869.NET Framework: 1086. C# - Windows Forms 응용 프로그램의 자식 컨트롤 부하파일 다운로드1
12769정성태8/11/2021698오류 유형: 752. Python - ImportError: No module named pip._internal.cli.main 두 번째 이야기
12768정성태8/10/2021976.NET Framework: 1085. .NET 6에 포함된 신규 BCL API [1]파일 다운로드1
12767정성태8/10/20211043오류 유형: 752. Python - ImportError: No module named pip._internal.cli.main
12766정성태8/9/2021805Java: 32. closing inbound before receiving peer's close_notify
12765정성태8/9/2021446Java: 31. Cannot load JDBC driver class 'org.mysql.jdbc.Driver'
12764정성태8/9/2021362Java: 30. XML document from ServletContext resource [/WEB-INF/applicationContext.xml] is invalid
12763정성태8/9/2021536Java: 29. java.lang.NullPointerException - com.mysql.jdbc.ConnectionImpl.getServerCharset
12762정성태8/8/2021768Java: 28. IntelliJ - Unable to open debugger port 오류
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...