排程工作
排程工作依照時間表，對你組織的某個 App 發出一次 HTTP 呼叫，類似 Google Cloud Scheduler。
排程工作的內容#
呼叫會打到當下上線的版本。
| 欄位 | 說明 |
|---|---|
| App | 要呼叫的容器 App。 |
| 路徑 | 接在 App 網址後面，以 / 開頭，可以帶查詢字串，例如 /tasks/daily。 |
| 方法 | GET、POST、PUT、PATCH 或 DELETE，預設 POST。只有 POST、PUT、PATCH 會送出內文。 |
| 排程 | 五個欄位的 cron 運算式：分、時、日、月、星期。最密每分鐘一次。 |
| 時區 | 預設 Asia/Taipei。 |
cron 運算式的例子：
| 運算式 | 執行時間 |
|---|---|
0 9 * * * | 每天 09:00 |
*/15 * * * * | 每 15 分鐘 |
0 8 * * 1 | 每週一 08:00 |
0 0 1 * * | 每月 1 日 00:00 |
建立排程工作#
- 在 App 加一個端點 例如
POST /tasks/daily，把要定期做的事寫在裡面，部署上線。 - 建立排程工作 打開「部署 › 排程工作」，選 App，填路徑和排程。
- 手動執行一次 用「立即執行」試跑，在執行紀錄確認回應碼和記錄。
確認呼叫來自排程#
預設的呼叫不帶任何驗證資訊。要讓 App 確認來源，二選一：
- 在排程工作設定自訂標頭，例如
X-Cron-Secret，值存成 App 的密鑰，程式裡比對。 - 開啟簽署權杖，呼叫會帶
Authorization: Bearer <JWT>。用https://api.agentlab.cresclab.com/.well-known/jwks.json驗證，aud是franky:app:<App ID>。
執行規則#
| 項目 | 行為 |
|---|---|
| 重疊 | 不會重疊。上一次還沒結束時，到期的那一次會略過。 |
| 送達 | 至少送達一次，可能重複。請用 X-Franky-Run-Id 標頭去除重複。 |
| 重試 | 預設 0 次，最多 5 次。 |
| 逾時 | 15 秒到 30 分鐘，預設 3 分鐘。 |
const runId = req.headers["x-franky-run-id"];
if (await alreadyHandled(runId)) {
res.writeHead(200).end();
return;
}