운영 가능한 서비스 만들기

기능은 화면에 나타나는 순간 끝나지 않습니다. 재시도·부분 실패·데이터 변경·배포·장애 조사까지 같은 의미로 수렴해야 사용자가 믿을 수 있는 서비스가 됩니다. 이 강좌는 개발자 자료의 운영 원칙을 실제 Warragon 서비스의 경계에 대입해, 기획자·디자이너·개발자·사용자·운영자가 공유할 수 있는 증거로 바꿉니다.

다 끝내면 가능한 것

• 요구사항을 성공·진행·부분 실패·실패 상태와 인수 증거로 작성하기
• HTTP 재시도와 멱등 키, 요청 상관관계를 분리하기
• SQL·인덱스·연결 풀을 실제 조회와 시간 예산으로 설계하기
• 외부 API·Kafka·AI·알림의 Timeout·Unknown·Retry·Reconcile 경계 정하기
• 인증·인가·감사 로그와 파일 업로드 무결성 경계를 함께 검증하기
• RAG 원본·검색 사본·권한·품질을 같은 수렴 조건으로 묶기
• expand/contract 마이그레이션과 SHA 이미지·readiness·rollback을 운영하기
• bounded RED 메트릭과 smoke·SLO 증거로 “완료”를 판정하기
• 여러 서비스의 부분 실패·복구·정적 클라이언트 경계를 하나의 운영 증거로 묶기
• gRPC protobuf 계약과 WebRTC signaling/media 경계를 비용 가드와 함께 운영하기

단계 흐름

[1] 요구·상태 ─▶ [2] HTTP·멱등 ─▶ [3] DB·성능 ─▶ [4] 외부 실패
       │                                              │
       ▼                                              ▼
[12] 종합 검증 ◀─ [11] 관측성 ◀─ [10] Compose ◀─ [9] 릴리스
                                      ▲
                     [5] 권한 ─▶ [6] 파일 ─▶ [7] AI/RAG ─▶ [8] 마이그레이션

단계 구성

1. 요구사항을 상태와 증거로 바꾸기
2. HTTP 재시도와 요청 상관관계 고정하기
3. 테이블·인덱스·연결 풀을 조회 예산으로 설계하기
4. 외부 연동의 Timeout·Unknown·Retry·Reconcile 다루기
5. 인증·인가·감사 경계를 한 번만 판정하기
6. 업로드 파일을 검증하고 원자적으로 공개하기
7. AI Provider와 RAG 검색을 권한·품질과 묶기
8. Expand/Contract와 멱등 백필로 스키마 바꾸기
9. 검증된 Commit을 Release와 이미지로 묶기
10. Compose·Readiness·Reverse Proxy·Rollback 운영하기
11. RED·Correlation·SLO로 한 요청을 따라가기
12. 서비스 변경을 다섯 관점과 배포 Smoke로 검증하기
13. 부분 실패·복구·플랫폼 경계를 교차 서비스 계약으로 닫기
14. gRPC·WebRTC와 비용 가드로 실시간 기능을 안전하게 도입하기

전제 — architecture-patterns, data-engineering-postgres, quality-and-testing 중 하나를 경험했고 PostgreSQL·HTTP 기본기를 알고 있는 분.