[심화] 배포하기 - LightSail

1. 배포 전 준비

1.1 환경 변수 설정

# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = '%ljvk*h2sno=wepa5p)dt+c6gtq44@fn^cl=7&+8ypc)k4xe16'

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

-4x*bi!=wb5scgl4#zwxc#c1dk)5g-r_ry%=ziv1o4kvf&2ukv

• SECRET_KEY : 프로젝트의 보안 등에 이용되는 긴 랜덤 문자열 값입니다. 보안과 관련되어 있으므로 외부에 노출되어서는 안 됩니다.

• DEBUT : 이 값이 True이면 개발 단계에서 개발자를 위해 도와주는 디버그 정보가 보여지게 됩니다. 하지만 배포 시에는 프로젝트 보안 상 디버그 정보가 노출 되어서는 안 됩니다.

1. settings.py에서 decouple을 사용여 SECRET_KEY와 DEBUG 값을 정의합니다.

// 가상환경 설치가 안되어 있다면 터미널에서 아래 명령어를 따라쳐 주세요
$ pip install virtualenv
$ python3 -m venv env
$ source env/bin/activate

가상환경에 잘 들어갔다면 아래 사진과 같이 맨 앞에 (env)가 있는 것을 확인할 수 있습니다.



$ source [가상환경폴더명]/bin/activate
$ pip install -r requirements.txt
$ pip install python-decouple==3.5

 
 

2. 환경 변수의 값들은 decouple을 이용하여 settings.env에 접근할 수 있습니다.

from decouple import config

SECRET_KEY = config('SECRET_KEY', '1')
DEBUG = config('DEBUG', default=False, cast=bool)

환경변수 값들은 모두 문자열로 저장되기 때문에 True를 넣더라도 bool 타입의 True 가 아니라 문자열 'True'인 것에 유의하세요.
 

3. settings.py 가 있는 폴더 안에 settings.env라는 환경변수 파일을 만들어 아래와 같이 작성합니다.

SECRET_KEY = secret_key # 본인 secretkey를 넣어주세요.
DEBUG = False

1. 프로젝트 폴더 경로에 .gitignore 파일을 만들어 https://www.toptal.com/developers/gitignore 에서 django를 검색하고 나온 소스코드를 붙여넣어주세요.

1.2. collectstatic

1. settings.py에서 STATIC_ROOT 변수에 static 파일들을 모을 경로를 설정합니다.

STATIC_ROOT = BASE_DIR / 'staticfiles' 

BASE_DIR은 프로젝트 생성 시 자동으로 만들어 준 경로값으로 manage.py가 있는 경로를 가리킵니다. 우리는 BASE_DIR 경로의 staticfiles라는 폴더에 static 파일들을 모을 것입니다.
 

2. collectstatic 명령어로 static 파일들을 모읍니다.

$ python manage.py collectstatic



staticfiles가 이미 있는 경우에는 yes 명령어를 입력해주셔야 합니다.

2. WSGI

사용자 <-> 웹 서버 <-> WSGI <-> 장고

2.1. uWSGI

- uWSGI 실행해보기

1. uWSGI를 설치할 가상환경을 활성화합니다.

$ source [가상환경폴더경로]/bin/activate

 

2. pip를 이용해 uWSGI를 설치합니다. (약간의 시간 소요)

$ pip install uwsgi

// 설치가 안된다면 wheel을 먼저 설치해주세요.
$ pip install wheel 

// 그래도 설치가 안된다면 가상환경이 아닌 로컬에서 설치해주셔야 합니다.
$ deactivate
$ sudo apt-get update
$ sudo apt install python3-pip
$ pip install uwsgi

 

3. uWSGI를 실행시켜봅니다.

uwsgi
--http :[포트번호]
--home [가상환경 경로]
--chdir [장고프로젝트폴더 경로]
-w [wsgi 모듈이 있는 폴더].wsgi

