🐍10. Durable Execution: 장기 작업 신뢰성

긴 작업, 승인 대기, 외부 장애가 끼어드는 순간에는 “한 번에 끝나는 실행” 가정이 깨집니다. Durable Execution은 중단 후에도 이어서 진행할 수 있게 하는 운영 장치입니다.

AI 활용 안내: 이 문서는 생성형 AI를 활용해 작성했으며, Pydantic AI 공식 문서를 1차 출처로 검토해 정리했습니다.

공식문서 흐름 점검 (개요 보완)

• 흐름: Durable execution 개념/적용 조건 → Prefect/Temporal 통합 선택 → idempotency·retry·activity 설정 → 관측(Logfire)과 운영 배치.
• 이번 편에서 빠지면 안 되는 포인트:
  • “장기 실행”과 “재시도”를 분리해 설명한다(같지 않음).
  • 워크플로 엔진 선택 기준(팀 운영환경/스케줄/승인대기)을 개요에 넣는다.
  • 캐싱·멱등성 기준 없이 도입하지 않도록 경고를 명시한다.
• 공식 문서 체크 링크:
  • https://ai.pydantic.dev/durable_execution/overview/index.md
  • https://ai.pydantic.dev/durable_execution/prefect/index.md
  • https://ai.pydantic.dev/durable_execution/temporal/index.md

Durable이 필요한 대표 상황

• 10분 이상 걸리는 장기 처리
• 사람 승인(HITL) 대기
• 외부 API 일시 장애가 잦은 워크플로우

공식 문서:

• Overview: https://ai.pydantic.dev/durable_execution/overview/
• Prefect/Temporal 연계 문서 참조

flowchart TD
  A[작업 시작] --> B[중간 상태 저장]
  B --> C{장애/중단?}
  C -->|아니오| D[다음 단계 진행]
  C -->|예| E[복구 후 재개]
  E --> D
  D --> F[완료]

미니 사례 A: 배치 작업이 중간에 끊기면 처음부터 다시 하던 문제

중간 상태 저장이 없어서 실패할 때마다 전체 재실행이 필요했습니다. Durable 방식으로 체크포인트를 남기자 복구 시간이 단축됐습니다.

미니 사례 B: 승인 대기 중 프로세스가 타임아웃되는 문제

사람 승인까지 기다리는 동안 세션이 만료됐습니다. Durable 워크플로우로 대기 상태를 저장하고 승인 후 재개하도록 바꿔 해결했습니다.

실무 적용 순서

1. 중단 가능 지점 식별
2. 재개에 필요한 최소 상태 정의
3. 단계별 idempotency(중복 실행 안전성) 확보
4. 복구 시나리오 리허설

성공 판정:

• 장애 후 처음부터 재실행 비율이 줄었다
• 승인 대기 시나리오를 안정적으로 처리한다
• 복구 절차가 문서화되어 있다

다음 글

• 🐍11. Logfire 관측·비용·운영 대시보드
• 🐍09. Evals: 성능 검증과 자동 평가
• 🐍 PydanticAI 허브