配置任务
您可以通过设置环境变量、配置构建任务的触发条件和编写 Pipeline 脚本等操作对已新建的任务进行配置,使其满足您的构建需求。
前提条件
已 新建任务。
操作步骤
在 Jenkins 主页面,单击待配置的任务。
在任务详情页面,单击左侧导航栏的配置。
在任务配置页面,根据实际任务需求配置相关参数。本文主要介绍如何进行 准备运行环境、丢弃旧的构建、参数化构建、构建触发器、流水线 配置。
如果您不进行任何配置,此任务将为空任务,构建任务时将不会执行任何实际的操作。
配置完成后,单击保存,完成任务配置。如果配置完参数后,您不希望退出任务配置页面,请单击应用。
准备运行环境
环境变量允许将配置信息从代码中分离出来,提供了一种灵活、安全、可重用的机制,简化了代码的维护,同时也方便了与外部系统的集成。
在 General 区域,选中准备运行环境,然后在属性内容区域填写环境变量。
丢弃旧的构建
通过配置旧构建的丢弃策略,可以管理 Jenkins 中的构建历史记录,控制旧构建数据的保留和清理,从而节省存储空间、减少混乱、提高性能。
在 General 区域,选中丢弃旧的构建,根据实际任务需求设置旧构建的丢弃策略。
参数化构建
通过参数化构建,可以根据实际任务需求在构建任务时动态地传递参数值,使得同一个任务可以根据输入参数的不同而执行不同的操作,从而提高任务的灵活性和可配置性。如果您配置了此参数,构建任务时需进行对应的参数选择,下面以添加字符参数为例。
在 General 区域,选中参数化构建过程,单击添加参数,然后选择字符参数,参考表 1 完成参数配置。
参数 | 描述 | 示例值 |
---|---|---|
名称 | 参数的名称,用于在构建过程中引用该参数 | USERNAME |
默认值 | 参数的默认值,如果未提供参数值,则使用默认值 | guest |
描述 | 参数的简要描述,用于解释参数的作用或需要提供的值 | 用户名,用于登录系统 |
清除空白字符 | 输入参数值时,是否自动去除前导和尾随的空白字符 | 是 |
构建触发器
通过构建触发器,可以设置构建任务的触发条件,例如基于计划时间、代码提交或其他任务的状态等,从而实现自动化构建过程。本文以其他工程构建后触发的触发条件为例。
在 General 区域的构建触发器列表中,选中其他工程构建后触发,并参考表 2 完成参数配置。
参数 | 描述 | 示例值 |
---|---|---|
关注的项目 | 指定与任务关联的其他项目,可以关联一个或多个项目 | test_armory |
触发条件 | 任务的触发条件,取值如下:
| 只有构建稳定时触发 |
流水线
流水线脚本在流水线工程中扮演着关键角色,它通过代码的形式定义整个持续集成 / 持续交付(CI / CD)流程,并且允许将构建流程写在多个 Stage 中,将复杂的流程模块化,使得每个阶段的任务清晰可见,便于管理和调试。流水线脚本使用 Groovy 语言,可以与 Java 无缝集成,具有较高的灵活性、可读性和可扩展性。
目前,支持以下两种方式定义流水线脚本:
- Pipeline script:在 Jenkins 任务配置页面输入 Pipeline 脚本,该脚本将被 Jenkins 直接执行。适用于简单的 Pipeline 脚本,或者不需要版本控制的临时脚本。
- Pipeline script from SCM:从代码版本管理系统(如 Git、Subversion 等)中获取脚本并执行。适用于需要进行版本控制、代码审查和团队协作的 Pipeline 脚本。
本文以 Pipeline script 方式为例,在流水线区域选择 Pipeline script 方式,然后输入 Pipeline 脚本。