Project

General

Profile

Feature #1268

Updated by 성용 양 14 days ago

## 목적 

 운영 담당자가 서버·배포·복구를 직접 할 수 있도록 매뉴얼을 만들고 인수합니다. (가이드 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 12/25 종료) 

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

 ## 결과 확인 방법 

 "완료 기준"의 각 항목을 화면 또는 명령으로 점검표(DNS·502·400/403·DB 연결 등)대로 따라 해 문제를 찾아낼 수 있고, 운영 담당자가 배포·롤백을 한 번 직접 확인합니다. 

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

 ## 시작 전 준비 

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

 ## 작업 진행 순서 

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

 ## 막힐 때 확인 

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

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

 ## 용어 풀이 

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

Back