CI/CD / 系统课时

创建第一条 Pipeline 任务

创建第一条 Pipeline 任务

第一条 Pipeline 不需要立即连接仓库或执行复杂构建。先创建一个最小 Pipeline Job,让 Jenkins 完成调度、分配执行节点、运行阶段并产生控制台输出,就能确认流水线基础链路正常,再逐步增加真实构建步骤。

学习目标

  • 创建一个最小可运行的 Pipeline Job
  • 理解 pipeline、agent、stages 和 steps 的基本职责
  • 从控制台输出确认流水线是否真正执行成功

创建最小 Pipeline Job

在 Jenkins 中新建任务,输入任务名称后选择 Pipeline 类型并创建。进入任务配置页,在 Pipeline 区域选择直接编写 Pipeline script,然后保存下面的最小 Declarative Pipeline。

创建 Pipeline Job 的配置位置

groovy
pipeline {
    agent any

    stages {
        stage('Hello') {
            steps {
                echo 'Hello from Jenkins Pipeline'
            }
        }
    }
}

这段流水线不依赖 Git、Maven 或 Docker。agent any 表示 Jenkins 可以把任务安排到符合条件的可用执行节点;stages 保存阶段集合;stage('Hello') 定义一个可识别的阶段;真正执行的动作位于 steps 中。

配置保存后点击构建。预期结果是出现一次新的构建记录,Hello 阶段执行成功,控制台包含下面的核心内容:

text
Hello from Jenkins Pipeline
Finished: SUCCESS

Jenkins 还会输出节点分配、阶段进入和 Pipeline 内部日志,因此实际控制台内容通常更多。验证时不需要逐字匹配全部日志,只要确认自定义消息出现且最终状态为 SUCCESS。

看懂一次流水线执行

点击构建并不是直接运行 echo。Jenkins 会先创建一次构建执行,解析 Pipeline,再根据 agent any 寻找可用执行节点,随后按阶段顺序执行步骤,并把日志与最终状态保存到本次构建记录中。

第一条 Pipeline 从调度到完成的执行流程

这个流程解释了为什么“任务已经创建”并不等于“流水线能够运行”。如果没有可用执行节点,Pipeline 可能停留在等待状态;如果 Pipeline 语法无法解析,则会在进入业务步骤之前失败。

用第二个阶段验证顺序

基础任务成功后,可以增加一个阶段验证 Jenkins 是否按照声明顺序执行。下面仍然不引入外部工具,便于把问题限定在 Pipeline 本身。

groovy
pipeline {
    agent any

    stages {
        stage('Prepare') {
            steps {
                echo 'prepare'
            }
        }
        stage('Build') {
            steps {
                echo 'build'
            }
        }
    }
}

预期输出中的自定义内容应保持先后顺序,并以成功状态结束:

text
prepare
build
Finished: SUCCESS

如果 prepare 已出现而 build 没有出现,应查看 Prepare 之后的控制台日志寻找失败原因;如果两个阶段都没有进入,则优先检查 Pipeline 解析错误和执行节点分配情况。

第一条流水线的验收标准

这一步的目标不是完成真实项目构建,而是建立一个可靠基线。任务能够被手动触发、获得执行节点、依次进入阶段、产生预期日志,并最终得到 SUCCESS,就说明最基本的 Pipeline 调度与执行链路已经可用。

后续接入代码仓库、构建工具或部署命令时,如果流水线失败,就可以把这个最小任务作为对照:最小 Pipeline 仍能成功时,问题通常位于后来增加的源码、工具、凭据或构建步骤,而不是 Jenkins 最基础的流水线执行能力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建第一条 Pipeline 任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通