Apifox 「定时任务」操作指南，解锁自动化测试的新利器

定时任务是按照预设时间自动执行的任务，它可以有效解决一些常见问题，比如频繁执行的回归测试和大规模的接口测试，这些任务需要在固定时间点或间隔周期内自动运行，以确保软件的持续集成和持续交付过程中的稳定性和可靠性。通过使用定时任务，可以减少人为操作的失误和麻烦，提高测试效率和准确性。

Apifox 现已支持设置定时任务，例如，你可以定时执行自动化测试中的测试场景。

定时任务生成的测试报告还可以发送给邮箱、飞书、钉钉、企业微信等平台。

当前自动化测试的定时任务仅支持基于自托管 Runner 来执行。Runner 可以理解为是一个自动化程序，可以托管在独立服务器上，它能够执行 Apifox 内的自动化测试定时任务、定时导入接口文档等工作。

下文就来介绍一下怎么通过自托管 Runner 来定时执行自动化测试的测试场景，在开始之前，请确保把 Apifox 更新到了最新版！

要使用定时任务，首先需要在服务器实例中部署 Runner，以下是 Runner 运行环境的推荐配置及部署方法。

1 Runner 运行环境

推荐的实例规格如下：

当服务器实例准备好后，在部署 Runner 之前还需要确保实例中已安装 Docker 环境，因为 Runner 通过 Docker 来执行任务。

2 安装 Docker

如何在服务器实例中安装 Docker？可以自行搜索一下，或者参考 Docker 官方文档来安装（国内镜像源可以找找云服务器厂商的）。需要注意的是，Docker 的最低版本号需使用 20.10.0。

Docker 环境有了之后，就可以开始部署 Runner 了。

3 部署 Runner

首先需要确保你有团队管理员权限，然后在 Apifox 的主窗口中，选择你的团队，并依次点击「团队资源 -> 通用 Runner -> 部署通用 Runner」。

在弹出框中复制部署通用 Runner 的命令，你可以根据需要定义命令，支持自定义服务器 OS、暴露端口、挂载数据目录等。以下是对这些设置的详细说明：

服务器 OS：指定了 Docker 容器运行的操作系统。包括 Linux、macOS 和 Windows，选择正确的操作系统是确保 Docker 容器能够正确运行的关键。
Docker 镜像：提供了三种版本，分别是通用版、精简版和自定义版本。若你的「自定义脚本」需要调用外部程序，请根据不同版本所包含的语言环境选择合适的镜像进行安装。
1. 通用版：包含 Runner 的所有功能，并内置以下外部程序的语言环境：Node.js 18、Java 21、Python 3、PHP 8。
2. 精简版：包含 Runner 的所有功能，仅内置 Node.js 18 语言环境。
3. 自定义：包含 Runner 的所有功能，并支持自定义外部程序的语言环境。你可以通过创建自己的 Dockerfile，根据需求添加或移除相关环境。
暴露端口：Docker 容器默认不会将内部端口暴露给外部访问。通过 -p 参数，你可以将容器内部的端口映射到宿主机的端口上，使得外部可以访问容器提供的服务。例如，-p 80:4524 表示将容器内部的 4524 端口映射到宿主机的 80 端口。
挂载数据目录：使用 -v 参数可以将宿主机的目录挂载到容器内部，这样容器就可以访问和操作宿主机上的文件（数据库配置、外部程序等）。例如，-v "/opt/runner":/opt/runner 表示将宿主机的 /opt/runner 目录挂载到容器的 /opt/runner 目录。