운영 Runbook 생성기

운영 Runbook 생성기 사용 가이드

배포, 인증서 교체, 장애 대응처럼 가끔 하는 운영 작업은 할 때마다 순서를 헷갈리기 쉽습니다. Runbook은 그 절차를 누구나 따라 할 수 있게 적어 둔 문서이고, 이 생성기는 몇 줄의 메모를 표준 구성의 Runbook으로 만들어 줍니다.

'절차: npm run build'처럼 같은 절 이름으로 여러 줄을 적으면 순서대로 번호가 붙은 단계가 되고, 롤백도 번호 목록으로 정리합니다. 사전 조건·확인·연락처는 글머리 목록이 됩니다. Prerequisites·Procedure·Verify·Rollback 같은 영어 절 이름도 알아봅니다.

머리에는 문서 번호와 마지막 점검일이 들어가고, 비어 있는 절에는 '실패했을 때 되돌리는 방법을 적으세요' 같은 안내가 남습니다.

사용 방법

1. 1'작업 이름'과 '문서 번호'를 적습니다.
2. 2'내용' 칸에 '사전 조건: …', '절차: …'(여러 줄), '확인: …', '롤백: …'을 순서대로 적습니다.
3. 3'실행' 후 결과를 위키나 저장소의 runbooks/ 폴더에 저장하고, 실제로 한 번 따라 해 보며 다듬습니다.

작업 이름: Cloudflare 배포
문서 번호: RUN-021
내용:
사전 조건: wrangler 로그인
절차: npm run build
절차: npx wrangler pages deploy public
확인: 사이트를 열어 버전 확인
롤백: 이전 배포를 다시 승격

# Cloudflare 배포 Runbook

- 문서 번호: RUN-021
- 마지막 점검: 2026-10-01

## 목적

<!-- 이 절차가 언제, 왜 필요한지 적으세요 -->

## 사전 조건

- wrangler 로그인

## 절차

1. npm run build
2. npx wrangler pages deploy public

## 확인

- 사이트를 열어 버전 확인

## 롤백

1. 이전 배포를 다시 승격

## 연락처

<!-- 막혔을 때 연락할 사람과 채널을 적으세요 -->

이럴 때 쓰면 좋아요

• 배포 절차를 담당자가 바뀌어도 따라 하게 정리할 때
• 장애 대응 순서를 미리 문서로 만들 때
• 인증서·비밀번호 교체처럼 드문 작업을 기록할 때
• 온보딩 문서에 운영 작업 절차를 넣을 때

문제가 생겼을 때

활용 팁

• 명령은 복사해 바로 실행할 수 있게 정확히 적고, 위험한 명령에는 '확인 후 실행' 같은 주의를 함께 적으세요.
• 롤백 절은 꼭 채워 두세요. 문제가 생긴 순간에 되돌리는 방법을 찾는 것이 가장 어렵습니다.

자주 묻는 질문