Feature #1264
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1237: [MDGU-04] 인프라·배포 (성용)
[MDGU-04-02] GitHub Actions CI(테스트·린트·마이그레이션 검사)
100%
Description
목적¶
PR마다 자동으로 테스트와 검사를 돌려 서로 다른 사람의 변경이 합쳐질 때 깨지는 것을 일찍 발견합니다.
쉬운 설명¶
코드를 올릴 때마다 자동으로 테스트·코드 검사·마이그레이션 검사를 돌리는 GitHub Actions 설정입니다.
기술 스택¶
GitHub Actions, PostgreSQL 18 서비스 컨테이너, ruff, pytest, makemigrations --check.
예상 결과(산출물)¶
.github/workflows/ci.yml, 실패 시 병합 차단 규칙, 실행 시간 기록.
개발 작업 상세¶
- 워크플로를 만든다: 의존성 설치, ruff, Django
check, PostgreSQL 테스트 DB, pytest,makemigrations --check --dry-run(migration drift). - 운영 데이터·실제 비밀키는 CI에 넣지 않는다(합성 데이터와 테스트용 키만).
- 브랜치 보호 규칙에서 CI 통과를 병합 조건으로 설정한다(저장소 관리자 권한 필요).
- GitHub Actions 무료 사용량·예산 한도를 확인한다(가이드 10절).
완료 기준¶
- PR에서 CI가 자동 실행된다.
- CI가 실패하면 병합할 수 없다.
충돌 방지(소유 범위)¶
.github/는 성용 소유. 01-03에서 우섭이 만든 PR 템플릿과 같은 폴더이므로 파일을 분리(workflows/ 하위만 이 일감에서 수정)합니다.
선행·후행·위험¶
선행: 01-01 저장소·Django 골격·앱 스텁·설정 분리(우섭, 11/06 종료)
후행: 04-04 승인형 CD·마이그레이션 게이트·배포 점검(성용)
위험: 무료 사용량 초과.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- PR에서 CI가 자동 실행된다.
- CI가 실패하면 병합할 수 없다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- PostgreSQL 서비스 컨테이너는 18 버전을 사용한다. 필수 실행 항목: manage.py check, makemigrations --check --dry-run, ruff check, pytest. 개인정보 금지 필드명 점검과 권한 없는 URL 접근 점검 테스트도 추가한다(docs/DEVELOPMENT_STANDARDS.md 15절).
시작 전 준비¶
- 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다.
- 개발 가이드 7~9절을 읽는다.
- 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다.
작업 진행 순서¶
- "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다.
- 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다.
- 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다.
- PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다.
막힐 때 확인¶
Actions가 실패하면 로그의 첫 번째 빨간 줄을 먼저 보세요. 로컬에서 같은 명령을 실행하면 대부분 재현됩니다.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 마이그레이션: 모델(코드)의 변경을 DB 구조에 반영하는 변경 기록 파일과 그 적용 작업입니다. makemigrations로 만들고 migrate로 적용합니다.
- CI(지속적 통합): 코드를 올릴 때마다 자동으로 테스트·검사를 돌리는 장치입니다. 여기서는 GitHub Actions를 씁니다.
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- PR(풀 리퀘스트): 내 브랜치의 변경을 main에 합쳐 달라고 요청하고 리뷰를 받는 절차입니다.
- 합성 데이터: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다.
- Django 템플릿: HTML에 데이터가 들어갈 자리를 표시해 둔 화면 틀입니다. 기본(base) 템플릿을 상속해 공통 메뉴를 재사용합니다.
성양 Updated by 성용 양 19 days ago
- Due date changed from 11/13/2026 to 11/05/2026
- Start date changed from 11/12/2026 to 11/04/2026
- Follows Feature #1249: [MDGU-01-01] 저장소·Django 골격·앱 스텁·설정 분리 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1266: [MDGU-04-04] 승인형 CD·마이그레이션 게이트·배포 점검 added
성양 Updated by 성용 양 8 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 80
진행 상황 최신화 (2026-11-09)
- PR #10 (PostgreSQL 18 CI checks)이 11/7에 main에 병합됨.
- .github/workflows/ci.yml: PostgreSQL 18 서비스, manage.py check, makemigrations --check --dry-run, ruff, migrate, pytest 실행.
- 개인정보 필드명 점검, 권한 없는 URL 점검은 deploy/tests/test_ci_contracts.py(pytest)로 CI에서 실행됨.
- 남은 항목: GitHub 브랜치 보호 규칙 적용 여부 확인(저장소 설정).
성양 Updated by 성용 양 8 days ago
2026-11-09 진행 기록: PR #17 머지 (머지된 마이그레이션 보호)
[한 일]
- GitHub PR #17 스쿼시 머지(main d60b039): deploy/tests/test_migration_contracts.py 추가. main에 이미 머지된 마이그레이션 파일의 수정·삭제·이름 변경을 CI에서 실패 처리(공통 개발 기준 5절 2항). 새 마이그레이션 추가는 막지 않음.
- ci.yml: checkout fetch-depth 0, 테스트에 비교 기준(MIGRATION_BASE_REF)과 기준 필수(REQUIRE_MIGRATION_BASE) 전달.
- 검토 결과 순서 계약표·DB 경계 검사는 추가하지 않음: 지원자→학생 순서는 Django FK 검사가 이미 막고, 개인정보 DB 라우터 검증은 02-02(#1254) 범위.
[확인한 것]
- GitHub CI 통과(기준 브랜치 비교 동작). 임시 복제본에서 수정·삭제·이름 변경은 실패, 새 마이그레이션 추가는 통과 확인. main에서 pytest 54개 통과.
[못 확인한 것]
- 없음.
[남은 일]
- main 브랜치 보호(checks 통과 필수 등)는 저장소 관리자 작업. 팀은 당분간 CI 통과 후 머지로 운영.
성양 Updated by 성용 양 6 days ago
- % Done changed from 80 to 90
[성용] 진행 기록 (2026-11-11) — CI 구현·실행 검증 완료 / 운영 정책 일부 확인 필요
[한 일]
- PR CI(checks) 운영 중. PR #30·#31·#32 CI 통과 확인
- 로컬 PostgreSQL 테스트 역할의 CREATEDB 권한 누락으로 테스트 DB가 만들어지지 않던 문제 해결(README·팀원 가이드 정정, PR #28)
- 로컬 테스트 222개 통과,
pip check·Django check·migration check·Ruff 통과
[남은 것]
- main 브랜치 보호·필수 검사(required checks) 정책의 실제 적용 여부 확인
성양 Updated by 성용 양 6 days ago
- Status changed from In Progress to Resolved
- % Done changed from 90 to 100
[성용] 완료 기록 (2026-11-11)
- 남은 항목이던 브랜치 보호·필수 검사 확인: 저장소가 비공개 무료 요금제라 GitHub 브랜치 보호·CODEOWNERS를 쓸 수 없음을 확인(main 보호 설정 없음). PR #43(https://github.com/GilbertMoon/university-academic-system/pull/43)으로 팀 규칙(CI 통과 + 지정 리뷰어 승인 + PR 템플릿 [로컬 검증], 병합은 성용)으로 대신 운영하기로 개발 기준에 반영
- PR #38 병합(https://github.com/GilbertMoon/university-academic-system/pull/38): pii 테스트 DB를 쓰는 테스트가 먼저 돌면 실패하던
test_db_router검사를 실행 순서와 무관하게 수정(CI 실패 재발 방지) - PR CI(checks)·GitGuardian은 #33~#43 모두 통과 상태로 운영 중