[Django] MacOS 장고 개발환경 설정

MacOS에서 장고 시작 & 설치

 

작년에 처음 장고를 사용해보았는데 올해 또 쓸 일이 생겨서 필요할 때마다 쉽게 찾을 수 있게 정리해본다.
최근에는 맥에서 많이 설치했기 때문에 MacOS에서 설치하는 법을 쓰고
조만간 우분투에서 설치할 일이 또 있을 것 같아서 그 때 linux에서 설치하는 법을 더할 계획이다.
하지만 사실 설치법은 매우 유사하다.

 

일단 장고는 파이썬 기반 프레임워크기 때문에 파이썬3가 깔려있어야 한다.
아주 만약에 파이썬3가 깔려있지 않다면

brew install python3

을 사용해서 설치하면 된다. 만약에 brew 명령어도 안된다면 Homebrew를 깔아야할 것이다.

이제 아래의 step들을 따르면 django를 금방 사용할 수 있을 것이다.

1) 가상환경 (virtual environment) 설치하기

virutal environment는 말그대로 가상환경이다. Django 프로젝트를 개발할 때에 컴퓨터에 있는 다른 프로젝트들에 영향을 끼치지 않고 현 프로젝트에 필요한 버전들을 계속 사용하기 위해서 virtual environment를 사용하는 것이 좋다.

sudo pip3 install virtualenvwrapper

다음 ~/.bash_profile 의 제일 밑에 (vi ~/.bash_profile)

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

를 추가해주었다.
그리고 새로운 가상환경을 만들기 전에

source ~/.bash_profile

명령어를 입력해준다.

2) 가상환경 만들기

mkvirtualenv my_django_environment(가상환경 이름)

를 입력하면 가상환경이 생선된다

친구에게 설명해주었을 때에

/Applications/Xcode.app/Contents/Developer/usr/bin/python3: Error while finding module specification for 'virtualenvwrapper.hook_loader' (ModuleNotFoundError: No module named 'virtualenvwrapper')
virtualenvwrapper.sh: There was a problem running the initialization hooks.

If Python could not import the module virtualenvwrapper.hook_loader,
check that virtualenvwrapper has been installed for
VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3 and that PATH is
set properly.

이러한 에러가 뜨는 경우도 있었는데
https://dgkim5360.tistory.com/entry/python-virtualenv-on-linux-ubuntu-and-windows
위 링크를 따라했더니 되었다고 한다.

또한 처음에는 가상환경에서 나왔을 때 다시 들어가려면 해당 가상 환경의 위치를 파악해서 아래와 유사하게 입력하면 가상환경에 들어갈 수 있다.

source ~/.virtualenvs/my_django_environment/bin/activate

3) Django 설치

pip3 install django

4) 설치 확인

마지막으로 장고 프로젝트를 생성해서 개발 환경이 준비되었는지 확인해보자
프로젝트 이름을 임의로 sample이라고 짓기로 했다.

django-admin startproject sample

위 명령어를 치면 아래처럼 sample이라는 이름의 directory가 만들어진다.

cd sample

이 directory 로 들어가면 동명의 directory와 함께 manage.py 라는 파일이 있다.

manage.py 파일이 있는 directory에서

python3 manage.py runserver

를 입력하면 아래처럼 뜬다.

그리고 인터넷 브라우저에서 127.0.0.1:8000 으로 접속하면 아래처럼 뜬다.

이제 장고 프로젝트를 개발할 준비가 되었다.

Reference

이 포스트의 많은 부분, 그리고 처음 장고를 시작할 때에 mozilla tutorial과 django documentation이 많은 도움이 되었다.

https://developer.mozilla.org/en-US/docs/Learn/Server-side/Django/development_environment

https://docs.djangoproject.com/en/3.0/intro/install/