yleisradio/docker-robotframework

Robot Framework UI测试Docker镜像

概述

此Docker镜像基于https://github.com/danielwhatmuff/robot-docker%E9%A1%B9%E7%9B%AE%E5%90%AF%E5%8F%91%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96%E5%9C%A8CI%E7%8E%AF%E5%A2%83%E4%B8%AD%E8%BF%90%E8%A1%8C%E5%9F%BA%E4%BA%8ERobot Framework的UI测试。支持通过pybot（顺序执行）或pabot（并行执行）两种方式运行测试，用户需将测试从主机挂载到容器，并设置必要的环境变量。

核心功能和特性

• 多执行模式：支持pybot（顺序执行测试）和pabot（并行执行测试）
• CI环境适配：专为CI环境设计，便于集成到自动化测试流程
• 灵活配置：通过环境变量控制测试范围、执行参数、日志输出等
• 浏览器测试支持：包含chromedriver配置，可配合SeleniumLibrary使用

使用场景

• CI/CD流水线中的自动化UI测试
• 需要并行执行以提高效率的Robot Framework测试
• 跨环境一致的测试执行环境需求

使用方法和配置说明

基本使用示例

使用pybot运行测试（仅传递必填环境变量）

bash
docker run --rm -e ROBOT_TESTS=/tests/ -e ROBOT_LOGS=/tests/logs/ -v $(pwd)/tests:/tests/ -ti docker.xuanyuan.run/yleisradio/docker-robotframework

使用标签选择特定测试

bash
docker run --rm -e ROBOT_TESTS=/tests/ -e ROBOT_LOGS=/tests/logs/ -e ROBOT_ITAG=google -v $(pwd)/tests:/tests/ -ti docker.xuanyuan.run/yleisradio/docker-robotframework

使用pabot运行测试（无锁2进程）

bash
docker run --rm -e ROBOT_MODE=pabot -e ROBOT_TESTS=/tests/ -e ROBOT_LOGS=/tests/logs/ -e LOG_LEVEL=DEBUG -v $(pwd)/tests:/tests/ -ti docker.xuanyuan.run/yleisradio/docker-robotframework

使用pabot运行测试（带锁15进程）

bash
docker run --rm -e ROBOT_MODE=pabot -e PABOT_LIB=pabotlib -e PABOT_RES=/tests/conf/list_for_pabot.dat -e ROBOT_TESTS=/tests/tests -e ROBOT_LOGS=/tests/logs/ -e PABOT_PROC=15 --shm-size docker.xuanyuan.run/6g -v $(pwd):/tests -ti yleisradio/docker-robotframework

环境变量说明

必填环境变量

• ROBOT_TESTS：容器内测试文件挂载目录
• ROBOT_LOGS：容器内日志输出目录

可选环境变量

• ROBOT_MODE：测试执行模式，设为pabot时启用并行执行
• PABOT_LIB：指定使用pabot库
• PABOT_RES：包含锁所需值集的资源文件路径
• PABOT_PROC：pabot并行进程数
• ROBOT_VAR：测试变量文件（传递给pybot/pabot的--variablefile参数）
• ROBOT_ITAG：包含的测试标签（传递给pybot的-i参数）
• ROBOT_ETAG：排除的测试标签（传递给pybot的-e参数）
• ROBOT_TEST：指定运行的测试用例（传递给pybot的-t参数）
• ROBOT_SUITE：指定运行的测试套件（传递给pybot的-s参数）
• RES：浏览器测试时Xvfb使用的分辨率

注意：PABOT_LIB和PABOT_RES必须紧跟在ROBOT_MODE之后设置，否则可能导致值集文件无法找到。

本地构建镜像

如需修改镜像，可通过以下步骤构建本地版本：

bash
cd robotframework
docker build -t docker-robotframework .

贡献

欢迎在GitHub上提交bug报告和拉取请求：https://github.com/Yleisradio/docker-robotframework%E3%80%82%E6%9C%AC%E9%A1%B9%E7%9B%AE%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E4%B8%80%E4%B8%AA%E5%AE%89%E5%85%A8%E3%80%81%E5%8F%8B%E5%A5%BD%E7%9A%84%E5%8D%8F%E4%BD%9C%E7%A9%BA%E9%97%B4%EF%BC%8C%E8%B4%A1%E7%8C%AE%E8%80%85%E5%BA%94%E9%81%B5%E5%AE%88Contributor Covenant行为准则。

许可

此Dockerfile以开源形式发布，遵循http://opensource.org/licenses/MIT%E6%9D%A1%E6%AC%BE%E3%80%82