Project

General

Profile

Actions

Feature #1268

open
성양 성양

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

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

[MDGU-04-06] 운영 매뉴얼·장애 대응표·배포 인수

Feature #1268: [MDGU-04-06] 운영 매뉴얼·장애 대응표·배포 인수

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

Status:
In Progress
Priority:
Normal
Assignee:
Start date:
12/29/2026
Due date:
12/31/2026 (Due in 44 days)
% Done:

80%

Estimated time:

Description

목적

운영 담당자가 서버·배포·복구를 직접 할 수 있도록 매뉴얼을 만들고 인수합니다. (가이드 12·13절)

쉬운 설명

운영 담당자가 문서만 보고 서버를 관리할 수 있도록 운영 매뉴얼과 장애 대응표를 만들고 배포를 인수합니다.

기술 스택

Markdown 문서, 가이드 12절 장애 진단표, 체크리스트.

예상 결과(산출물)

docs/ops/ 운영 매뉴얼, 장애 진단표, 가이드 13절 체크리스트 점검 결과.

개발 작업 상세

  1. 접속·배포·롤백·백업·복원·인증서 갱신 절차를 단계별로 쓴다.
  2. 장애 증상별 점검표(DNS, 502, 400/403, DB 연결, PDF 글꼴, 권한 누출)를 정리한다.
  3. 가이드 13절 완료 체크리스트를 실제 상태로 점검한다.
  4. 민감 정보(계정, 키, IP)는 문서에 적지 않는다.

완료 기준

  • 체크리스트 항목별 상태가 기록되었다.
  • 담당자 교육 자료가 준비되었다.

충돌 방지(소유 범위)

docs/ops/는 성용 소유.

선행·후행·위험

선행: 04-04 승인형 CD·마이그레이션 게이트·배포 점검(성용, 12/02 종료) / 04-05 암호화 백업·복원 훈련(성용, 12/28 종료)

후행: 15-04 인수 체크리스트·운영 인계(최종)(우섭)

결과 확인 방법

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

  1. 체크리스트 항목별 상태가 기록되었다.
  2. 담당자 교육 자료가 준비되었다.
  3. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.

시작 전 준비

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

작업 진행 순서

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

막힐 때 확인

실제 장애 상황을 가정해 담당자가 따라 해 보며 빠진 단계를 보완하세요.

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

용어 풀이

  • DNS: 도메인 이름(예: example.com)을 서버 IP 주소로 연결해 주는 전화번호부 같은 서비스입니다.

Related issues 3 (3 open — 0 closed)

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

Actions
Follows Feature #1267: [MDGU-04-05] 암호화 백업·복원 훈련In Progress성용 양12/24/202612/28/2026

Actions
Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종)New우섭 심01/05/202701/06/2027

Actions

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

  • Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종) added

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

  • Precedes deleted (Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종))

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

  • Assignee changed from 서현 임 to 성용 양

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

  • Due date changed from 12/24/2026 to 12/29/2026
  • Start date changed from 12/22/2026 to 12/25/2026

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

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

  • Follows Feature #1267: [MDGU-04-05] 암호화 백업·복원 훈련 added

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

  • Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종) added

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

  • Due date changed from 11/26/2026 to 12/02/2026
  • Start date changed from 11/24/2026 to 11/30/2026

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

  • Due date changed from 12/02/2026 to 12/07/2026
  • Start date changed from 11/30/2026 to 12/03/2026

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

  • Due date changed from 12/07/2026 to 12/30/2026
  • Start date changed from 12/03/2026 to 12/28/2026

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

  • Description updated (diff)

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

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

  • Due date changed from 12/30/2026 to 12/31/2026
  • Start date changed from 12/28/2026 to 12/29/2026

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

  • Description updated (diff)

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

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

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

[성용] 진행 기록 (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 Actions #16

[성용] 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 Actions #17

  • % 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.sh direct 모드 자동 백업 기준으로 정합화. 과거 임시 수동 백업은 보존용으로 구분. Cloud SQL 전용 자동 실행기 경로 기록
  • 세 PR 모두 CI(checks)·GitGuardian 통과

[남은 것]

  • 스테이징 복원 검증 결과 반영(#1267)
  • 실서버 리허설(롤백·비밀값 교체·장애 대응)
  • 대학 운영·백업 책임자와 장애 대응 승인 절차 확정
  • 정식 운영 인수 검증

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

[성용] 진행 기록 (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) 추가
  • 정식 인수는 아직 대기. 진척도 그대로
Actions

Also available in: PDF Atom