8.8 KiB
title, source_type, url, archive_url, status, confidence, tags, related_branches, related_projects, created, last_reviewed
| title | source_type | url | archive_url | status | confidence | tags | related_branches | related_projects | created | last_reviewed | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Atlassian — Runbooks as Code / GitOps for Incident Response | company-tech-blog | https://www.atlassian.com/incident-management/devops/runbook | raw | low |
|
|
|
2026-05-22 | 2026-05-27 |
Atlassian — Runbooks as Code / GitOps
Layer:
raw/company-tech-blogs/— Atlassian Incident Management 가이드 (runbook 페이지). 원래 등록한incident-management/devops/runbookURL 은 2026-05-27 확인 시점 HTTP 404 (페이지 이동/제거). 본 raw 는 보조 페이지software/confluence/templates/devops-runbook+ 검색 결과로만 verbatim quote 확보. ca-tmpl 의 runbook contract 결정 사례 근거로 사용하되 공식 best practice 로 인용 금지.
Parent / 활용 branch (필수)
| Branch | 이 자료가 정당화하는 결정 |
|---|---|
| raw/branch-notes/feature-operational-runbook-contract | ca-tmpl runbook://{area}/{scenario} link scheme + repository markdown 호스팅 vs Confluence wiki 대안 비교 시 Atlassian 측 입장의 사례 근거 |
| raw/project-notes/ca-skeleton-operational-contract | §18. Control Plane Contract (Operational Runbook) 의 대안 G-A 비교 자료 |
컨텍스트 / 왜 저장했는지
ca-tmpl이 채택한 "runbook link 형식 = runbook://{area}/{scenario} 또는 repository relative markdown path"의 design rationale 보강. Confluence runbook 대안의 단점, GitOps 접근의 장점 비교를 위한 사례.
출처 / Source
- 원본 URL (등록 시): https://www.atlassian.com/incident-management/devops/runbook — 2026-05-27 확인 시 HTTP 404
- 대체 fetch 가능 페이지: https://www.atlassian.com/software/confluence/templates/devops-runbook (DevOps runbook template 페이지)
- 보조: https://www.atlassian.com/incident-management/devops (Incident management in the age of DevOps)
- 관련 외부: https://opengitops.dev/ (GitOps Working Group definitions)
- 아카이브 URL: (미수집)
- 저자 / 조직: Atlassian (Incident Management content team)
- 발행일: 페이지 자체에 명시 없음 (rolling marketing content)
- 마지막 확인일: 2026-05-27
핵심 인용 / Key quotes (verbatim)
[§DevOps runbook template — Runbooks 정의] "Runbooks are used by operations teams to automate routine maintenance and respond to system alerts and outages."
[§DevOps runbook template — Purpose] "Help your operations team respond to system alerts and outages"
[§DevOps runbook template — System architecture] "Start with the big picture and provide your operations team an overview of your system architecture."
[§DevOps runbook template — Operational procedures] "When a system outage or alert pops up, your team will need to know how to start, stop, and monitor the system."
[§DevOps runbook template — Template maintenance] "Make sure to update the template as you enhance your system architecture and identify new outage scenarios."
참고 (원래 raw 에 적혀 있던 5개 quote — "runbook should be treated like any other piece of operational knowledge: version-controlled, peer-reviewed, and kept close to the service it documents" / "Runbooks as Code: store runbooks as markdown in the service's repository..." / "Confluence-hosted runbooks tend to drift..." / "Link runbooks from alert payloads using a stable URL..." / "Automation that mutates production state... should be implemented as audited Ops scripts...") 는 2026-05-27 fetch 에서 재확인 실패 (원본 URL 404). 출처 verbatim 불확정 → 본 raw 에서 정식 quote 로 사용 금지. 본 raw 의 메모 섹션 ca-tmpl 비교는 이 unverified 인용에 의존하지 않도록 재해석 필요.
Claims Extracted / 추출된 주장
| Claim ID | Claim (이 자료가 직접 말하는 것) | Evidence quote | Strength | Applies to | Does not prove |
|---|---|---|---|---|---|
| ATL-RB-C1 | Runbook 은 operations team 이 routine maintenance 자동화 + system alerts/outages 대응에 사용하는 문서 | [§DevOps runbook template] "Runbooks are used by operations teams to automate routine maintenance and respond to system alerts and outages." | company-case-study |
DevOps / on-call 운영 조직 | runbook 의 호스팅 방식 (wiki vs git) 또는 자동 실행 vs 수동 단계 의 선택을 직접 규정하지 않음 |
| ATL-RB-C2 | Runbook 의 출발점은 시스템 architecture 의 big picture 제공 | [§DevOps runbook template] "Start with the big picture and provide your operations team an overview of your system architecture." | company-case-study |
runbook 의 구조 설계 | architecture 외 어떤 섹션이 필수인지 (예: rollback / contact / escalation) 의 standardized list 는 본 인용에 없음 |
| ATL-RB-C3 | 장애·알람 발생 시 운영자는 시스템 start/stop/monitor 방법을 알아야 함 | [§DevOps runbook template] "When a system outage or alert pops up, your team will need to know how to start, stop, and monitor the system." | company-case-study |
incident 1차 대응 가이드 | "start/stop" 외에 rollback / failover / data recovery 가 동일 비중인지는 본 인용 범위 밖 |
| ATL-RB-C4 | System architecture 변화·새 outage scenario 발견 시 runbook (template) 업데이트 필수 | [§DevOps runbook template] "Make sure to update the template as you enhance your system architecture and identify new outage scenarios." | company-case-study |
runbook lifecycle 정책 | "PR review 를 통한 git-based 업데이트" vs "wiki 직접 수정" 중 어느 것이 권장인지 본 인용에 명시 없음 |
| ATL-RB-C5 | "Runbooks as Code / version-controlled / peer-reviewed / kept close to service" 라는 GitOps 권고는 원래 raw 에 인용되어 있었으나 2026-05-27 fetch 에서 원본 URL 404 로 재확인 실패 | (verbatim 미확보 — Strength needs-confirmation) |
needs-confirmation |
본 raw 가 GitOps 권고를 Atlassian 출처로 주장하는 모든 비교 | Atlassian 이 GitOps 를 권고했다는 사실 — 별도 출처 (예: archive.org 스냅샷, 다른 페이지) 로 재확보 필요 |
Usage Boundaries / 적용 경계
- 이 자료가 직접 증명하는 것:
ATL-RB-C1~C4: runbook 의 일반적 목적 (operations / alerts / architecture 가이드 / lifecycle update) — DevOps runbook template 페이지 verbatim
- 이 자료가 증명하지 않는 것:
ATL-RB-C5: "GitOps / Runbook-as-Code" 가 Atlassian 의 공식 권고라는 주장 — verbatim 재확보 실패- Confluence wiki runbook 이 drift 한다는 Atlassian 주장 — 동일 사유, 본 fetch 에 없음
- alert payload 에서 stable URL 로 runbook 을 link 해야 한다는 Atlassian 권고 — 동일 사유
- auto-remediation 을 audited script 로 구현해야 한다는 Atlassian 권고 — 동일 사유
- 내 프로젝트에 적용하려면 추가 확인이 필요한 것:
- ca-tmpl 의 GitOps 권고 비교는 본 raw 단독 근거 부족 → archive.org 또는 별도 Atlassian 페이지 (예: handbook chapter) 재확보 후 비교 재작성 권장
메모 / Notes (내 프로젝트 해석)
본 섹션은 자료 직접 인용 아님. ca-tmpl 결정 컨텍스트 해석.
C5의 verbatim 부재 한계 위에서 해석된 것이므로 본 메모의 GitOps 비교 부분은 ca-tmpl 결정의 단일 근거로 사용 불가.
- 3가지 호스팅 옵션 비교 (ca-tmpl 가설):
옵션 강점 (가설) 약점 (가설) Confluence (SaaS wiki) 검색/공유 쉬움 drift 가능, version control 약함 git repo markdown (ca-tmpl 채택) PR review, version control, code 와 동기화 검색 인덱스 별도 PagerDuty Runbook Automation 자동 실행 가능 vendor lock-in - 위 비교의 "Confluence drift" 주장은 본 raw 의 verbatim 으로 직접 증명되지 않음 (C5 참조). ca-tmpl 결정 정당화 시 별도 출처 필요.
- 장점 (ca-tmpl GitOps 접근, 본 raw 직접 증명 아님):
- service repo와 같은 PR cycle → runbook 동기화 강제.
- link-check smoke로 dead link 검증.
- 단점 (본 raw 직접 증명 아님):
- private repo login → on-call 디바이스 git access 필요.
- auto-remediation: 본 raw 에 verbatim 확보된 권고 없음. ca-tmpl Phase D2 이후 도입 시 별도 출처 (e.g., Google SRE workbook, PagerDuty doc) 필요.
Related / 관련
- 같은 주제 다른 raw:
- 인용하는 branch:
- 인용하는 project:
- 인용한 wiki 요약: (미작성)