配置任务

更新时间:
2024-12-20

配置任务

您可以通过设置环境变量、配置构建任务的触发条件和编写 Pipeline 脚本等操作对已新建的任务进行配置,使其满足您的构建需求。

前提条件

新建任务

操作步骤

  1. 登录 Jenkins

  2. 在 Jenkins 主页面,单击待配置的任务。

  3. 在任务详情页面,单击左侧导航栏的配置

  4. 在任务配置页面,根据实际任务需求配置相关参数。本文主要介绍如何进行 准备运行环境丢弃旧的构建参数化构建构建触发器流水线 配置。

    如果您不进行任何配置,此任务将为空任务,构建任务时将不会执行任何实际的操作。

  5. 配置完成后,单击保存,完成任务配置。如果配置完参数后,您不希望退出任务配置页面,请单击应用

准备运行环境

环境变量允许将配置信息从代码中分离出来,提供了一种灵活、安全、可重用的机制,简化了代码的维护,同时也方便了与外部系统的集成。

在 General 区域,选中准备运行环境,然后在属性内容区域填写环境变量。

丢弃旧的构建

通过配置旧构建的丢弃策略,可以管理 Jenkins 中的构建历史记录,控制旧构建数据的保留和清理,从而节省存储空间、减少混乱、提高性能。

在 General 区域,选中丢弃旧的构建,根据实际任务需求设置旧构建的丢弃策略。

参数化构建

通过参数化构建,可以根据实际任务需求在构建任务时动态地传递参数值,使得同一个任务可以根据输入参数的不同而执行不同的操作,从而提高任务的灵活性和可配置性。如果您配置了此参数,构建任务时需进行对应的参数选择,下面以添加字符参数为例。

在 General 区域,选中参数化构建过程,单击添加参数,然后选择字符参数,参考表 1 完成参数配置。

表 1 参数化构建参数说明
参数描述示例值
名称参数的名称,用于在构建过程中引用该参数USERNAME
默认值参数的默认值,如果未提供参数值,则使用默认值guest
描述参数的简要描述,用于解释参数的作用或需要提供的值用户名,用于登录系统
清除空白字符输入参数值时,是否自动去除前导和尾随的空白字符

构建触发器

通过构建触发器,可以设置构建任务的触发条件,例如基于计划时间、代码提交或其他任务的状态等,从而实现自动化构建过程。本文以其他工程构建后触发的触发条件为例。

在 General 区域的构建触发器列表中,选中其他工程构建后触发,并参考表 2 完成参数配置。

表 2 构建触发器参数说明
参数描述示例值
关注的项目指定与任务关联的其他项目,可以关联一个或多个项目test_armory
触发条件任务的触发条件,取值如下:
  • 只有构建稳定时触发:只有当关注的项目构建结果为稳定时,才会触发当前任务执行
  • 即使构建不稳定时也会触发:即使关注的项目构建结果为不稳定,当前任务仍会触发执行
  • 即使构建失败时也会触发:即使关注的项目构建结果为失败,当前任务仍会触发执行
  • Always trigger, even if the build is aborted:无论关注的项目的构建结果如何,当前任务都会触发执行
只有构建稳定时触发

流水线

流水线脚本在流水线工程中扮演着关键角色,它通过代码的形式定义整个持续集成 / 持续交付(CI / CD)流程,并且允许将构建流程写在多个 Stage 中,将复杂的流程模块化,使得每个阶段的任务清晰可见,便于管理和调试。流水线脚本使用 Groovy 语言,可以与 Java 无缝集成,具有较高的灵活性、可读性和可扩展性。

目前,支持以下两种方式定义流水线脚本:

  • Pipeline script:在 Jenkins 任务配置页面输入 Pipeline 脚本,该脚本将被 Jenkins 直接执行。适用于简单的 Pipeline 脚本,或者不需要版本控制的临时脚本。
  • Pipeline script from SCM:从代码版本管理系统(如 Git、Subversion 等)中获取脚本并执行。适用于需要进行版本控制、代码审查和团队协作的 Pipeline 脚本。

本文以 Pipeline script 方式为例,在流水线区域选择 Pipeline script 方式,然后输入 Pipeline 脚本。

文档内容是否对您有所帮助?
有帮助
没帮助