Feature #1266
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1237: [MDGU-04] 인프라·배포 (성용)
[MDGU-04-04] 승인형 CD·마이그레이션 게이트·배포 점검
80%
Description
목적¶
운영 배포는 승인 후에만, 마이그레이션은 별도 승인 게이트로 수행합니다. (가이드 10절 CD)
쉬운 설명¶
승인 버튼을 눌러야만 서버에 배포되는 흐름과, 마이그레이션(DB 구조 변경)을 먼저 확인하는 관문을 만듭니다.
기술 스택¶
GitHub Actions workflow_dispatch, production 환경 승인 규칙, SSH 배포 키(읽기 전용 Deploy Key), 배포 후 smoke test.
예상 결과(산출물)¶
.github/workflows/deploy.yml, 배포·롤백 절차 문서, smoke test 스크립트.
개발 작업 상세¶
- 수동 트리거와 production 환경 승인을 적용한 deploy.yml을 만든다.
- 배포 commit SHA를 고정하고 CI 통과를 확인한 뒤에만 실행되게 한다.
- 서버 접근 키·호스트키를 검증하고 비밀값이 로그에 출력되지 않게 한다.
- migration은 자동 실행하지 않고 별도 승인 단계로 분리한다. 실행 전 DB 백업을 확인한다.
- 배포 후 HTTPS·로그인 차단·핵심 화면 smoke test와 롤백 절차를 문서화한다.
완료 기준¶
- 승인 없이 운영 배포가 실행되지 않는다.
- 롤백 절차가 문서화되었다.
충돌 방지(소유 범위)¶
.github/workflows/deploy.yml과 deploy/는 성용 소유.
선행·후행·위험¶
선행: 04-02 GitHub Actions CI(테스트·린트·마이그레이션 검사)(성용, 11/18 종료) / 04-03 Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정(성용, 11/25 종료)
후행: 04-06 운영 매뉴얼·장애 대응표·배포 인수(성용) / 15-04 인수 체크리스트·운영 인계(최종)(우섭)
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 승인 없이 운영 배포가 실행되지 않는다.
- 롤백 절차가 문서화되었다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
시작 전 준비¶
- 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다.
- 개발 가이드 7~9절을 읽는다.
- 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다.
작업 진행 순서¶
- "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다.
- 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다.
- 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다.
- PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다.
막힐 때 확인¶
서버 접속 키는 GitHub Secrets에만 저장하세요. 배포 실패 시 이전 버전으로 되돌리는 방법을 문서에 적어 두세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 마이그레이션: 모델(코드)의 변경을 DB 구조에 반영하는 변경 기록 파일과 그 적용 작업입니다. makemigrations로 만들고 migrate로 적용합니다.
- CI(지속적 통합): 코드를 올릴 때마다 자동으로 테스트·검사를 돌리는 장치입니다. 여기서는 GitHub Actions를 씁니다.
- CD(자동 배포): 검증된 코드를 서버에 자동으로 반영하는 장치입니다. 이 프로젝트는 사람이 승인해야 배포되게 합니다.
- HTTPS: 주소창의 자물쇠 표시입니다. 통신 내용을 암호화합니다.
- SSH: 원격 서버에 안전하게 접속해 명령을 입력하는 방법입니다.
성양 Updated by 성용 양 19 days ago
- Due date changed from 11/27/2026 to 11/09/2026
- Start date changed from 11/26/2026 to 11/06/2026
- Follows Feature #1264: [MDGU-04-02] GitHub Actions CI(테스트·린트·마이그레이션 검사) added
성양 Updated by 성용 양 19 days ago
- Due date changed from 11/09/2026 to 11/18/2026
- Start date changed from 11/06/2026 to 11/17/2026
- Follows Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종) added
성양 Updated by 성용 양 14 days ago
- Precedes Feature #1268: [MDGU-04-06] 운영 매뉴얼·장애 대응표·배포 인수 added
성양 Updated by 성용 양 8 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 70
2026-11-09 진행 기록 (04-04 승인형 CD)
[한 일]
- GitHub PR #13 스쿼시 머지(main 1ea569e).
- .github/workflows/deploy.yml: 수동 실행(workflow_dispatch), production 환경 승인, 백업 확인 체크 필수, 배포 후 smoke test.
- .github/workflows/migrate.yml: production-migrate 별도 승인, 배포된 SHA 일치와 backup_ref 필수. 배포만으로는 DB가 바뀌지 않음.
- deploy/scripts: verify-sha / remote-deploy / remote-migrate / smoke-test (set -euo pipefail, 비밀값 미출력).
- deploy/tests/test_cd_contracts.py, deploy/README.md(배포·migration·롤백·승인 전 설정), 배포 가이드 10절.
- PR 충돌 정리: 이미 스쿼시 머지된 04-03 커밋을 제외하고 main 위로 리베이스. Windows에서 스크립트 문법 테스트가 WSL 런처를 잡던 문제 수정.
[확인한 것]
- GitHub Actions CI 통과(PostgreSQL 18), 로컬 pytest 46개·ruff 통과.
- 운영 게이트 DEPLOY_ENABLED는 설정하지 않은 상태(닫힘) 유지.
[못 확인한 것]
- 실제 GitHub 환경 승인 흐름과 서버 배포·migration·smoke test 실행(서버 미구축, 04-01 대기).
[남은 일]
- GitHub 관리자: production / production-migrate 환경(Required reviewers, 본인 승인 금지, main 한정), 환경 Secrets·Variables 등록(이름은 deploy/README.md 참고).
- 04-01 서버 준비 후 배포·migration 리허설 1회, 결과 기록.
- 백업 자동화는 04-05(#1267)에서 연결.
성양 Updated by 성용 양 7 days ago
- % Done changed from 70 to 80
[성용] 진행 기록 (2026-11-11)
[한 일]
- 첫 운영 배포를
deploy/scripts/remote-deploy.sh "<main 40자리 SHA>" <배포 경로> compose.cloudsql.yml형식으로 수동 실행(main d419824). - 운영 migration은 백업 생성 후 배포 담당자가 한 번만 적용. 학사 DB 잔여 migration 없음, 개인정보 DB는 아직 업무 모델이 없어 적용하지 않음.
- smoke test 통과: HTTPS /health/ 200·본문, HTTP→HTTPS 301, 로그인 200, 비로그인 /admin/ 302, 정적 파일 200, DB 포트 비노출. dbresting.com·misssbin.mycafe24.com 200.
[운영 원칙 확정]
- 운영 배포와 Cloud SQL migration은 성용만 수행. 팀원은 PR까지만 하고 서버에 접속하지 않음.
- 배포 전후 dbresting-web-1 컨테이너 ID·시작 시각 비교, 일반 배포 때 Nginx·Certbot 재실행 금지.
[남은 일]
- GitHub production / production-migrate 환경 승인 흐름(deploy.yml, migrate.yml)으로 1회 배포 리허설. 지금은 수동 배포만 실행됨.
- 롤백 절차를 Cloud SQL 구성 기준으로 실서버에서 1회 확인.