🗓 Django + Nginx + Gunicorn

기업협업 진행하면서, 거의 이틀에 걸쳐서 진행했던 작업이었다.
위코드에서 프로젝트 할 때는, 터미널에서 runserver 혹은 gunicorn으로 서버 여는 것 까지가 전부였는데 처음 접하는 nginx를 하게 되니 많은 시행착오가 있었다.

📌 나의 환경

• mac os
• miniconda 사용
• Django 3.1.1
• python 3.8

📌 현재 상황
1. 로컬에 Django 초기 세팅 및 views 작성
2. AWS EC2 생성
3. 터미널에서 AWS 접속해서 gunicorn 및 nginx 설정해서 서버 열기
4. 데이터베이스는 필요가 없는 작업이라 따로 설정하지 않았다

미니콘다 & 장고 기초셋팅 & 파이썬이 준비되어 있다는 가정하에 정리하려고 한다.

1. AWS EC2 생성

1-1. AWS 사이트 접속

1. https://aws.amazon.com/ko/ 접속 + 회원가입 + 로그인

2. 서비스 > EC2 > 인스턴스 시작

3. Ubuntu Server 18.04 LTS (HVM), SSD Volume Type 선택
   

4. t2 / t2 micro(프리티어 사용가능) 선택 > 다음:인스턴스 세부 정보 구성

5. 아래 이미지와 같이 구성

• 서브넷의 경우 2b로 해도 무관함
  

6. 스토리지 추가에서는 아무것도 수정없이 다음:태그 추가 버튼 클릭
7. 태그 추가 버튼
   • 다양한 태그를 추가할 수 있으며, 수정도 가능하다
   • 나의 경우 : 협업중인 회사의 프로젝트라 아래와 같이 생성했다.
     - 키 : 회사명_project
     - 값 : first_project
     

8. 하단 규칙 추가 버튼
   - 유형 : 사용자지정 TCP규칙
   - 포트범위 : 8000
   - 소스 : 위치 무관

   검토 및 시작버튼 누르면 인스턴스가 생성된다.

1-2. 터미널에서 AWS 설정하기

인스턴스를 생성하면서, 키페어 파일을 다운 받아 놓은 게 있을 것이다.
ssh로 접속이 가능하게끔 pem파일의 권한을 바꿔줘야 한다.

# 터미널을 키고, pem 파일을 받아 놓은 위치로 간다
# ex. aws 라는 파일에 있다면, cd aws
# 해당 위치에서 아래의 명령어 입력

$ chmod 400 키페어파일이름.pem

권한을 바꿔줬으면, ssh 접속을 해보자

$ ssh -i 키페어파일이름.pem ubuntu@공인IP
ex. ssh -i proejct.pem ubuntu@33.121.14.11

33.121.14.11 은 예로 든 것이며, 공인 IP는 AWS에 EC2 로 가면 위에서 생성한 인스턴스가 있을 것이다. 인스턴스를 클릭하면 퍼블릭 IPv4 주소가 있는데, 이 주소를 넣으면 된다.

2. 미니콘다 설정하기

2-1. 미니콘다로 가상환경 설정하기

우분투라는 새로운 환경이 터미널에서 열린 것이기 때문에, 내가 로컬에서 가지고 있는 것들은 우분투 환경에 없는 상태다. 그래서 미니콘다 및 필요한 툴들을 설치해줘야 한다.

• 미니콘다 홈페이지 접속 https://docs.conda.io/en/latest/miniconda.html
• linux installers 에서 링크 위에 마우스 오른쪽 버튼 > 링크 주소 복사

# 터미널로 돌아와서 아래 내용 입력(링크는 위의 이미지처럼 링크 복사 한 것)
$ wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

#실행권한 주기
$ chmod +x Miniconda3-latest-Linux-x86_64.sh

#미니콘다 실행시켜서 설치하기
$ ./Miniconda3-latest-Linux-x86_64.sh
# 엔터엔터엔터 계속 누르고 다 yes해서 설치하기

# bash shell 스크립트를 실행해서 로컬 환경과 같게 설정하기
$ source .bashrc
# 이렇게 입력하면 명령라인 제일 앞에 (base) 생성

# 패키지 업데이트 및 업그레이드
$ sudo apt-get update
$ sudo apt-get upgrade

