排程任務與自動化

API 不僅在您更改程式碼時會崩潰。當資料庫磁碟已滿、第三方授權過期或網路波動時，它們也會崩潰。

CI/CD 保護您免受 糟糕程式碼 的影響，但 排程任務 (Scheduled Tasks) 保護您免受 糟糕環境 的影響。

在 Apidog 中，排程任務允許您以特定間隔自動運行測試場景。

引擎：Self-Hosted Runner

與某些僅限雲端的工具不同，Apidog 使用 Self-hosted Runner (General Runner) 來執行排程任務。

為什麼選擇 Self-Hosted？

安全性：Runner 位於您的網路（或 VPC）內部。它可以存取公共雲無法觸及的內部 Staging/Dev 資料庫和本地 API (localhost)。

控制權：您管理資源和環境依賴項（如資料庫驅動程式或 SSL 憑證）。

設定 Runner

在建立任務之前，您需要一個在線的 Runner。

前往 Settings (Team) > General Runner。

Apidog 提供一個簡單的 Docker 命令：

在您的伺服器（Linux/Mac/Windows）上運行此命令。

一旦 Apidog 中的 Runner 狀態變為 "Started"，您就可以開始自動化了。

查看詳情：General Runner

建立排程任務

一旦您的「引擎」(Runner) 正在運行，您就可以告訴它做什麼。

導航到 Testing > Scheduled Tasks。

點擊 New Task。

1. 選擇場景

選擇您之前建立的 Test Scenarios（例如「使用者生命週期」）。您可以在一個任務中將多個場景串聯起來。

2. 配置環境和變數

這是一個關鍵步驟。由於任務自動運行，您必須定義：

Environment：針對哪個環境進行測試（例如 Staging）。

Test Data：如果您的場景依賴於 CSV，請確保已配置它們。

變數範圍：
當運行多個場景時，您需要決定如何共享變數：

Share only in current scenario：變數在每個場景後重置。

Share across task：場景 A 可以將 {{token}} 傳遞給場景 B。

3. 設定排程

定義「引擎」何時啟動汽車。

Frequency：每 X 分鐘/小時，或特定日期/時間。

Cron Expression：適用於需要複雜排程的進階使用者（例如「每個工作日上午 9 點」）。

4. 通知

如果沒人看到紅燈，監視器就沒用了。

Channels：電子郵件、Slack、Microsoft Teams、釘釘等。

Conditions：

Notify always：適合每日報告。

Notify on failure：反垃圾郵件模式。只有在出問題時才打擾您。

查看詳情：排程任務

真實案例：生產健康監控

讓我們設定一個「冒煙測試」，每 15 分鐘運行一次，以確保關鍵路徑正常運作。

配置：

Scenarios：

GET /public-status（快速檢查）

POST /auth/login（關鍵依賴檢查）

Runner："Prod-Monitor-Runner"（部署在 Prod VPC 中的 Runner）。

Schedule：每 15 分鐘。

Notification：Slack 頻道 #ops-alerts（僅在失敗時）。

現在，如果您的身份驗證服務在凌晨 3 點當機，Runner 會檢測到 500 錯誤並立即 Ping Slack。

關鍵重點

排程任務 將測試轉變為監視器。

Self-Hosted Runners 允許您安全地測試內部/專用網路 API。

有效使用通知以在沒有噪音的情況下提醒正確的人員。

如果串聯多個場景，請確保正確設定 變數範圍。

下一步

我們已經涵蓋了從第一次點擊到 24/7 監控的整個生命週期。我們還有最後一章要討論進階策略，如安全性和契約測試。

繼續閱讀 → 進階測試策略

排程任務與自動化

引擎：Self-Hosted Runner#

為什麼選擇 Self-Hosted？#

設定 Runner#

建立排程任務#

1. 選擇場景#

2. 配置環境和變數#

3. 設定排程#

4. 通知#

真實案例：生產健康監控#

關鍵重點#

下一步#