스케줄 트리거 (Schedule Trigger)
스케줄 트리거는 크론(Cron) 표현식을 기반으로 워크플로우를 주기적으로 자동 실행하는 트리거 노드입니다. 정해진 시간에 반복적으로 수행해야 하는 작업을 자동화할 때 사용합니다.
주요 기능
크론 표현식 기반의 유연한 스케줄링
타임존 설정 지원 (서울, 도쿄, 뉴욕, 런던 등)
동시 실행 제한, 실행 제한 시간, 실패 시 재시도 등 고급 설정
워크플로우당 하나의 스케줄 트리거 노드만 배치 가능
설정 항목
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
활성화 | Boolean |
| 스케줄 활성화 여부. 비활성화하면 워크플로우가 자동 실행되지 않습니다. |
크론 표현식 | String |
| 실행 주기를 지정하는 크론 표현식 (필수) |
타임존 | Options |
| 스케줄 실행 시 기준 타임존 |
설명 | String | - | 스케줄에 대한 선택적 설명 |
고급 설정
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
최대 동시 실행 수 | Number |
| 허용되는 최대 동시 실행 수 |
실행 제한 시간 (초) | Number |
| 최대 실행 시간 (기본 5분) |
실패 시 재시도 | Boolean |
| 워크플로우 실패 시 재시도 여부 |
최대 재시도 횟수 | Number |
| 재시도 활성화 시 최대 재시도 횟수 |
재시도 지연 (초) | Number |
| 재시도 간 지연 시간 |
크론 표현식 가이드
크론 표현식은 분 시 일 월 요일 5개 필드로 구성됩니다.
자주 사용하는 패턴
크론 표현식 | 설명 |
|---|---|
| 매주 평일 오전 9시 |
| 6시간마다 |
| 매일 자정 |
| 매주 일요일 자정 |
| 15분마다 |
| 매월 1일 정오 |
크론 표현식을 테스트하려면 crontab.guru를 활용하세요.
인증 정보
인증 정보가 필요하지 않습니다.
사용 예시
매일 아침 데이터 동기화
매일 오전 9시에 외부 API에서 데이터를 가져와 Google Sheets에 저장합니다.
스케줄 트리거 (0 9 * * *) → HTTP Request (데이터 조회) → Google Sheets (저장)
주간 리포트 자동 발송
매주 월요일 오전 10시에 주간 리포트를 생성하여 이메일로 발송합니다.
스케줄 트리거 (0 10 * * 1) → Google Sheets (데이터 집계) → Gmail (리포트 발송)
15분마다 모니터링
15분 간격으로 서비스 상태를 확인하고, 이상 감지 시 알림을 보냅니다.
스케줄 트리거 (*/15 * * * *) → HTTP Request (상태 확인) → If (이상 여부) → Solapi (알림 발송)
참고 사항
스케줄 트리거가 동작하려면 워크플로우를 반드시 활성화(Activate) 해야 합니다.
에디터에서 테스트 버튼을 클릭하면 수동으로 실행할 수 있으며, 이 경우
trigger_type: "manual_test"값이 출력됩니다.스케줄은 백엔드 스케줄러 서비스(BullMQ)에서 관리되며, 워크플로우 저장 시 자동으로 스케줄이 등록됩니다.
실패 시 재시도 옵션을 활성화하면 워크플로우 실행이 실패했을 때 지정된 횟수만큼 자동으로 재시도합니다.
동시 실행이 필요한 경우 최대 동시 실행 수를 늘릴 수 있지만, 리소스 사용량에 주의하세요.