Project

General

Profile

Feature #1265

Updated by 성용 양 14 days ago

## 목적 

 서버에서 Docker Compose로 앱과 DB를 올리고 Nginx에서 연결합니다. 운영 설정(DEBUG=False, 보안 쿠키 등)도 여기서 맞춥니다. (가이드 7~9절) 

 ## 쉬운 설명 

 앱과 DB를 Docker Compose로 묶어 서버에서 실행하고 Nginx와 연결하며 운영용 설정(DEBUG 끄기, 보안 쿠키 등)을 맞춥니다. 

 ## 기술 스택 

 Docker, Docker Compose, Python 3.12 이미지, WeasyPrint 네이티브 라이브러리와 한글·영문·중문 폰트, Gunicorn(127.0.0.1:8000), Nginx, Django production settings. 

 ## 예상 결과(산출물) 

 Dockerfile, compose.prod.yml, .env.example, /health/ 엔드포인트, settings/production.py, Nginx 설정. 

 ## 개발 작업 상세 

 1. Dockerfile: Python 고정 버전, WeasyPrint 의존 라이브러리·폰트, non-root 사용자, Gunicorn. 
 2. compose.prod.yml: web과 PostgreSQL db, healthcheck, 영속 볼륨, 내부 네트워크. DB 5432 host publish 금지, Gunicorn은 127.0.0.1 바인딩. 
 3. settings/production.py: DEBUG=False, ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS, secure cookies, 보안 헤더. 
 4. /health/ 비민감 엔드포인트(config/urls.py 한 줄은 우섭에게 요청). 
 5. Nginx를 Gunicorn에 연결하고 HTTPS·리디렉션 유지, 정적 파일만 공개하고 보호 파일은 공개 alias 금지. 
 6. 로컬 Docker에서 build·up·ps·`check --deploy`·`migrate --plan`을 확인한다(실제 운영 migrate는 승인 후). 

 ## 완료 기준 

 - 컨테이너가 healthy 상태로 올라온다. 
 - `manage.py check --deploy` 경고가 없거나 기록되어 있다. 
 - DB 포트가 외부에 노출되지 않는다. 

 ## 충돌 방지(소유 범위) 

 Dockerfile, compose*.yml, nginx/, deploy/, config/settings/production.py는 성용 소유(예외적으로 config 하위 production.py만 성용). 다른 settings 파일은 우섭 소유입니다. 

 ## 선행·후행·위험 

 선행: 00-02 DB 분리 수준 확정(김예주, 11/13 종료) / 04-01 VPS 생성·SSH·방화벽·DNS·Nginx 임시 페이지·HTTPS(성용, 11/13 종료) 

 후행: 04-04 승인형 CD·마이그레이션 게이트·배포 점검(성용) / 04-05 암호화 백업·복원 훈련(성용) / 11-01 증명서 PDF 기반(WeasyPrint·3개 국어 폰트·템플릿 엔진)(서현) / 14-03 이관 리허설·정합성 보고서(서현) / 15-02 UAT 환경 준비·대학 담당자 교육(서현) 

 위험: WeasyPrint 폰트·라이브러리 의존성은 Docker에서 먼저 검증. 

 ## 결과 확인 방법 

 "완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다. 

 1. 로컬에서 docker compose로 컨테이너가 healthy 상태로 올라온다. 
 2. `manage.py healthy가 되고 /health/가 응답하며 manage.py check --deploy` --deploy 경고가 없거나 기록되어 있다. 
 3. DB 포트가 외부에 노출되지 않는다. 
 4. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다. 기록되면 완료입니다. 

 ## 시작 전 준비 

 1. 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다. 
 2. 개발 가이드 7~9절을 읽는다. 
 3. 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다. 

 ## 작업 진행 순서 

 1. "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다. 
 2. 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다. 
 3. 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다. 
 4. PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다. 

 ## 막힐 때 확인 

 컨테이너가 계속 재시작되면 docker compose logs 서비스명으로 오류를 보세요. DB 포트는 외부에 열지 마세요. 

 그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요. 

 ## 용어 풀이 

 - **마이그레이션**: 모델(코드)의 변경을 DB 구조에 반영하는 변경 기록 파일과 그 적용 작업입니다. makemigrations로 만들고 migrate로 적용합니다. 
 - **WeasyPrint**: HTML과 CSS로 만든 문서를 PDF로 바꿔 주는 Python 도구입니다. 증명서 PDF를 만드는 데 사용합니다. 
 - **Docker·Docker Compose**: 프로그램과 실행 환경을 한 상자(컨테이너)로 묶어 어디서나 같은 방식으로 실행하게 해 주는 도구이고, Compose는 여러 상자(앱·DB)를 한꺼번에 켜고 끄게 해 줍니다. 
 - **Gunicorn**: Django 앱을 실제 서버에서 실행해 주는 프로그램입니다. 
 - **Nginx**: 웹 요청을 받아 앱(Gunicorn)이나 정적 파일로 전달하고 HTTPS를 처리하는 웹 서버입니다. 
 - **HTTPS**: 주소창의 자물쇠 표시입니다. 통신 내용을 암호화합니다. 
 - **/health/**: 서버가 살아 있는지 확인하는 간단한 주소입니다. 이 주소가 정상 응답하면 앱이 실행 중이라고 봅니다. 
 - **CSRF**: 다른 사이트가 사용자 몰래 요청을 보내는 공격입니다. Django 기본 토큰으로 막습니다.

Back