26M5a
Cloud Native Data Lakehouse SRE — Confluence 문서 체계
1. Space 구조 설계
🏠 Space: CN-Lakehouse SRE
│
├── 📋 작업계획서 (Work Plans)
│ ├── 2025
│ │ ├── Q1
│ │ └── Q2
│ └── 템플릿
│
├── 📖 SOP (Standard Operating Procedures)
│ ├── 플랫폼 운영
│ │ ├── K8s / Cilium
│ │ ├── MinIO AIStor
│ │ ├── CNPG
│ │ └── Milvus
│ ├── 장애 대응
│ └── 배포 절차
│
├── 🔥 PIR (Post-Incident Reports)
│ ├── 2025
│ └── 템플릿
│
├── 📌 과제 관리
│ ├── 진행중 과제
│ ├── 완료 과제
│ └── 백로그
│
├── 🗺️ 아키텍처 & 설계
│
└── 📊 운영 현황 (Dashboard)
├── 월간 리포트
└── SLA / SLO 현황2. 메타데이터 체계 (Labels + Properties)
Confluence에서 메타데이터를 관리하는 핵심 방법은 Labels(태그) + Page Properties + Page Properties Report 조합입니다.
공통 Labels 체계
[문서 유형] [우선순위] [상태]
doc-type:workplan priority:p1 status:draft
doc-type:sop priority:p2 status:review
doc-type:pir priority:p3 status:approved
doc-type:task status:active
doc-type:runbook status:deprecated
[컴포넌트] [영향도]
component:k8s impact:critical
component:cilium impact:high
component:minio-aistor impact:medium
component:cnpg impact:low
component:milvus
component:spark
component:starrocks
[팀 / 담당] [분기]
team:infra quarter:2025-q1
team:data-eng quarter:2025-q2
team:ml-platform3. 문서 유형별 Page Properties 설계
Confluence의 Page Properties 매크로를 각 문서 상단에 삽입하면 나중에 Page Properties Report로 전체 목록을 자동 집계할 수 있습니다.
3-1. 작업계획서 (Work Plan)
┌─────────────────────────────────────────────────────┐
│ 📋 작업계획서 │
│ Page Properties 매크로 │
├──────────────────┬──────────────────────────────────┤
│ 작업명 │ StarRocks 클러스터 스케일아웃 │
│ 작업 유형 │ 변경(Change) / 배포 / 점검 │
│ 담당자 │ @홍길동 │
│ 검토자 │ @김영희 │
│ 승인자 │ @이철수 │
│ 작업 일시 │ 2025-03-10 02:00 ~ 04:00 │
│ 예상 다운타임 │ 없음 / 30분 │
│ 영향 서비스 │ StarRocks, Spark │
│ 관련 컴포넌트 │ component:starrocks, component:k8s │
│ 우선순위 │ P2 │
│ 상태 │ 승인완료 │
│ 관련 SOP │ [SOP-K8s-Scale-001] │
│ 관련 Jira │ LAKE-1234 │
│ 롤백 플랜 │ 있음 / 섹션 5 참조 │
└──────────────────┴──────────────────────────────────┘
## 1. 목적 및 배경
## 2. 사전 체크리스트
## 3. 작업 절차 (단계별)
## 4. 검증 방법
## 5. 롤백 절차
## 6. 완료 후 조치3-2. SOP (Standard Operating Procedure)
┌─────────────────────────────────────────────────────┐
│ 📖 SOP │
│ Page Properties 매크로 │
├──────────────────┬──────────────────────────────────┤
│ SOP ID │ SOP-MINIO-001 │
│ 제목 │ MinIO AIStor 노드 교체 절차 │
│ 버전 │ v1.2 │
│ 작성일 │ 2025-01-15 │
│ 최종 수정일 │ 2025-03-01 │
│ 작성자 │ @홍길동 │
│ 검토자 │ @김영희 │
│ 승인자 │ @이철수 │
│ 상태 │ Approved │
│ 컴포넌트 │ component:minio-aistor │
│ 카테고리 │ 하드웨어 교체 │
│ 예상 소요시간 │ 2시간 │
│ 필요 권한 │ K8s Admin, MinIO Admin │
│ 관련 SOP │ SOP-K8s-Node-001 │
│ 관련 Runbook │ RB-MINIO-FAILOVER-001 │
│ 다음 검토 일정 │ 2025-09-01 │
└──────────────────┴──────────────────────────────────┘
## 1. 개요
## 2. 사전 조건
## 3. 단계별 절차
## 4. 검증
## 5. 주의사항 / 알려진 이슈
## 6. 변경 이력3-3. PIR (Post-Incident Report)
┌─────────────────────────────────────────────────────┐
│ 🔥 PIR │
│ Page Properties 매크로 │
├──────────────────┬──────────────────────────────────┤
│ PIR ID │ PIR-2025-003 │
│ 인시던트 제목 │ MinIO 스토리지 클러스터 접속 불가 │
│ 심각도 │ SEV-1 / SEV-2 / SEV-3 │
│ 발생 일시 │ 2025-03-05 14:23 KST │
│ 복구 일시 │ 2025-03-05 16:45 KST │
│ 총 다운타임 │ 2시간 22분 │
│ 영향 서비스 │ Spark, StarRocks, JupyterLab │
│ 영향 사용자 수 │ 약 80명 │
│ 근본 원인 │ 네트워크 / 스토리지 / 앱 버그 │
│ 담당 SRE │ @홍길동 │
│ 상태 │ Draft / Review / Closed │
│ 관련 컴포넌트 │ component:minio-aistor, component:cilium │
│ 재발 방지 조치 │ 3건 (액션아이템 섹션 참조) │
│ 관련 Jira │ INC-567 │
└──────────────────┴──────────────────────────────────┘
## 1. 타임라인 (Timeline)
## 2. 근본 원인 분석 (RCA)
## 3. 영향도 분석
## 4. 대응 과정
## 5. 재발 방지 액션아이템
| 항목 | 담당자 | 기한 | 상태 |
## 6. 잘된 점 / 개선점 (Blameless)3-4. 과제 관리 문서
┌─────────────────────────────────────────────────────┐
│ 📌 과제 │
│ Page Properties 매크로 │
├──────────────────┬──────────────────────────────────┤
│ 과제 ID │ TASK-2025-Q1-012 │
│ 과제명 │ CNPG 다중 인스턴스 구성 │
│ 유형 │ 구축 / 개선 / PoC / 연구 │
│ 담당자 │ @홍길동 │
│ 팀 │ team:infra │
│ 시작일 │ 2025-02-01 │
│ 목표 완료일 │ 2025-03-31 │
│ 실제 완료일 │ - │
│ 진행률 │ 60% │
│ 우선순위 │ P1 │
│ 상태 │ 진행중 │
│ 분기 │ quarter:2025-q1 │
│ 관련 컴포넌트 │ component:cnpg │
│ 관련 Jira Epic │ LAKE-EPIC-023 │
│ 완료 기준(DoD) │ 명시 │
└──────────────────┴──────────────────────────────────┘4. Page Properties Report로 자동 대시보드
각 문서 유형별 부모 페이지에 Page Properties Report 매크로를 삽입하면 전체 목록이 자동 집계됩니다.
작업계획서 현황판 예시
[Page Properties Report 매크로 설정]
Label: doc-type:workplan
Space: 현재 Space
표시 컬럼: 작업명, 담당자, 작업일시, 영향도, 상태, 관련 SOP
→ 자동으로 아래 표 생성:
┌──────────────────┬────────┬──────────────┬──────┬────────┐
│ 작업명 │ 담당자 │ 작업 일시 │ 영향 │ 상태 │
├──────────────────┼────────┼──────────────┼──────┼────────┤
│ StarRocks 스케일 │ 홍길동 │ 2025-03-10 │ 중 │ 승인완료│
│ Cilium 업그레이드│ 김영희 │ 2025-03-15 │ 고 │ 검토중 │
└──────────────────┴────────┴──────────────┴──────┴────────┘SOP 현황판 (만료 관리)
[Page Properties Report 매크로 설정]
Label: doc-type:sop, status:approved
표시 컬럼: SOP ID, 제목, 버전, 컴포넌트, 최종수정일, 다음검토일정
→ 검토 기한이 다가오는 SOP를 한눈에 파악 가능PIR 트래킹
[Page Properties Report 매크로 설정]
Label: doc-type:pir
표시 컬럼: PIR ID, 인시던트명, 심각도, 다운타임, 근본원인, 상태
→ 인시던트 트렌드 및 미완료 액션아이템 추적5. 실제 Confluence 구현 방법
Labels 적용
페이지 하단 Label 입력창에 아래 형식으로 추가:
doc-type:sop
component:minio-aistor
status:approved
quarter:2025-q1
→ 여러 Label 조합으로 검색/필터링 가능
예: doc-type:pir AND status:closed 로 완료된 PIR만 검색Page Properties 매크로 삽입 순서
① 페이지 편집 모드 진입
② 본문 상단에 커서 위치
③ '/' 입력 → 'Page Properties' 검색 → 삽입
④ 매크로 내부에 2열 표 작성 (좌: 항목명, 우: 값)
- 값 셀에 @멘션, 날짜 피커, 다른 페이지 링크 활용
⑤ 페이지 저장 후 Label 추가Page Properties Report 매크로 삽입 (대시보드 페이지)
① 대시보드 역할의 부모 페이지 편집
② '/' → 'Page Properties Report' 삽입
③ 설정:
- Label: 집계할 Label (예: doc-type:sop)
- Space: 현재 Space
- Column names: 표시할 항목명 (Page Properties의 좌측 셀 값과 일치해야 함)
④ 저장하면 자동으로 하위 페이지 집계6. 메타데이터 관리 운영 원칙
① Label 네이밍 컨벤션 통일
→ 팀 Wiki에 Label 사전 명시
→ 자유 입력 허용 시 doc-type:SOP, sop, SOP-doc 등 파편화 발생
② Page Properties는 페이지 최상단에 고정
→ 템플릿으로 만들어 신규 문서 생성 시 자동 포함
③ 상태(status) Label은 하나만 유지
→ status:draft → status:review → status:approved 이동 시
기존 status Label 제거 후 신규 추가
④ 분기별 SOP 검토 주기 캘린더 연동
→ '다음 검토 일정' 필드 기반으로 Confluence 캘린더 매크로 활용
⑤ PIR 액션아이템은 Jira와 연동
→ Confluence PIR 페이지 ↔ Jira Task 양방향 링크
→ Jira 티켓 상태가 Done이 되면 PIR 페이지 액션아이템도 갱신요약
핵심 3가지 Confluence 기능 조합
① Labels → 검색/필터의 기반 태그
② Page Properties → 문서별 정형 메타데이터 (표 형식)
③ PP Report → 전체 문서 현황 자동 대시보드
이 3가지만 제대로 쓰면
"이번 분기 P1 과제 중 진행중인 것"
"component:minio-aistor 관련 SOP 전체"
"올해 SEV-1 PIR 목록 + 액션아이템 완료율"
같은 뷰를 별도 작업 없이 자동으로 볼 수 있습니다.
engineer