Django 개발환경 세팅

사용하는 파이썬 환경 및 프로젝트 구조

이전 포스팅에서 아래와 같은 프로젝트 폴더를 생성했습니다.

~/projects/
  sample-project/      <- 프로젝트 전체 컨테이너 폴더, sample-env라는 가상환경을 사용

프로젝트 컨테이너 폴더는 ~/projects/sample-project이며, Django프로젝트 폴더의 이름은 django, Django프로젝트의 설정 패키지명은 config를 사용한다. 여기서 설정하는 프로젝트 구조는 튜토리얼 등에서 사용하는 구조보다 한 단계를 더 가지며, Django코드와 프로젝트 설정파일들을 분리할 수 있도록 도와줍니다.

구성 완료 후에는 아래와 같은 구조를 가지게 됩니다.

~/projects/
  sample-project/      <- 프로젝트 전체 컨테이너 폴더, sample-env라는 가상환경을 사용
    .git               <- 로컬 Git 폴더
    .gitignore
    django/            <- Django프로젝트 폴더
      config/          <- Django프로젝트의 설정 패키지. settings, urls, wsgi모듈을 포함
        __init__.py
        settings.py
        urls.py
        wsgi.py
      manage.py
    requirements.txt   <- 설치할 pip패키지 목록 파일

---

프로젝트 폴더로 이동 및 Django프로젝트 생성, Django프로젝트 폴더의 이름 변경

# 프로젝트의 컨테이너 폴더는 이미 생성되어 있으며, 가상환경도 적용된 상태입니다.
cd ~/projects/sample-project

# Django 설치
pip install django

# Django project생성
# 프로젝트명으로 설정 패키지 명이 결정되므로, startproject에 전달되는 프로젝트명으로 config를 사용합니다.
django-admin startproject config

# Django project폴더의 이름 변경
# Django와 관련된 코드만이 모여있다는 의미로 "django"라는 이름을 붙입니다.
mv config django

# 설치된 pip패키지 목록을 requirements.txt에 남기기
pip freeze > requirements.txt

여기까지 진행하면 .git폴더와 .gitignore파일을 제외한 전체 프로젝트 구조가 완성됩니다. 위의 구성 완료 후 구조와 같은지 비교해봅니다.

PyCharm 설정

폴더 열기

PyCharm에서 프로젝트 컨테이너 폴더 (위의 경우 sample-project폴더)를 열어줍니다.

Python interpreter설정

이 프로젝트에서 사용하는 코드를 어떤 파이썬을 사용해서 해석할 지 정해주는 과정입니다.

1. Preferences로 진입해 Project: sample-project탭 클릭
2. Project Interpreter선택
3. 우측 창의 Project Interpreter: 우측의 드롭다운 메뉴를 클릭
4. 가장 아래로 스크롤하여 Show All선택
5. 좌측 아래의 +클릭 -> Add local선택
6. 인터프리터로 사용될 파이썬 선택
   • macOS는 /usr/local/var/pyenv/versions/sample-env/bin/python선택
   • Ubuntu는 /Users/<자신의 홈폴더명>/.pyenv/versions/sample-env/bin/python선택
7. 추가된 인터프리터 선택 후 OK클릭
8. 나온 창에서 OK클릭.

Sources root설정

이 프로젝트에서 해석할 파이썬 애플리케이션의 최상단을 지정합니다. Django프로젝트는 프로젝트 루트 폴더의 한 단계 아래인 sample-project/django폴더에 있으므로 반드시 해당 폴더를 소스 루트로 지정해야 합니다.

좌측의 프로젝트 구조에서 Django프로젝트 폴더(sample-project/django/)에 우클릭 -> Mark Directory as -> Sources Root선택

Git저장소 설정

로컬 Git저장소를 초기화하고, Git으로 관리되지 않을 파일 목록인 .gitignore파일을 가져옵니다. 제가 작성한 일반적인 Django프로젝트에서 사용하는 파일을 wget을 사용해 웹에서 복사해옵니다.

# 로컬 git저장소 초기화
git init

# 웹에서 .gitignore를 받아와 로컬에 저장
wget https://gist.githubusercontent.com/LeeHanYeong/8758517113be32dd2e885fef81c4a96e/raw/00727ac4af42834e6282df05c61606aa396d5b9c/.gitignore

# 현재까지의 작업내역을 commit
git add -A
git commit -m 'First commit'

위 과정을 진행하면 프로젝트에 .git폴더와 .gitignore파일이 추가됩니다. 리눅스 파일시스템에서 .으로 시작하는 파일은 숨김파일이므로, 터미널에서 ls -al명령어를 입력해야 파일을 확인할 수 있습니다.

마치며

프로젝트가 정상적으로 동작하는지 manage.py모듈이 있는 위치에서 python manage.py runserver를 실행하고, 웹 브라우저에서 localhost:8000에 접속해봅니다. 환영 메시지가 출력되어야 합니다.

Django를 처음 시작한다면, Django Girls Tutorial을 따라해보는걸 추천드립니다. 여기서는 이미 가상환경과 코드 에디터 설정, Django설치, Django프로젝트 생성을 끝낸 상태이므로 Django 모델 파트부터 진행하시면 됩니다.

로컬에서 초기화하고 하나의 커밋을 생성한 Git저장소는 GitHub과 같은 서비스를 사용해 리모트 저장소를 만들고 push해 프로젝트를 잃어버리지 않도록 관리하는 것을 권장합니다.