1️⃣ 프로젝트 개요 및 초기 세팅 문제

1️⃣ 프로젝트 개요 및 초기 세팅 문제

📌 프로젝트 개요

• Django 웹 애플리케이션과 PostgreSQL 데이터베이스를 Docker 컨테이너 환경에서 연동
• 안정적인 개발 및 배포 환경 구축을 목표로 함

📌 Docker와 Django, PostgreSQL 연동

• Docker Compose를 활용해 Django와 PostgreSQL 컨테이너를 함께 관리
• PostgreSQL 데이터베이스는 컨테이너 내부에서 ‘django-postgres’라는 데이터베이스 이름으로 생성
• Django는 PostgreSQL과 연동하도록 settings.py 내 DATABASES 설정 조정

📌 초기 환경 문제 및 해결 과정

• PostgreSQL 버전 불일치로 인한 데이터 디렉토리 호환성 오류 발생
• Docker 볼륨과 이미지 캐시 문제로 인해 정상적인 데이터베이스 컨테이너 구동 실패
• docker volume rm 명령어로 사용 중인 볼륨 강제 삭제 시도 및 이미지 클린 삭제를 통해 문제 해결
• Django 관련 설정에서 환경 변수 누락, DJANGO_SETTINGS_MODULE 미설정 등으로 인한 설정 파일 로드 실패 문제 발견

📌 manage.py, wsgi.py, asgi.py 설정

• Django의 manage.py, wsgi.py, asgi.py 파일 내에 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings.prod') 설정이 필수적임
• 이 설정으로 Django가 어떤 설정 파일을 기준으로 작동할지 명확히 지정
• Docker 컨테이너 환경에서 이 설정이 없으면 기본 settings.py 또는 잘못된 설정을 참조하여 오류 발생 가능

📌 실무 팁

• Docker 컨테이너 내에서 환경 변수 DJANGO_SETTINGS_MODULE이 올바르게 지정되었는지 꼭 확인
• Docker Compose 파일에 environment 항목으로 명시적 환경 변수 설정 추가 권장
• 컨테이너 및 이미지 캐시는 주기적으로 정리하여 빌드 오류 및 충돌 예방