콘텐츠로 이동
Search

OpenWorkflow

lastmod 2026-11-16created 2025-11-273 edits

OpenWorkflow는 크래시나 배포가 있어도 멈춘 자리에서 다시 이어지는 내구성(durable) 워크플로를 만드는 TypeScript 프레임워크이다. 별도의 오케스트레이터 서버를 두지 않고, 애플리케이션 쪽에서 띄운 워커들이 PostgreSQL 이나 SQLite 데이터베이스를 작업 큐이자 상태 저장소로 써서 워크플로를 실행한다. 워크플로는 몇 초에서 몇 달까지 멈췄다가 재개할 수 있다.

About

  • defineWorkflow() 로 워크플로를 정의하고 작업 단위를 step.run({ name }, fn) 으로 나눔. 끝난 단계의 결과는 백엔드에 기록돼 재실행 때 그대로 재사용되므로 결제·메일 발송 같은 부작용이 두 번 일어나지 않음
  • 워커는 workflow_runs 테이블을 폴링해 대기 중인 실행을 가져감. 워커마다 동시 실행 수를 정하고, 워커를 여러 개 띄워 수평 확장함
  • step.sleep("wait-one-hour", "1h") 같은 대기는 워커를 붙잡지 않는 내구성 타이머. 자식 워크플로 실행(step.runWorkflow)과 시그널 대기·발송도 단계로 씀
  • 단계·워크플로 단위 재시도 정책, 마감 시각(deadlineAt), 워크플로 버전, handle.cancel() 로 실행 취소
  • npx @openworkflow/cli init 이 설정 파일과 예제를 만들고, 같은 CLI 로 워커를 띄움. 대시보드와 OpenTelemetry 연동도 있음
  • Apache-2.0 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap