> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 트리거

> Foundry 파이프라인 시작 방식 — 수동·스케줄·워치·웹훅.

모든 파이프라인은 정확히 하나의 Trigger 를 가집니다. 파이프라인이 *언제* 실행될지 정의합니다.

## 수동

기본. 캔버스에서 **Run** 을 클릭할 때 또는 CLI 에서만 실행:

```bash theme={null}
nora pipelines run <slug>
```

임시 백필이나 테스트에 좋음. 동기화 유지가 필요한 것에는 비추.

## 스케줄

크론으로 실행. 선택:

* **Cron 표현식** — 5필드 (`0 * * * *` = 매시간). 피커에 흔한 프리셋.
* **Timezone** — 워크스페이스 타임존이 기본.
* **Skip if previous still running** — 기본 켜짐. 백로그 방지.

다음 스케줄 실행 시각은 Trigger 블록에 표시되어 항상 알 수 있음.

## 워치

외부 위치를 감시하고 변경 시 실행:

* **폴더 워치** — Google Drive 폴더, S3 prefix, Notion 데이터베이스. 변경 감지는 콘텐츠 해시 기반이라 변경 없는 항목은 재처리 안 함.
* **채널 워치** — Slack 채널, Discord 채널. 새 메시지 배치마다 실행.

폴링 간격 기본 5분. 커넥터가 지원하면 실시간 푸시 구독 사용 (Google Drive, Slack).

## 웹훅

파이프라인을 HTTP 엔드포인트로 만듭니다. JSON 을 POST 할 수 있는 외부 시스템이 실행을 트리거 가능.

* URL: `https://api.platform.nora.my/pipelines/{slug}/trigger`
* **서명 시크릿** — `X-Nora-Signature` 의 HMAC-SHA256.
* **페이로드** — 실행 입력으로 Source 스테이지에 전달.

CMS·티켓팅·CI 에서 이미 웹훅이 있을 때 유용.

## 실행에 설정 전달

모든 Trigger 종류는 옵션인 **런타임 페이로드** 를 받습니다. 페이로드는 파이프라인의 모든 스테이지에서 `{run.payload.KEY}` 로 접근 가능한 입력 변수가 됩니다. 용도:

* 단일 레코드 타겟 수동 실행: `{ "record_id": "abc123" }`
* 날짜 파라미터 필요한 스케줄: `{ "since": "2026-07-01" }`
* 변경 출처 정보를 담은 웹훅 페이로드.

## 파이프라인 일시정지

파이프라인의 **Paused** 를 토글. 스케줄과 워치 트리거가 발화 중단. 진행 중 실행은 완료. 일시정지된 파이프라인을 배포하면 재개할 때까지 프로덕션 Agent 에서 언퍼블리시 상태.