검색
← 릴리스 노트

워크플로 실행 상태 지역 배치 설정

Vercel · 기능추가 · 2026.07.20

Vercel Workflows의 실행 상태, 큐 디스패치, 출력 스트림을 원하는 지역에 고정할 수 있게 됐습니다.

교안에 영향

예전 안내 글의 start() 사용 예시는 region option이 없으면 현재 동작을 충분히 설명하지 못합니다.

요약

- 각 run의 state, queue dispatch, output streams를 단일 home region에 보관합니다. - 기본값은 run이 시작된 지역이며, 원하는 target region을 지정할 수도 있습니다. - run은 수명 동안 home region을 유지하므로 에이전트의 실행과 체크포인트, 출력 스트리밍이 사용자 근처에서 이뤄집니다. - regional incident가 발생하면 workflow traffic이 다음으로 가까운 지역으로 failover됩니다. - 기존 workflows는 다음 실행부터 regional placement를 반영하며, migration이나 code changes는 필요하지 않습니다.

바뀐 것

새 기능 3

  • 각 run의 state, queue dispatch, output streams를 하나의 home region에 저장합니다.
  • run 시작 지역을 기본 home region으로 사용하고, 원하는 target region을 지정할 수 있습니다.
  • start()에 region option을 전달해 run을 특정 지역에 고정할 수 있습니다.

개선 2

  • run이 수명 동안 home region을 유지해 에이전트의 실행, 체크포인트, 출력 스트리밍이 사용자 근처에서 이어집니다.
  • regional incident 시 workflow traffic이 다음으로 가까운 지역으로 failover됩니다.

기타 2

  • Workflow SDK를 workflow@5.0.0-beta.33 이상으로 업데이트해야 합니다.
  • 기존 workflows는 다음 run부터 regional placement를 적용하며 migration이나 code changes가 필요하지 않습니다.

원문 제목 · Configure where run state lives in Vercel Workflows