$ uwsgi \
--http 0:8000 \
--thunder-lock \
--static-map /static=staticfiles/ \
-w MBIT.wsgi



1. /mbit/.config/uwsgi 경로에 uwsgi.ini파일을 만듭니다.



 
 
이제 runserver 명령 없어도 8080번 포트로 접속하면 프로젝트 페이지로 접속이 가능합니다.

- ini 파일로 uWSGI 실행

1. uwsgi.ini 파일을 다음과 같이 수정해줍니다.
리눅스 명령어 tip
ls : 폴더 목록 보기
cd [폴더명] : [폴더명]으로 이동하기, cd .. 는 이전 폴더로 돌아갑니다.
mkdir : 폴더 생성하기
touch : 파일 생성하기
vi [파일명] : 파일 수정하기 → i 를 누르면 수정할 수 있는 권한이 주어지며 esc를 누르고 :wq!를 누르면 저장 후 종료, :q!를 누르면 강제종료가 됩니다.

[uwsgi]
module = MBIT.wsgi:application

uid = root
gid = root

http = 0:8000

enable-threads = true
master = true
vacuum = true
pidfile = /tmp/MBIT.pid
logto = log/uwsgi/@(exec://date +%%Y-%%m-%%d).log
log-reopen = true:
static-map = /static=staticfiles/

• chdir : django project의 manage.py가 존재하는 경로를 지정해줍니다.
• module : wsgi 파일을 지정해줍니다.
• home : 가상환경의 경로를 지정해줍니다.
• uid, gid : uWSGI를 실행할 사용자 및 사용자그룹을 지정해줍니다.
• http : http 프로토콜을 통해서 요청을 받으며 포트 번호를 정해줍니다.
• enable-threads : 스레드 사용 여부를 결정합니다.
• master : 마스터 프로세스 사용 여부를 결정합니다.
• vacuum : 실행 시 자동 생성되는 파일들을 삭제해줍니다.
• pidfile : 실행되는 프로세스의 id 값을 담고 있는 파일, pidfile의 경로를 지정해줍니다.
• logto : 로그파일을 작성할 위치를 설정합니다.
• log-reopen : 재시작할 시 로그를 다시 열어줍니다.
 

2. 프로젝트 경로에 tmp 폴더와 log/uwsgi 폴더를 만듭니다.



 

3. uwsgi 명령어로 uwsgi.ini 파일을 실행시킵니다.

$ uwsgi -i .config/uwsgi/uwsgi.ini



 

4. 8000번 포트의 URL로 접속합니다.(IP는 lightsail의 public IP를 사용해야 합니다.)

3. Nginx

3.1. 웹서버

• 인증

• 정적 콘텐츠 관리

• HTTPS 지원

• 콘텐츠 압축

• 가상 호스팅

• 대용량 파일 지원

• 대역폭 스로틀링

3.2. Nginx 설치하기

1. 터미널에서 nginx를 설치해주세요. 다음 명령어를 통해 nginx 설치여부와 버전을 확인할 수 있습니다.

$ sudo apt install nginx
$ nginx -v

 

2. .config/nginx/ 폴더를 만들어줍니다.
 

3. .config/nginx/MBIT.conf 파일을 만들고 내용을 다음과 같이 수정합니다.

$ vi .config/nginx/MBIT.conf // 파일 접근하기

server {
	  listen 8000;
		server_name *.mbit.weniv.co.kr;
		charset utf-8;
		client_max_body_size 128M;
		root /home/ubuntu/mbit/lecture/;

		location / {
				uwsgi_pass unix:////tmp/MBIT.sock;
				include /etc/nginx/uwsgi_params;
		}

		location /static/ {
				root /staticfiles/;
		}
}

1. MBIT.conf 파일을 /etc/nginx/sites-available/ 폴더에 복사합니다.

sudo cp -f .config/nginx/MBIT.conf /etc/nginx/sites-available/

sites-available 폴더는 가상 서버 환경들에 대한 설정 파일들이 위치하는 부분입니다. 가상 서버를 사용하거나 사용하지 않던간에 그에 대한 설정 파일들이 위치하는 곳입니다.
 

2. sites-available 로 이동한 설정 파일을 sites-enabled에 링크해줍니다.

sudo ln -sf /etc/nginx/sites-available/MBIT.conf /etc/nginx/sites-enabled/

sites-enabled는 sites-available에 있는 가상 서버 파일들중에서 실행시키고 싶은 파일을 symlink로 연결한 폴더입니다. 실제로 이 폴더에 위치한 가상서버 환경 파일들을 읽어서 서버를 세팅합니다.
 

3. sites-available 폴더에 있던 default 파일은 삭제해줍니다.

$ rm /etc/nginx/sites-available/default

 

3.3. uWSGI 소켓 설정

[uwsgi]
module = MBIT.wsgi:application

uid = root
gid = root



#-----------추가 할 부분-----------
socket = /tmp/MBIT.sock
chmod-socket = 666
check-static = /home/ubuntu/mbit/lecture/
#-------------------------------

# 이 부분은 주석처리 해주세요
# http = 0:8000

enable-threads = true
master = true
vacuum = true
pidfile = /tmp/MBIT.pid
logto = log/uwsgi/@(exec://date +%%Y-%%m-%%d).log
log-reopen = true
static-map = /static=staticfiles/

3.4. Nginx 실행하기

1. 다음 명령어로 nginx를 실행합니다.

$ sudo service nginx start

(아무 반응 없이 다음줄로 넘어간다면 제대로 실행된 것 입니다.) 에러 발생 시 로그 확인하기, 로그 위치 : /var/log/nginx/error.log
 

2. 8080번 포트의 URL로 접속하면 사진 처럼 nginx가 작동하는 것을 확인할 수 있습니다.



아직 페이지가 정상적으로 보이지 않는 것은 uWSGI가 실행 되지 않아 소켓이 없는 상태이기 때문입니다.
 

3. 이제 uWSGI를 실행시켜 소켓을 활성화합니다.

$ uwsgi -i .config/uwsgi/uwsgi.ini

참고. static 파일이 제대로 나오지 않을 때

STATIC_URL = '/staticfiles/'

4. url 연결하기

5. https로 연결하기

$ sudo apt-get update
$ sudo apt-get install software-properties-common
$ sudo add-apt-repository universe
$ sudo apt-get update

$ sudo apt-get install certbot python3-certbot-nginx

$ sudo vim /etc/nginx/sites-available/MBIT.conf

server {
    ...
		server_name mbit.weniv.co.kr
		...
}

$ sudo nginx -t
$ sudo service nginx reload

$ sudo certbot --nginx -d mbit.weniv.co.kr

$ sudo crontab -e

15 3 * * * /usr/bin/certbot renew --quiet --renew-hook "/usr/sbin/service nginx reload"

• 15 3 * * * : 매일 3:15 AM에 실행하겠다는 의미입니다.

• /usr/bin/certbot : 실행하는 파일입니다.

• renew : 자동으로 certbot이 인증서들을 보고 갱신이 필요하면 갱신을 진행해줍니다.

• –quiet : 사용자에게 output을 전달하지 않고 실행합니다.(백그라운드)

• –renew-hook “/usr/sbin/service nginx reload” : 파일이 새로 갱신되었다면 Nginx를 reload해줍니다.

6. 기타

1. 수정 시 명령어들

(가상환경)
python manage.py collectstatic
python manage.py loaddata data.json

2. static file을 읽어올 수 없을 경우

server {
	  listen 8000;
		server_name *.mbit.weniv.co.kr;
		charset utf-8;
		client_max_body_size 128M;
		root /home/ubuntu/mbit/lecture/;

		location / {
				uwsgi_pass unix:////tmp/MBIT.sock;
				include /etc/nginx/uwsgi_params;
		}

}