Jenkins流水线是怎么知道每个阶段运行结束了的?
Jenkins流水线判断每个阶段运行结束的机制基于Groovy脚本执行和状态回调。以下是详细原理:
1.声明式流水线(Declarative Pipeline)
pipeline{agent any stages{stage('Build'){steps{echo'Building...'// 所有步骤执行完毕 → 阶段结束}post{success{echo'Stage succeeded'}}}stage('Test'){steps{// 前一个阶段完成后才会进入此阶段sh'npm test'}}}}2.脚本式流水线(Scripted Pipeline)
node{stage('Build'){// 执行代码块echo'Building...'// 代码块执行完毕 → 阶段结束}stage('Test'){// 只有上一个阶段完成后才会执行sh'make test'}}3.核心判断机制
步骤执行状态
- 每个
step(如sh,echo,bat)都返回执行状态 - 步骤成功:继续执行下一步
- 步骤失败:抛出异常,阶段标记为失败
阶段边界检测
// Jenkins内部逻辑简化表示for(Stage stage:pipeline.stages){try{stage.execute()// 执行阶段内所有步骤stage.status='SUCCESS'}catch(Exception e){stage.status='FAILURE'if(stage.failFast)break// 是否中断流水线}}异步任务处理
stage('Deploy'){steps{// 并行任务parallel(frontend:{sh'deploy-frontend.sh'},backend:{sh'deploy-backend.sh'})// 所有并行分支完成后 → 阶段结束}}4.状态持久化与回调
- Jenkins记录每个步骤的执行结果到build.xml
- 使用持久化状态机跟踪进度
- 通过回调处理器通知阶段完成事件
5.实际工作流程示例
stage('Build'){steps{// 1. Jenkins执行 sh 步骤sh'mvn compile'// 2. 等待shell命令退出// 3. 检查退出码(0=成功,非0=失败)// 4. 记录步骤结果// 5. 所有步骤成功 → 阶段结束echo'Build completed'// 6. 触发 post-stage 钩子}}6.关键特性
顺序执行
- 阶段按定义顺序执行
- 前一个阶段必须完成(成功/失败)才能进入下一个
错误处理
stage('Deploy'){steps{retry(3){sh'deploy.sh'// 失败会重试}timeout(time:1,unit:'HOURS'){sh'smoke-test.sh'// 超时则阶段失败}}}可视化跟踪
- Blue Ocean界面实时显示阶段状态
- 阶段图标变化(蓝色=进行中,绿色=成功,红色=失败)
7.底层实现
// 简化的Jenkins核心代码逻辑publicclassStageExecution{publicFlowNoderun(){startStage();try{for(Stepstep:steps){step.run();// 执行每个步骤if(step.failed()){thrownewFlowInterruptedException();}}endStage(Result.SUCCESS);}catch(Exceptione){endStage(Result.FAILURE);}}}总结
Jenkins通过:
- 步骤状态跟踪- 每个步骤的返回码决定是否继续
- 异常处理机制- 捕获失败并更新阶段状态
- 同步屏障- 确保阶段顺序执行
- 持久化状态- 记录到磁盘供中断后恢复
这些机制共同确保流水线能准确判断每个阶段的结束状态。