如何配置Jenkins实现Robot Framework冒烟/回归测试按需执行

前置准备 #

• 确保Jenkins构建节点已经安装对应版本的Python和Robot Framework，执行robot --version可正常输出版本信息
• 提前在Jenkins插件管理安装Robot Framework插件，用于测试结果可视化展示
• 确认项目内10条冒烟用例已经正确打上Smoke标签，标签名需和后续执行命令中传入的名称保持一致

自由风格任务配置步骤 #

• 新建自由风格软件项目，勾选「This project is parameterized」开启参数化构建能力
• 新增选项类型参数：
  • 参数名固定填TEST_TYPE
  • 可选值按行依次填入Smoke、Full_Regression
  • 默认值选Smoke，参数描述标注：Smoke=执行10条冒烟用例，Full_Regression=执行全量80条回归用例
• 源码管理模块选择Git，填入项目Git仓库地址、访问凭证、要拉取的代码分支，和普通构建任务的源码配置规则一致
• 新增构建步骤，根据构建节点操作系统选择对应执行入口：

  Linux/macOS节点选「执行Shell」，Windows节点选「执行Windows批处理命令」
  Shell环境执行命令如下：

  # 根据选择的测试类型拼接执行参数
  if [ "$TEST_TYPE" = "Smoke" ]; then
      RUN_TAG="--include Smoke"
  else
      RUN_TAG=""
  fi
  # 执行测试，--outputdir指定报告输出目录，路径替换为自身项目的用例存放根目录
  robot $RUN_TAG --outputdir test_reports ./testcases
  

  Windows批处理环境执行命令如下：

  @echo off
  if "%TEST_TYPE%"=="Smoke" (
      set RUN_TAG=--include Smoke
  ) else (
      set RUN_TAG=
  )
  robot %RUN_TAG% --outputdir test_reports .\testcases
  

• 新增构建后操作「Publish Robot Framework test results」，报告路径填上面命令里指定的test_reports目录，其余配置保持默认即可，保存任务配置

声明式流水线任务配置参考 #

如果使用流水线类型任务，可直接参考以下脚本编写：

pipeline {
    agent any
    parameters {
        choice(
            name: 'TEST_TYPE',
            choices: ['Smoke', 'Full_Regression'],
            description: 'Smoke=冒烟测试, Full_Regression=全量回归测试'
        )
    }
    stages {
        stage('拉取代码') {
            steps {
                // 替换为自身项目的Git仓库地址和目标分支
                git branch: 'main', url: '你的项目Git仓库地址'
            }
        }
        stage('执行测试') {
            steps {
                script {
                    def runArgs = params.TEST_TYPE == 'Smoke' ? '--include Smoke' : ''
                    // 替换为自身项目的用例目录路径
                    sh "robot ${runArgs} --outputdir test_reports ./testcases"
                }
            }
        }
        stage('发布测试报告') {
            steps {
                robot outputPath: 'test_reports'
            }
        }
    }
}

使用方式 #

配置完成后，点击任务的「Build with Parameters」选项，在下拉菜单选择需要执行的测试类型，点击构建即可自动执行对应范围的用例，构建完成后可直接在任务详情页查看Robot Framework生成的测试报告。

内容的提问来源于stack exchange，提问作者Kumar Abhimanyu