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

# 트리거

> 파운더리 파이프라인이 시작되는 방식. 수동, 스케줄, 워치, 웹훅

파이프라인마다 Trigger가 딱 하나 있습니다. 파이프라인이 *언제* 도는지 정합니다.

<Frame>
  <img src="https://mintcdn.com/conscience-technology/Jo24V8Wx9hATIxJq/images/docs/foundry-trigger-inspector.png?fit=max&auto=format&n=Jo24V8Wx9hATIxJq&q=85&s=f1ee11f43512e7722c5382d30e78fa14" width="400" alt="Trigger 블록 설정 — 무엇에 반응할지와 디바운스 창을 정한다" data-path="images/docs/foundry-trigger-inspector.png" />
</Frame>

## 수동

기본입니다. 캔버스에서 **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에서는 언퍼블리시 상태로 있습니다.