Cloudflare Workflows 테스트, 이제 더 쉽고 강력하게!
by DD
7개월 전
조회수 3
Cloudflare Workflows의 테스트를 위한 새로운 API 출시
Vitest 기반의 로컬 환경에서 Workflows 인스턴스 제어 가능
테스트 격리 및 API Mocking 지원으로 개발 생산성 향상
Workflows 테스트 아키텍처 심층 분석
Vitest와 workerd를 활용하여 Workflows 테스트 환경을 구축했다. 구체적으로, cloudflare:test 모듈을 통해 Workflows Engine DO에 접근하여 테스트를 수행한다. 따라서, RPC를 통해 Engine DO의 메서드를 호출하고, 테스트 격리를 보장한다.
테스트 API의 장점과 기술적 트레이드오프
새로운 API는 Workflows의 테스트 용이성을 크게 향상시켰다. IntrospectWorkflowInstance와 IntrospectWorkflow를 통해 유연한 테스트 환경을 제공한다. 반면, Miniflare 및 vitest-pool-workers의 내부 구조 변경 없이 구현하기 위해 Proxy 객체와 RPC를 활용하는 기술적 부채를 감수했다.
Workflows 테스트, 실전 적용 가이드
Workflows 테스트를 위해 @cloudflare/vitest-pool-workers 최신 버전을 설치해야 한다. IntrospectWorkflowInstance 또는 IntrospectWorkflow를 사용하여 Step 결과 Mocking 및 이벤트 시뮬레이션을 수행한다. 따라서, 테스트 코드 작성 시 Cloudflare 공식 문서를 참고하여 Workflows의 동작을 정확하게 검증해야 한다.
