**장고(Django)**는 파이썬(Python) 기반의 **웹 프레임워크(Web Framework)**로, **빠른 개발(Rapid Development)**과 안정적인 웹 애플리케이션 구축을 목표로 합니다. 웹 개발자들 사이에서 높은 생산성과 유지보수성으로 인기를 얻고 있으며, 웹 사이트, API, 백엔드 시스템 구축에 널리 사용됩니다.
이 글에서는 우분투(Ubuntu)에서 장고 설치 및 개발 환경 설정에 대한 단계별 가이드를 제공합니다. Python, Django, 가상환경 설정, 장고 프로젝트 생성 및 실행까지 필요한 모든 절차를 상세히 설명합니다.
목차
- 우분투에서 장고 설치 개요
- 설치 준비 사항 (시스템 업데이트 및 파이썬 설치 확인)
- 파이썬 가상환경(Virtual Environment) 생성
- 장고(Django) 설치
- 장고 프로젝트 생성 및 서버 실행
- 우분투에서 장고 관리 명령어 사용법
- 장고 설치 문제 해결 및 권장 설정
- 결론
1. 우분투에서 장고 설치 개요
우분투(Ubuntu) 환경에서 장고 설치는 Python 환경 설정, 가상환경(Virtual Environment) 생성, Django 설치, 프로젝트 생성의 과정을 포함합니다.
필수 요구 사항:
- 운영 체제: Ubuntu 18.04 / 20.04 / 22.04 (기타 버전도 유사)
- 파이썬 버전: Python 3.8 이상 권장
- 인터넷 연결: 패키지 설치 시 필요
2. 설치 준비 사항 (시스템 업데이트 및 파이썬 설치 확인)
2.1 우분투 패키지 업데이트 및 업그레이드
먼저 우분투 시스템 패키지를 최신 상태로 업데이트합니다.
<bash>
sudo apt update && sudo apt upgrade -y
2.2 Python 설치 확인 및 최신 버전 설치
우분투 20.04 이상에서는 기본적으로 Python 3.x가 설치되어 있습니다. 다음 명령어로 파이썬 설치 여부와 버전을 확인하세요:
<bash>
python3 --version
출력 예시:
<plaintext>
Python 3.8.10
만약 설치되지 않았다면 다음과 같이 설치할 수 있습니다:
<bash>
sudo apt install python3 python3-pip
2.3 PIP(Python 패키지 관리자) 설치 확인
다음 명령어로 PIP 설치 여부를 확인하세요:
<bash>
pip3 --version
출력 예시:
<plaintext>
pip 21.0.1 from /usr/lib/python3/dist-packages (python 3.8)
설치가 안 된 경우 다음 명령어로 PIP 설치:
<bash>
sudo apt install python3-pip
3. 파이썬 가상환경(Virtual Environment) 생성
**가상환경(Virtual Environment)**은 프로젝트마다 독립적인 Python 환경을 설정하기 위한 도구입니다. Django, 라이브러리, 의존성 등을 각 프로젝트별로 관리할 수 있습니다.
3.1 가상환경 패키지 설치
다음 명령어로 가상환경 패키지를 설치합니다:
<bash>
sudo apt install python3-venv
3.2 프로젝트 디렉토리 생성 및 이동
장고 프로젝트를 생성할 디렉토리를 만듭니다:
<bash>
mkdir my_django_project
cd my_django_project
3.3 가상환경 생성 및 활성화
다음 명령어로 가상환경 생성 및 활성화를 수행합니다:
<bash>
python3 -m venv venv
source venv/bin/activate
참고: 가상환경 활성화 시 프롬프트가 변경됩니다:
<plaintext>
(venv) user@ubuntu:~/my_django_project$
4. 장고(Django) 설치
가상환경이 활성화된 상태에서 Django 설치를 진행합니다.
4.1 Django 설치
다음 명령어로 Django 최신 버전을 설치합니다:
<bash>
pip install django
설치 확인:
<bash>
django-admin --version
출력 예시:
<plaintext>
4.2.1
4.2 특정 버전의 Django 설치
특정 버전을 설치하려면 다음과 같이 버전을 지정하세요:
<bash>
pip install django==4.0.2
4.3 필수 개발 도구 설치 (옵션)
개발 환경을 강화하려면 추가 패키지도 설치할 수 있습니다:
<bash>
pip install ipython pylint autopep8
5. 장고 프로젝트 생성 및 서버 실행
5.1 장고 프로젝트 생성
다음 명령어로 Django 프로젝트를 생성합니다:
<bash>
django-admin startproject mysite
프로젝트 디렉토리가 생성되었는지 확인합니다:
<bash>
ls
출력 예시:
<plaintext>
mysite venv
5.2 개발 서버 실행
다음 명령어로 개발 서버 실행:
<bash>
cd mysite
python3 manage.py runserver
출력 예시:
<plaintext>
Watching for file changes with StatReloader
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
5.3 웹 브라우저 확인
웹 브라우저에서 http://127.0.0.1:8000/ 주소로 접속하면 다음과 같은 기본 Django 페이지가 표시됩니다:
<plaintext>
The install worked successfully! Congratulations!
6. 우분투에서 장고 관리 명령어 사용법
다음은 장고 프로젝트 관리에 자주 사용하는 명령어입니다:
| 명령어 | 설명 |
|---|---|
python3 manage.py runserver | 개발 서버 실행 |
python3 manage.py startapp app_name | 새 애플리케이션 생성 |
python3 manage.py makemigrations | 데이터베이스 마이그레이션 준비 |
python3 manage.py migrate | 마이그레이션 적용 |
python3 manage.py createsuperuser | 관리자 계정 생성 |
python3 manage.py shell | Django 셸 실행 |
7. 장고 설치 문제 해결 및 권장 설정
- 가상환경 활성화 오류:
- 가상환경이 활성화되지 않으면
source venv/bin/activate명령을 다시 실행합니다.
- 가상환경이 활성화되지 않으면
- 패키지 설치 오류:
pip install이 실패하면 다음 명령어로 PIP 업데이트:
<bash>
pip install --upgrade pip3. 포트 충돌:
- 기본 포트(8000) 대신 다른 포트를 사용하려면 다음과 같이 실행합니다:
<bash>
python3 manage.py runserver 80808. 맺음말
이 가이드를 따라 우분투(Ubuntu)에서 Django 설치 및 프로젝트 생성을 완료했습니다. 가상환경 관리, 장고 프로젝트 생성, 서버 실행 등 필수 작업을 수행했으며, 기본 개발 서버에서 웹 애플리케이션 확인까지 마쳤습니다.
다음 단계로는 데이터베이스 설정, 사용자 인증, API 개발 등을 학습하고, **실제 서비스 배포(Production Deployment)**까지 진행할 수 있습니다.
Django의 강력한 기능을 활용해 웹 애플리케이션 개발을 시작해 보세요! 🚀