CI/CD 整合

在現代 DevOps 世界中，如果它不是自動化的，它就不存在。您不想每次開發人員推送程式碼時都手動點擊「運行」。您希望您的測試自動運行，阻止糟糕的程式碼進入生產環境。

Apidog 透過 Apidog CLI 與 Jenkins、GitHub Actions、GitLab CI 等無縫整合。

核心：Apidog CLI

Apidog CLI 是一個命令列工具，允許您在任何環境（Linux 伺服器、Docker 容器或 Jenkins 代理）中運行從 Apidog 匯出的測試場景（或直接從雲端運行）。

查看詳情：Apidog CLI

1. 安裝 Apidog CLI

它是一個 npm 套件，所以它可以在任何運行 Node.js 的地方運行。

基本用法

要運行測試場景，您只需要它的 ID（在測試內容的 CI/CD 分頁中找到）。

與 GitHub Actions 整合

這是開源和現代團隊最常見的設置。

步驟 1：獲取您的 Token 和 ID

在 Apidog 中，前往 Test Scenario -> CI/CD。

複製您的 APIDOG_ACCESS_TOKEN（保密！）。

複製包含 SCENARIO_ID 的執行命令。

步驟 2：建立工作流程檔案

在您的 Repo 中建立 .github/workflows/api-test.yml：

現在，每當有人推送程式碼時，GitHub 都會分配一台伺服器，安裝 Apidog CLI，運行您的完整回歸套件，並將通過/失敗報告回 Pull Request。

與 Jenkins / GitLab CI 整合

對於其他 CI 提供商，原理保持不變。無論您是使用 Jenkins（透過 Groovy 管道中的 sh 'npm install ...' 步驟）還是 GitLab CI（由 .gitlab-ci.yml 中的 job 新增），核心要求是相同的：
只要 Runner 機器有網際網路存取權限並能連接您的 API，Apidog CLI 就可以工作。

在 Localhost 運行

CI 中的常見挑戰是 API 尚未部署——它在 CI 機器的 localhost 上運行。

Apidog CLI 自然地處理這個問題，因為它直接在 CI 機器上運行。您只需構建管道以先啟動您的 API（例如 npm start &），等待連接埠打開，然後針對 http://localhost:8000 執行 Apidog CLI 命令。

關鍵重點

將 API 測試整合到 CI/CD 管道中

使用 Apidog CLI 進行自動化

確保持續的反饋迴圈

下一步

CI/CD 處理程式碼更改。但是如果 API 在沒人更改程式碼時當機怎麼辦？我們需要 監控 (Monitoring)。

在下一章中，我們將設定 排程任務 (Scheduled Tasks) 以 24/7 監視您的 API。

繼續閱讀 → 排程任務和自動化

核心：Apidog CLI#

1. 安裝 Apidog CLI#

基本用法#

與 GitHub Actions 整合#

步驟 1：獲取您的 Token 和 ID#

步驟 2：建立工作流程檔案#

與 Jenkins / GitLab CI 整合#

在 Localhost 運行#

關鍵重點#

下一步#