rara/agent-roadmap/phase/operations-productization/milestones/production-reliability.md
toki d4546ecbfd
Some checks are pending
ci / validate (push) Waiting to run
add agent-roadmap
2026-07-18 19:31:48 +09:00

3.6 KiB

Milestone: Production 신뢰성

위치

목표

RARA를 선택한 production 환경에 반복 배포하고, PostgreSQL 제어 상태와 외부 artifact·index 참조를 일관되게 백업·복구하며, 핵심 SLO와 장애 대응을 검증 가능한 운영 profile로 제공한다.

상태

[스케치]

승격 조건

  • 첫 production 배포 profile의 목표 환경과 지원 topology를 확정한다.
  • PostgreSQL, artifact와 retrieval backend의 backup·restore 책임 경계를 확정한다.
  • 초기 SLO·RPO·RTO와 alert ownership을 정의한다.
  • migration, restart, restore와 provider outage 검증 범위를 정의한다.
  • 배포·복구·SLO lifecycle을 다루는 SDD 필요성을 확정하고 초안을 작성했다.

구현 잠금

  • 상태: 잠금
  • SDD: 필요
  • SDD 문서: SDD.md
  • SDD 사유: deployment profile, migration, backup·restore, SLO와 disaster recovery 계약을 정의한다.
  • 잠금 해제 조건:
    • SDD 잠금이 해제되어 있다.
    • SDD 사용자 리뷰가 승인/해결되었다.
    • Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
    • Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
    • 모든 승격 조건이 해소되고 Milestone 상태가 [계획]이다.
  • 결정 필요:
    • 첫 production 배포 profile의 목표 환경

범위

  • 로컬·단일 노드와 선택한 production deployment profile
  • 구성·secret·migration·rolling restart 경계
  • PostgreSQL control state와 외부 artifact·index pointer backup·restore
  • ingestion freshness, workflow latency, RAG latency·error와 provider health SLO
  • restore·provider outage·migration disaster smoke

기능

Epic: [production] 배포와 변경

배포 환경별 차이를 profile로 제한하고 schema·service 변경을 반복 가능하게 만든다.

  • [deployment-profiles] 로컬·단일 노드와 선택한 production profile의 topology, 구성, secret와 resource requirement를 제공한다.
  • [migration-rollout] schema migration, service rollout·rollback과 compatibility preflight를 자동화한다.

Epic: [reliability] 복구와 관측

상태 저장소가 분리된 구조에서도 복구 순서와 운영 목표를 검증한다.

  • [backup-restore] PostgreSQL과 외부 artifact·index pointer의 일관된 backup·restore 절차와 manifest를 제공한다.
  • [slo-observability] freshness, workflow, RAG와 provider health SLI·SLO·alert를 노출한다.
  • [disaster-smoke] migration, rolling restart, restore와 provider outage smoke를 자동화하고 RPO·RTO evidence를 남긴다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 스케치 단계이며 [계획] 승격 뒤 기록한다.
  • 검토 항목: 사용자 결정, backup consistency, restore rehearsal와 SLO evidence
  • agent-ui 상태 반영: 해당 없음
  • 리뷰 코멘트: 없음

범위 제외

  • 모든 cloud·orchestrator 환경 동시 지원
  • retrieval·artifact 저장소 제품 자체 구현
  • 조직 전체 incident management 제품 구현

작업 컨텍스트

  • 관련 경로: configs/, deploy/, db/, apps/
  • 표준선(선택): profile-based deployment, tested restore, observable SLO, explicit RPO·RTO
  • 선행 작업: Identity·권한과 감사, 운영 UI
  • 후속 작업: 없음
  • 확인 필요: 구현 잠금 > 결정 필요