API Server django python Framework 설치 #1

Django는 Python 기반의 웹 프레임워크로, 강력한 기능과 간결한 코드로 웹 애플리케이션을 빠르게 개발할 수 있다.

이번 글에서는 Django를 활용한 API 서버 구축 과정을 단계별로 정리해본다.

 

📌 사용할 API

• 공공데이터 포털에서 제공하는 국회도서관 자료검색 서비스 API

 

📌 작업 환경

• 작업 폴더명: public_data
• 가상환경명: pubd_api
• 프로젝트명: pubdapi
• OS: macOS Sonoma v14.5

1. Python & Django 설치하기

 

Django를 설치하기 위해서는 먼저 Python이 필요하다.

Django 공식 문서를 참고하면 보다 자세한 내용을 확인할 수 있다.

 

🔗 Django 공식 문서: Django Documentation (한글)

 

📌 Python 설치

 

Python은 공식 사이트에서 다운로드하여 설치할 수 있다.

이번 글에서는 Python 3.12.2 버전을 사용한다.

 

🔗 Python 다운로드(mac OS): Python 공식 사이트

파이썬 버전 별 다운로드

설치가 완료되면, 터미널에서 Python 버전을 확인한다.

python3 --version

 

✅ 실행 결과

public_data % python3 --version
Python 3.12.2

 

2. 가상환경(Virtual Environment) 설정

 

Django는 **가상환경(venv)**을 활용하여 독립적인 환경에서 실행하는 것이 좋다.

이를 통해 다른 프로젝트와의 라이브러리 충돌을 방지할 수 있다.

 

📌 가상환경 생성 및 활성화

 

1️⃣ 작업 폴더(public_data)로 이동 후, 가상환경 생성

cd public_data
python3 -m venv pubd_api

 

2️⃣ 가상환경 활성화

cd pubd_api
source bin/activate

 

✅ 정상적으로 활성화되면 프롬프트 앞에 (pubd_api)가 표시된다.

(pubd_api) bin %

 

3️⃣ 가상환경 비활성화 (원할 경우)

deactivate

 

3. Django 설치

 

가상환경이 활성화된 상태에서 Django 5.0.6 버전을 설치한다.

pip install django==5.0.6

 

설치가 완료되면 Django 버전 확인

python3 -m django --version

 

✅ 실행 결과

5.0.6

 

📌 추가 작업

설치 후 아래와 같은 메시지가 보이면 pip 업그레이드를 진행한다.

[notice] To update, run: pip install --upgrade pip

 

업그레이드 실행

pip install --upgrade pip

 

4. Django 프로젝트 생성

 

이제 Django 프로젝트를 생성한다.

 

📌 프로젝트 생성하기

 

1️⃣ 가상환경 폴더(pubd_api)에서 Django 프로젝트 생성

django-admin startproject pubdapi

 

2️⃣ 프로젝트 폴더 확인

ls

 

✅ 실행 결과

bin    include    lib    pubdapi    pyvenv.cfg

pubdapi 폴더가 생성된 것을 확인할 수 있다.

 

3️⃣ 프로젝트 내부 폴더 구조 확인

cd pubdapi
ls

 

✅ 실행 결과

manage.py    pubdapi/

 

5. 개발 서버 실행 및 확인

 

Django 프로젝트가 정상적으로 생성되었는지 확인하기 위해 개발 서버를 실행해 본다.

 

📌 개발 서버 실행

python3 manage.py runserver

 

✅ 실행 결과

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

Django version 5.0.6, using settings 'pubdapi.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

 

📌 브라우저에서 확인

• 웹 브라우저를 열고 http://127.0.0.1:8000/로 접속한다.

• Django의 기본 페이지가 보이면 설치가 정상적으로 완료.

django 설치 완료 화면

6. 마무리

 

이번 글에서는 Python 및 Django 설치부터 가상환경 설정 그리고 Django 프로젝트 생성 및 실행까지 진행했다.

 

✅ 최종 확인

• Python 버전: python3 --version → 3.12.2
• Django 버전: python3 -m django --version → 5.0.6
• 개발 서버 실행 후 정상 동작 확인

 

📌 다음 글에서는?

다음 글에서는 Django 앱(App) 생성 및 Git을 이용한 프로젝트 관리 방법을 알아본다. 🚀

 

👉 [다음 글] Django 앱 생성하고 소스에 Git 설정하기