# mysql 클라이언트 설치시 에러 안나게 하려면 gcc 설치해야함
$ sudo apt-get install gcc
$ sudo apt-get install libmysqlclient dev
# 현재 프로젝트의 경우 위의 두개는 필요하지 않다

# 가상환경 생성
$ conda create -n project python=3.8
# project는 생성하고 싶은 가상환경 이름이라, 원하는 걸로 하면 된다.

# 가상환경 활성화
$ conda activate project

3. Django 세팅하기

3-1. git clone 으로 django 설정하기

# git clone받기
# 나의 경우, git에 장고 초기세팅 작업한 파일을 올려놨기 때문에 이를 클론 받았다.
$ git clone 깃 주소

# 디렉토리로 이동
$ cd 장고 디렉토리 이름

# requirements 설정
# 로컬에서 장고 초기세팅 할 때, 프로젝트에 필요한 패키지 목록을 requirements 파일로 생성해뒀다.
# 배포를 해야하기 때문에, 이 파일에 있는 리스트를 우분투에서도 똑같이 설치해줘야한다.
# 아래의 명령어를 입력하면 requirements파일에 있는 패키지가 한번에 설치된다.
$ pip install -r requirements.txt
$ pip freeze (제대로 설치됐나 확인하는 명령어)

# 제대로 작동하는지 확인해보기
$ python manage.py runserver 0.0.0.0:8000

4. gunicorn 설치하기

gunicorn은?

• 웹 서버에서 장고 웹 애플리케이션을 돌려주는 방식

$ pip install gunicorn
$ pip freeze > requirements.txt

# requirements 파일에 없는 패키지를 우분투에서는 설치한거니까 requirements에도 똑같이 옮기기

# nohup 이라는 툴로 gunicorn 동작시키기
$ nohup gunicorn --bind=0.0.0.0:8000 프로젝트명.wsgi &
# 프로젝트 명은 django 설정할 때, 생성했던 프로젝트 명
# settings.py 가 있는 폴더의 명

# 제대로 작동하나 log 확인하기
$ ps -ef | grep python

5. nginx 설치하기

# 터미널에서 아래 명령어로 sites-enabled / sites-enabled 위치로 이동
# 아래 두개의 경로에 아래 내용 똑같이 입력하기

$ cd /etc/nginx/sites-enabled
$ cd /etc/nginx/sites-available

# 위의 경로에 프로젝트 명(settings.py가 있는 폴더명)으로 파일 생성하기

$ sudo -vi 프로젝트명

# 아래내용 입력
server {
        listen 80;
        server_name [AWS EC2 public ip주소];
		charset utf-8;
       
		location / {
                include proxy_params;
                proxy_pass http://127.0.0.1:8000
        }
        
        location /static/ {
                alias /home/ubuntu/프로젝트 폴더;
        }
}

# 연결할 도메인이 있다면 ?! (ex. 도메인이 http://soohyun.com 이라고 가정하면)
server {
        listen 80;
        server_name soohyun.com www.soohyun.com;
        #www 붙인 것 하나, 안 붙인 것 하나 해서 두번 써주기
		charset utf-8;
       
		location / {
                include proxy_params;
                proxy_pass http://127.0.0.1:8000
        }
        
        location /static/ {
                alias /home/ubuntu/프로젝트 폴더;
        }
}

찾아보니까 블로그마다 static과 media 경로를 설정하는 곳도 있고, 설정하지 않는 곳도 있는데 그 차이를 아직 모르겠다 ㅠㅠ > 정리필요!!

# nginx 문법 오류 판단
$ sudo nginx -t

# 잘 설정되어 있는지 확인하려면?
$ systemctl status nginx

# 에러가 없다면 nginx 구동
$ sudo systemctl restart nginx

📌 중요!!! 여기까지하면 포스트맨으로 서버를 실행했을 때 서버가 돌아가지 않는다. 80번 포트를 aws 에서 따로 허용처리를 해줘야 한다.

1. aws ec2 인스턴스 클릭
2. 하단 보안 탭 클릭
3. 보안 그룹 링크 클릭
4. 인바운드 규칙 편집 클릭
5. 아래와 같이 80번 포트 2개를 추가로 설정해줘야 한다.
   

nginx 참고1
nginx 참고2
nginx 참고3