Apidog Runner 是一個命令列工具，可在伺服器環境中執行排程 API 測試和自動化任務。本參考指南概述在生產環境或 CI/CD 環境中部署 Runner 所需的硬體、執行階段和網路需求。了解這些需求可確保在大規模執行自動化 API 測試時，維持最佳效能與可靠性。硬體需求#
建議伺服器設定#
| 元件 | 最低 需求 | 建議 | 用途 |
|---|
| CPU | 2 核心 | 4+ 核心 | Runner 會並行執行排程任務，因此需要足夠的處理能力 |
| 記憶體 | 4GB RAM | 8GB+ RAM | Runner 在排程任務期間會載入並產生大量資料；較大的團隊需要更多記憶體 |
| 磁碟空間 | 30GB | 50GB+ | 用於容納日誌儲存和測試產物 |
對於較大的團隊或高頻率 測試執行，請將記憶體增加到 8GB 或更多，以防止效能下降。
執行階段參數#
| 參數名稱 | 說明 | 範例值 |
|---|
TZ | 設定 Runner 執行的時區。排程任務將根據設定的時區和時間執行。請參考 TZ identifier 進行設定。 | America/Los_Angeles |
容器執行階段使用者與 runAsNonRoot#
從 Runner 版本 2.2.5 開始，映像檔包含一個非 root 使用者 runner，其固定 UID/GID 為 10001:10001，以支援更安全的非 root 執行階段模式。 使用預設啟動方式時，容器會先以 root 身分執行 entrypoint 指令碼，準備 /opt/runner 目錄的權限，然後降低權限，以 runner 使用者身分執行主程序。這與歷史卷宗權限相容，並可防止日誌和變數檔案等執行階段資料無法寫入。如果部署平台強制使用 runAsNonRoot，請依照以下方式設定容器安全性內容：啟用後，entrypoint 指令碼將無法再執行 mkdir 或 chown。因此，任何掛載到 /opt/runner 的 hostPath、PVC 或其他卷宗，都必須事先授予 UID/GID 10001 的寫入權限。Runner 會將執行階段資料寫入 /opt/runner/logs 和 /opt/runner/variables 等目錄。如果權限不足，任務執行可能會失敗，或日誌可能無法寫入。使用 hostPath 時，你可以事先在主機上執行以下命令：如果沒有強制啟用 runAsNonRoot 的需求，建議保留預設啟動方式。網路環境#
伺服器通訊需求#
Runner 需要與 Apidog 伺服器通訊。請確保執行 Runner 的伺服器網路環境可以存取 Apidog 伺服器，並支援 WebSocket 協定。請確保你的防火牆允許透過連接埠 443（HTTPS）連線到 Apidog 伺服器的出站連線，以及用於即時通訊的 WebSocket 連線。
自動化測試需求#
對於自動化測試的排程任務，伺服器的網路環境必須能夠存取所有請求的 URL，才能正常發起請求。執行自動化測試後，測試報告將會上傳——請確保伺服器網路環境可以存取 AWS 網域名稱。資料匯入需求#
對於匯入資料的排程任務，請確保伺服器的網路環境可以存取要匯入的資料來源 URL。 