Docker로 Django, PostgreSQL, Redis를 활용한 풀스택 개발 환경 구축 가이드

핵심 기술

이 튜토리얼은 Docker를 활용하여 Django, PostgreSQL, Redis를 포함한 완전한 백엔드 개발 환경을 로컬에 신속하게 설정하는 방법을 안내합니다. 이를 통해 프로덕션 환경과 유사한 개발 환경을 구축하고, '내 컴퓨터에서는 잘 돌아간다'는 문제를 해결할 수 있습니다.

기술적 세부사항

• Docker 기반 설정: docker-compose.yml 파일을 통해 데이터베이스(PostgreSQL), 캐싱/메시지 큐(Redis), Django 애플리케이션을 하나의 명령으로 통합 관리합니다.
• PostgreSQL: 프로덕션 등급의 데이터 저장소로 사용되며, postgres:15 이미지를 활용합니다.
• Redis: 캐싱 및 백그라운드 작업 처리를 위해 redis:7-alpine 이미지를 사용합니다.
• Django 프로젝트: Dockerfile을 통해 Python 3.11 환경을 설정하고, 필요한 라이브러리(requirements.txt 포함)를 설치하여 Django 프로젝트를 빌드합니다.
• 개발 도구: VS Code 설정을 포함하며, 디버깅을 지원합니다.
• 환경 구성: .env 파일을 통해 보안 키, 디버그 모드, 데이터베이스 및 Redis 연결 URL을 관리합니다.
• 애플리케이션 생성: docker-compose run web 명령을 사용하여 Django 관리자 명령으로 프로젝트와 여러 앱(accounts, posts, connections 등)을 생성합니다.
• 설정 파일 수정: core/settings.py에서 SECRET_KEY, DEBUG, DATABASE_URL, REDIS_URL, INSTALLED_APPS, MIDDLEWARE, CHANNEL_LAYERS 등을 환경 변수 및 Docker Compose 서비스 이름에 맞게 설정합니다.
• 헬스 체크: core/health_check.py를 생성하고 core/urls.py에 등록하여 Django, DB, Redis 서비스 상태를 확인할 수 있는 엔드포인트를 제공합니다.
• 수동 설정 옵션: Docker를 사용하지 않는 경우를 위한 macOS(Homebrew) 및 Ubuntu/Debian 기반 Linux 시스템의 Python, PostgreSQL, Redis 설치 및 설정 방법을 제공합니다.
• 애플리케이션 실행: docker-compose up 또는 python manage.py runserver 명령으로 개발 서버를 실행합니다.
• Verification: docker-compose exec web python manage.py shell 명령을 통해 DB 및 Redis 연결 상태를 확인합니다.

개발 임팩트

• 환경 일관성: Docker를 통해 개발, 스테이징, 프로덕션 환경 간의 불일치를 제거하여 '내 컴퓨터에서는 되는데...' 문제를 방지합니다.
• 빠른 개발 환경 구축: 단 몇 분 안에 복잡한 서비스 스택을 포함한 개발 환경을 설정할 수 있어 개발 생산성이 향상됩니다.
• 확장성: Redis와 PostgreSQL을 활용하여 고성능 및 확장 가능한 애플리케이션 개발의 기반을 마련합니다.
• 초보자 친화적: Docker 초심자도 쉽게 따라 할 수 있도록 단계별 가이드와 명확한 설정 예시를 제공합니다.