Feature #1268
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1237: [MDGU-04] 인프라·배포 (성용)
[MDGU-04-06] 운영 매뉴얼·장애 대응표·배포 인수
80%
Description
목적¶
운영 담당자가 서버·배포·복구를 직접 할 수 있도록 매뉴얼을 만들고 인수합니다. (가이드 12·13절)
쉬운 설명¶
운영 담당자가 문서만 보고 서버를 관리할 수 있도록 운영 매뉴얼과 장애 대응표를 만들고 배포를 인수합니다.
기술 스택¶
Markdown 문서, 가이드 12절 장애 진단표, 체크리스트.
예상 결과(산출물)¶
docs/ops/ 운영 매뉴얼, 장애 진단표, 가이드 13절 체크리스트 점검 결과.
개발 작업 상세¶
- 접속·배포·롤백·백업·복원·인증서 갱신 절차를 단계별로 쓴다.
- 장애 증상별 점검표(DNS, 502, 400/403, DB 연결, PDF 글꼴, 권한 누출)를 정리한다.
- 가이드 13절 완료 체크리스트를 실제 상태로 점검한다.
- 민감 정보(계정, 키, IP)는 문서에 적지 않는다.
완료 기준¶
- 체크리스트 항목별 상태가 기록되었다.
- 담당자 교육 자료가 준비되었다.
충돌 방지(소유 범위)¶
docs/ops/는 성용 소유.
선행·후행·위험¶
선행: 04-04 승인형 CD·마이그레이션 게이트·배포 점검(성용, 12/02 종료) / 04-05 암호화 백업·복원 훈련(성용, 12/28 종료)
후행: 15-04 인수 체크리스트·운영 인계(최종)(우섭)
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 체크리스트 항목별 상태가 기록되었다.
- 담당자 교육 자료가 준비되었다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
시작 전 준비¶
- 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다.
- 개발 가이드 7~9절을 읽는다.
- 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다.
작업 진행 순서¶
- "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다.
- 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다.
- 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다.
- PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다.
막힐 때 확인¶
실제 장애 상황을 가정해 담당자가 따라 해 보며 빠진 단계를 보완하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- DNS: 도메인 이름(예: example.com)을 서버 IP 주소로 연결해 주는 전화번호부 같은 서비스입니다.
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종) added
성양 Updated by 성용 양 19 days ago
- Precedes deleted (Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종))
성양 Updated by 성용 양 14 days ago
- Due date changed from 12/29/2026 to 11/26/2026
- Start date changed from 12/25/2026 to 11/24/2026
- Follows Feature #1266: [MDGU-04-04] 승인형 CD·마이그레이션 게이트·배포 점검 added
성양 Updated by 성용 양 14 days ago
- Follows Feature #1267: [MDGU-04-05] 암호화 백업·복원 훈련 added
성양 Updated by 성용 양 14 days ago
- Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종) added
성양 Updated by 성용 양 7 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 60
[성용] 진행 기록 (2026-11-11)
[한 일]
- PR #18 병합(main 02abe9a, 2026-11-10):
deploy/OPERATIONS.md운영 매뉴얼(정기 점검, 배포·migration·롤백 판단, DB 복구, 비밀값 교체, 장애 등급·증상별 대응, 스크립트 오류 문구별 조치, 인수 체크리스트), compose 로그 순환, restore.sh 암호 있는 개인키 지원. - 팀원용 문서
docs/TEAM_LOCAL_DEV_AND_PR.md(PR #26): 팀원은 로컬 PostgreSQL만 사용, PR 작성·검증 결과 양식, 운영 비밀값 커밋 금지.
[남은 일]
- OPERATIONS.md가 DB 컨테이너(compose.prod.yml) 기준으로 쓰여 있음. 운영은 Cloud SQL(compose.cloudsql.yml)이므로 시스템 구성도, DB 복구, 백업, 비밀값 교체 절을 갱신해야 함.
- 실서버 리허설(배포·롤백·장애 대응) 결과 기록, 역할 지정과 담당자 교육 자료.
성양 Updated by 성용 양 7 days ago
[성용] 진행 기록 (2026-11-11)
PR #27 생성(리뷰 대기): https://github.com/GilbertMoon/university-academic-system/pull/27
- deploy/OPERATIONS.md를 Cloud SQL 운영 기준(compose.cloudsql.yml)으로 개정: 구성도·위치·포트(8002)·비밀값, 역할(배포·migration은 배포 담당만), 수동 배포 절차와 다른 사이트 영향 확인, 임시 백업 방식·복호화·재검증, backup.sh direct 모드 전환 조건, Cloud SQL 기준 DB 복구·비밀번호 교체·장애 대응, 인수 체크리스트·미정 항목 갱신.
- deploy/README.md: 운영 구성 표시, 해결된 남은 항목 정리.
- deploy 테스트 44개·ruff 통과, 비밀값·IP·DB 호스트 미포함.
남은 일: PR 리뷰·병합, 4.4절 복구의 실서버 훈련(#1267), Cloud SQL 자동 백업·PITR 확인, 롤백·비밀값 교체·장애 대응 리허설, 역할 지정과 인수.
성양 Updated by 성용 양 7 days ago
[성용] PR #27 병합 (2026-11-11)
- https://github.com/GilbertMoon/university-academic-system/pull/27 스쿼시 병합, main 5ba9eb5
- CI(checks)·GitGuardian 통과. 문서만 변경(deploy/OPERATIONS.md, deploy/README.md), 애플리케이션 코드·migration 변경 없음 → 운영 재배포 불필요
- 운영 매뉴얼이 Cloud SQL 운영 기준으로 갱신됨
남은 일: 4.4절 실제 복원 훈련(#1267), Cloud SQL 자동 백업·PITR 확인, 롤백·비밀값 교체·장애 대응 리허설, 역할 지정과 인수
성양 Updated by 성용 양 6 days ago
- % Done changed from 60 to 80
[성용] 진행 기록 (2026-11-11) — 백업 운영 문서 작성 완료 / 정식 인수 대기
[한 일]
- PR #30 병합:
deploy/backup/HANDOVER.md신규. 개발 단계·정식 운영 단계 백업 정책 분리, 생성·암호화·저장소 전송 기능 분리 원칙, 외부 저장소 교체 절차, 대학 인계 체크리스트(백업 책임자·개인키 관리자·RPO/RTO·보존 정책).deploy/backup/README.md·deploy/OPERATIONS.md에서 연결 - PR #31 병합: 인계 체크리스트의 구현 완료·미완료 항목 구분 수정
- PR #32 병합: 운영 매뉴얼(4.1.1절·비밀값 표·장애 대응표·인수 체크리스트·7절),
deploy/README.md,deploy/backup/README.md, 개발·배포 가이드를backup.shdirect모드 자동 백업 기준으로 정합화. 과거 임시 수동 백업은 보존용으로 구분. Cloud SQL 전용 자동 실행기 경로 기록 - 세 PR 모두 CI(checks)·GitGuardian 통과
[남은 것]
- 스테이징 복원 검증 결과 반영(#1267)
- 실서버 리허설(롤백·비밀값 교체·장애 대응)
- 대학 운영·백업 책임자와 장애 대응 승인 절차 확정
- 정식 운영 인수 검증
성양 Updated by 성용 양 5 days ago
[성용] 진행 기록 (2026-11-12)
- PR #46 병합(main 3e95427): https://github.com/GilbertMoon/university-academic-system/pull/46
- Django Admin은 시스템 관리자 전용 규정 설정으로 쓰고, Admin 변경 기록(LogEntry)은 임시 이력이며 정식 감사는 #1257 감사 로그로 한다는 문서 정리
- #1257(PR #51) 병합으로 감사 로그 운영 메모(docs/security/audit-log.md) 추가
- 정식 인수는 아직 대기. 진척도 그대로