운영 가능한 서비스 만들기 — 경계·성능·복구·배포 14단계

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

다 끝내면 가능한 것

• 요구사항을 성공·진행·부분 실패·실패 상태와 인수 증거로 작성하기
• 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요구와 계약

사용자 상태, HTTP 오류, 멱등성을 먼저 정의합니다.

2데이터와 외부 경계

DB 성능, 외부 실패, 권한, 파일 처리를 복구 가능한 흐름으로 만듭니다.

3비용과 변경

AI·RAG 비용 게이트와 데이터 마이그레이션의 중단·복원 조건을 검증합니다.

4배포와 증거

릴리스, Compose health, 관측성, 공개 smoke를 하나의 완료 판정으로 묶습니다.

단계 구성

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 기본기를 알고 있는 분.