기술블로그-Django편

📁 Django 프로젝트 다중 폴더 구성과 Git 브랜치 관리 방법

Chansman 2025. 4. 30. 22:24

📁 Django 프로젝트 다중 폴더 구성과 Git 브랜치 관리 방법

✅ 목표

  • 하나의 레포지토리 안에서 여러 개의 Django 프로젝트(chapter_01, chapter_02)를 관리
  • 가상환경은 루트 기준 1개만 사용 (pyenv + poetry)
  • 브랜치 별로 각 챕터 프로젝트를 구분하여 GitHub에 관리

📌 1. 프로젝트 디렉토리 구조 설정

mkdir django-assignment
mv chapter_01/ django-assignment/
mv chapter_02/ django-assignment/
cd django-assignment

최종 구조:

django-assignment/
├── chapter_01/
├── chapter_02/

📌 2. .git 디렉토리 이동으로 Git 루트 변경

기존에 chapter_01/ 폴더가 Git 레포지토리였다면, 아래 명령으로 .git을 루트로 이동:

cd chapter_01
mv .git ../
cd ..

이제 django-assignment/가 Git 루트가 됨.


📌 3. Git 상태 확인 및 파일 추가

git status           # untracked files 확인

git add .            # 전체 파일 스테이지에 추가
git commit -m "✨ 📁 구조 재정리: 루트 디렉토리를 django-assignment로 설정"

📌 4. GitHub에 브랜치 푸시

git push origin chapter_01

📌 5. 새로운 브랜치 생성 및 푸시

git checkout -b chapter_02
# (chapter_02 폴더에 작업 수행 후)
git add .
git commit -m "✨ feat: chapter_02 Django 프로젝트 설정"
git push -u origin chapter_02

✅ 최종 디렉토리 구조

django-assignment/
├── .git/                  # Git 루트
├── pyproject.toml         # Poetry 의존성 파일
├── poetry.lock            # Poetry 잠금 파일
├── .python-version        # pyenv 가상환경 버전 지정
├── chapter_01/
│   ├── manage.py
│   └── config/
├── chapter_02/
    ├── manage.py
    └── config/

✅ 운영 팁

  • PyCharm에서 루트 폴더(django-assignment)를 열고, chapter별로 manage.py 실행하면 충돌 없이 작동
  • 가상환경은 한 번만 설정하면 공유됨 (poetry shell, python manage.py runserver 등)
  • 브랜치 별로 각 프로젝트를 독립적으로 관리 가능

🔹 이제부터는 각 chapter_02 기능 개발을 시작하면 됩니다!