Python测试构建

通过Python测试构建流水线,自动化进行代码检出、编译构建、运行单元测试、输出结果记录、测试统计等能力,减少人工干预,增强项目可见性,并且有效的日志能够帮助开发者更容易发现并解决存在问题。

步骤一:新建测试构建流水线

  1. 登录流水线Flow服务控制台,在控制台界面,请单击右侧上方新建流水线按钮

  2. 在弹出窗口页面,选择Python测试构建流水线模板,单击创建按钮。image

步骤二:配置流水线源

添加流水线源,根据需求选择合适的代码项目,此示例选择示例代码源Python,添加完成。image

步骤三:配置测试构建

  1. 在流水线任务节点操作界面,请单击Python 代码扫描或者Python 单元测试任务节点,在弹出的右侧编辑页面,配置基本参数。

    参数

    说明

    任务名称

    自定义任务名称。

    构建集群

    根据需求选择合适的默认公共或者私有构建集群。

    构建环境

    根据需求选择合适的构建环境。

    说明

    任务执行期间,流水线任务构建环境分配给用户使用,构建环境使用权限归属用户,任务执行脚本由用户自定义。

    下载流水线源

    根据需求选择下载流水线源的不同方式。

  2. 在任务节点Python 代码扫描任务编辑页面,任务步骤配置项,配置Python 代码扫描任务相关参数。

    参数

    说明

    步骤名称

    自定义步骤名称。

    请选择Python版本

    根据项目需求选择合适的Python版本。

    开启增量扫描模式

    如果未开启增量扫描模式,则对全量代码进行扫描。

    排除子目录

    根据需求选择被排除在扫描范围之外的目录或文件,可参考gitignore配置(例如test/)。

    红线信息

    根据条件设置判定本任务是成功还是失败。

    image

  3. 在任务节点Python 单元测试任务编辑页面,任务步骤配置项,配置Python 单元测试任务相关参数。

    参数

    说明

    步骤名称

    自定义步骤名称。

    请选择Python版本

    根据需求选择预置的Python版本。

    测试命令

    测试命令为用于执行测试以及生成报告的用户自定义测试命令。命令执行目录为代码库根路径(支持pytest-html报告)。

    测试报告目录

    测试报告目录为生成的测试报告所在目录。当前步骤会自动上传该目录并用于后期的报告展示。例如report。

    测试报告入口文件

    测试报告入口文件为测试报告入口文件名称。用于打开报告时的默认首页。例如index.html。

    红线信息

    根据条件设置判定本任务是成功还是失败。

    image

  4. 在流水线任务节点操作界面,请单击Python 构建上传到仓库任务节点,在弹出的右侧编辑页面配置参数,查看任务步骤配置项Python 构建任务,根据项目需求配置合适的构建命令。image

  5. 任务步骤配置项,配置构建物上传任务参数,提供以下两种方式可供选择。

    企业私有通用制品仓库

    • 选择配置企业私有通用制品仓库(制品将上传Packages统一管理)上传方式。

      参数

      说明

      步骤名称

      自定义步骤名称。

      上传方式

      根据需求选择合适的。

      仓库

      添加服务资源的链接,选择自定义的仓库。

      制品名称

      自定义构建物的名称,例如target1,用于区分多次构建产生的不同产出物,定义后在部署组件使用,建议使用动态变量形式设置。

      制品版本

      版本用于唯一标识您的制品文件,因此同一制品不允许推送重复版本。

      说明

      建议使用动态变量形式,比如:${DATETIME}。

      打包路径

      设置起始位置为项目文件夹的相对路径(如"target/"),可以设置多个文件路径。

      制品中包含打包路径的目录

      如果选中,则生成的压缩包中,包含完整的打包路径,否则仅包含文件。

      说明

      当选择设置了多个打包路径时,该值自动设置为true选中状态。

    • 任务配置参数参考图。image

    说明

    关于通用制品仓库,具体操作请参阅制品管理

    归档至云效公共存储空间

    • 选择配置归档至云效公共存储空间(供后续任务拉取并部署)上传方式。

      参数

      说明

      步骤名称

      自定义步骤名称。

      上传方式

      根据需求选择合适的。

      制品名称

      自定义构建物的名称,例如target1,用于区分多次构建产生的不同产出物,定义后在部署组件使用,建议使用动态变量形式设置。

      打包路径

      设置起始位置为项目文件夹的相对路径(如"target/"),可以设置多个文件路径。

      制品中包含打包路径的目录

      如果选中,则生成的压缩包中,包含完整的打包路径,否则仅包含文件。

      说明

      当选择设置了多个打包路径时,该值自动设置为true选中状态。

      image

步骤四:运行并查看目标流水线任务

  1. 在流水线Flow控制台界面我的流水线列表,单击目标流水线右侧image运行按钮,再单击目标流水线名称,查看流水线任务节点界面,在任务节点上,可以查看测试报告和日志。image

  2. 运行流水线任务完成后,在构建镜像任务节点,右下方单击日志,可以查看到流水线任务的执行过程结果日志。image

  3. 在制品仓库查看上传的构建物。