Project

General

Profile

Actions

Feature #1264

open
성양 성양

Feature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)

Feature #1237: [MDGU-04] 인프라·배포 (성용)

[MDGU-04-02] GitHub Actions CI(테스트·린트·마이그레이션 검사)

Feature #1264: [MDGU-04-02] GitHub Actions CI(테스트·린트·마이그레이션 검사)

Added by 성용 양 19 days ago. Updated 6 days ago.

Status:
Resolved
Priority:
Normal
Assignee:
Start date:
11/17/2026
Due date:
11/18/2026 (Due in 1 day)
% Done:

100%

Estimated time:

Description

목적

PR마다 자동으로 테스트와 검사를 돌려 서로 다른 사람의 변경이 합쳐질 때 깨지는 것을 일찍 발견합니다.

쉬운 설명

코드를 올릴 때마다 자동으로 테스트·코드 검사·마이그레이션 검사를 돌리는 GitHub Actions 설정입니다.

기술 스택

GitHub Actions, PostgreSQL 18 서비스 컨테이너, ruff, pytest, makemigrations --check.

예상 결과(산출물)

.github/workflows/ci.yml, 실패 시 병합 차단 규칙, 실행 시간 기록.

개발 작업 상세

  1. 워크플로를 만든다: 의존성 설치, ruff, Django check, PostgreSQL 테스트 DB, pytest, makemigrations --check --dry-run(migration drift).
  2. 운영 데이터·실제 비밀키는 CI에 넣지 않는다(합성 데이터와 테스트용 키만).
  3. 브랜치 보호 규칙에서 CI 통과를 병합 조건으로 설정한다(저장소 관리자 권한 필요).
  4. GitHub Actions 무료 사용량·예산 한도를 확인한다(가이드 10절).

완료 기준

  • PR에서 CI가 자동 실행된다.
  • CI가 실패하면 병합할 수 없다.

충돌 방지(소유 범위)

.github/는 성용 소유. 01-03에서 우섭이 만든 PR 템플릿과 같은 폴더이므로 파일을 분리(workflows/ 하위만 이 일감에서 수정)합니다.

선행·후행·위험

선행: 01-01 저장소·Django 골격·앱 스텁·설정 분리(우섭, 11/06 종료)

후행: 04-04 승인형 CD·마이그레이션 게이트·배포 점검(성용)

위험: 무료 사용량 초과.

결과 확인 방법

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

  1. PR에서 CI가 자동 실행된다.
  2. CI가 실패하면 병합할 수 없다.
  3. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.

갱신 사항 (2026-11-04)

  • PostgreSQL 서비스 컨테이너는 18 버전을 사용한다. 필수 실행 항목: manage.py check, makemigrations --check --dry-run, ruff check, pytest. 개인정보 금지 필드명 점검과 권한 없는 URL 접근 점검 테스트도 추가한다(docs/DEVELOPMENT_STANDARDS.md 15절).

시작 전 준비

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

작업 진행 순서

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

막힐 때 확인

Actions가 실패하면 로그의 첫 번째 빨간 줄을 먼저 보세요. 로컬에서 같은 명령을 실행하면 대부분 재현됩니다.

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

용어 풀이

  • 마이그레이션: 모델(코드)의 변경을 DB 구조에 반영하는 변경 기록 파일과 그 적용 작업입니다. makemigrations로 만들고 migrate로 적용합니다.
  • CI(지속적 통합): 코드를 올릴 때마다 자동으로 테스트·검사를 돌리는 장치입니다. 여기서는 GitHub Actions를 씁니다.
  • pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
  • PR(풀 리퀘스트): 내 브랜치의 변경을 main에 합쳐 달라고 요청하고 리뷰를 받는 절차입니다.
  • 합성 데이터: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다.
  • Django 템플릿: HTML에 데이터가 들어갈 자리를 표시해 둔 화면 틀입니다. 기본(base) 템플릿을 상속해 공통 메뉴를 재사용합니다.

Related issues 2 (1 open — 1 closed)

Follows Feature #1249: [MDGU-01-01] 저장소·Django 골격·앱 스텁·설정 분리Closed서현 임11/05/202611/06/2026

Actions
Precedes Feature #1266: [MDGU-04-04] 승인형 CD·마이그레이션 게이트·배포 점검In Progress성용 양12/01/202612/02/2026

Actions

성양 Updated by 성용 양 19 days ago Actions #1

  • 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 Actions #2

  • Precedes Feature #1266: [MDGU-04-04] 승인형 CD·마이그레이션 게이트·배포 점검 added

성양 Updated by 성용 양 19 days ago Actions #3

  • Due date changed from 11/05/2026 to 11/13/2026
  • Start date changed from 11/04/2026 to 11/12/2026

성양 Updated by 성용 양 14 days ago Actions #4

  • Assignee changed from 서현 임 to 성용 양

성양 Updated by 성용 양 14 days ago Actions #5

  • Due date changed from 11/13/2026 to 11/10/2026
  • Start date changed from 11/12/2026 to 11/09/2026

성양 Updated by 성용 양 14 days ago Actions #6

  • Due date changed from 11/10/2026 to 11/18/2026
  • Start date changed from 11/09/2026 to 11/17/2026

성양 Updated by 성용 양 14 days ago Actions #7

  • Description updated (diff)

설명 보강: 쉬운 설명, 확인 방법, 시작 전 준비, 작업 순서, 막힐 때, 용어 풀이 추가. 담당자·날짜·선행 관계 최신화

성양 Updated by 성용 양 14 days ago Actions #8

  • Description updated (diff)

검수 반영: 선행 관계·일정·담당 최신화, 결과 확인 방법을 완료 기준 기준으로 정리

성양 Updated by 성용 양 13 days ago Actions #9

  • Description updated (diff)

2026-11-04 일괄 갱신: PostgreSQL 18 확정, 로컬 환경 안내, ERD 검수·확정 사항 반영. 자세한 내용은 설명의 갱신 사항 참조.

성양 Updated by 성용 양 8 days ago Actions #10

  • 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 Actions #11

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 Actions #12

  • % 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 Actions #13

  • 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 모두 통과 상태로 운영 중
Actions

Also available in: PDF Atom