JENKINS-BASED · BUILD & DELIVERY

自动构建与持续交付

一次代码提交,走完触发、构建、测试、归档、审批、部署与验证。煜企智能基于 Jenkins 做二次开发与集成,把发布过程变成有版本、有记录、有确认的工程动作。

原生 / 插件 / 二开 三层分清 人工审批门禁 制品版本可回退
yuqi-ci / order-service · Pipeline #128 · main演示
构建阶段进度 · 演示BUILD #128 / DEMO
提交
构建
测试
归档
发布确认
部署
验证
演示界面,未连接 Jenkins。构建、审批与部署均需按项目配置。
DEMO DATA / 界面、阶段状态、日志与制品均为演示非真实构建
本页为本地介绍页 · 不安装 Jenkins、不执行真实构建或部署 基于 Jenkins 二次开发与集成 · 官方资料核对 2026-11-15
Jenkins 软件构建与发布自动化示意图
Jenkins 软件构建与发布自动化 · 方案示意,非实际交付截图

图中的界面、数据及价格为示例;实际功能、授权与交付范围按项目确认。

01 / CAPABILITY BOUNDARY

先说清楚:谁能做什么

Jenkins 官方把 Pipeline 定义为「a suite of plugins」——插件套件。把插件能力笼统写成「开箱即用」,交付时就会变成预期落差。以下三层按官方文档逐项区分。

官方文档核对分类示意 · 演示
01JENKINS CORE
原生能力

Jenkins 核心自带

MIT License

官方定义 Jenkins「fundamentally ... is an automation engine」。核心承担调度与记录,是整个系统的地基,但不包含流水线语法、仓库对接或审批界面。

自动化引擎与作业调度构建队列 / executor / workspace 构建历史与控制台日志archiveArtifacts 制品归档 fingerprint 制品指纹Controller / Agent 分布式架构 认证授权框架默认安全基线
依据:jenkins.io/doc/pipeline/steps/core(archiveArtifacts、fingerprint 归在 Jenkins Core 步骤组);/doc/book/managing/nodes;/doc/book/security
02PLUGINS
依赖插件

需要选型、安装与版本管理的插件

许可各自独立

官方对 Pipeline 的原文是「a suite of plugins」。凭据存储与API由 Credentials 插件提供,流水线环境绑定由 Credentials Binding 插件提供;JUnit 测试报告已从核心拆分出去。这些能力要按项目锁定插件版本并单独核对许可与依赖。

Pipeline 整套 / JenkinsfileDeclarative · Scripted 语法 Stage View 可视化Git / GitHub Branch Source Multibranch · Webhook 触发Credentials API & Binding JUnit 测试报告聚合input 人工审批 step sh 步骤 / Nodes and ProcessesMailer / Email Extension 通知 Matrix / Role Strategy 权限Docker / Kubernetes Agent
依据:/doc/book/pipeline("a suite of plugins");/doc/book/using/using-credentials("provided by the Credentials Binding plugin");plugins.jenkins.io/junit("split out to this plugin in version in 1.577");/doc/book/pipeline/syntax(input directive 调用 input step)
03YUQI ENGINEERING
煜企二次开发

按项目实施的服务与定制

服务合同另行约定

部署不是 Jenkins 的内置动作,官方示例也是 sh 'make publish' 调用脚本。真正让流水线适配企业环境的,是这一层:脚本、规范、环境、权限与运维。

Jenkinsfile / Shared Library 模板阶段编排与质量门禁 部署脚本与版本规则制品仓库 / 环境接入 发布规范与审批矩阵凭据作用域与权限配置 网络白名单与边界梳理执行记录归档 回退路径设计与演练Controller / Agent 运维支持
交付范围与运维责任由合同约定;涉及上游源码、插件及依赖时,仍须遵守各自许可证。
边界声明:本页不把插件能力宣传为「开箱即用」,不把「部署」表述为 Jenkins 内置功能,也不承诺 Jenkins 会自动恢复所有应用或数据库。数据库回退、状态型服务的版本兼容,需要按项目单独设计与演练。
02 / PIPELINE CONSOLE

把一次交付点开看

点任一阶段查看说明,或运行一次演示构建:阶段会依次点亮、日志逐行输出、制品逐步解锁。也可以主动模拟一次测试失败,看通知与人工处理入口如何出现。

界面 · 日志 · 制品全部为演示
yuqi-ci / order-service分支 main待运行
演示
STAGES / 阶段编排DEMO
点击任一阶段查看它在真实项目中的责任与依赖。当前为演示说明,不代表已配置的能力。
CONSOLE OUTPUT · order-service #128 · 演示
静态演示说明:代码提交、构建、测试、归档、发布确认、部署与验证。启用 JavaScript 后可操作演示。
ARCHIVED ARTIFACTS / 归档制品 · 演示0 / 3 已解锁
制品详情 · 演示:运行构建并归档后解锁。制品版本、校验和与部署脚本共同构成可回退的依据。
测试未通过 · 演示流水线已中止,未生成制品、未触发部署。通知已发至项目负责人(演示)。
DEMO DATA / 阶段状态、耗时、日志、制品、通知与审批人均为演示模拟,不连接任何真实 Jenkins 服务演示结果
03 / DELIVERY RAIL

一次提交的完整路径

从代码提交到上线验证共八步。中间那条红色支路是失败路径:测试不通过就中止、通知、交人工处理;发布确认是人工门禁;验证异常可沿制品版本回退。

流程示意 · 演示
业务过程流程动图 · 演示含失败分支 / 通知 / 人工入口
代码提交到上线验证的八阶段交付流程,含失败分支与回退路径 上排从左至右为代码提交、触发流水线、自动构建、自动化测试;下排从右至左为制品归档、发布确认、部署执行、上线验证。测试失败时进入通知与人工处理支路;验证异常可回退到已归档制品版本。所有状态为演示。 FAIL 修复后重新提交 验证异常 · 人工确认后回退 01 / COMMIT代码提交git push · main · 演示 02 / TRIGGER触发流水线Webhook / 扫描 · 插件 03 / BUILD自动构建Agent · 依赖 · 编译 04 / TEST自动化测试单元 · 集成 · 报告 05 / ARTIFACT制品归档版本 · 校验和 · 指纹 06 / APPROVAL发布确认input step · 人工门禁 07 / DEPLOY部署执行部署脚本 · 环境 08 / VERIFY上线验证冒烟 · 观测 · 记录 测试未通过中止 · 不归档不部署 通知负责人邮件 / IM · 插件 人工处理入口定位 · 修复 · 重跑 回退到已归档制品版本制品版本 + 部署脚本 + 人工确认
← 上方流程链路可左右滑动查看全图;也可点下方步骤逐项查看 · 演示
失败分支 · 演示 测试未通过 → 流水线中止 → 通知负责人 → 人工处理入口 → 修复后重新提交;不生成制品、不触发部署。
回退路径 · 演示 验证异常时按已归档制品版本 + 部署脚本 + 人工确认回退;须提前演练,不承诺自动恢复所有应用或数据库。

点击「播放」按阶段推进,或用「单步」逐项查看。所有节点状态、日志与结果均为演示。

执行中 已完成 人工确认 / 回退 失败与通知 DEMO RAIL / 流程示意 · 演示
04 / ROLLBACK BY DESIGN

回退是设计出来的,不是按钮

Jenkins 提供制品归档与指纹,也提供可暂停、可重入的流水线;但「把生产恢复原状」依赖应用与数据本身。煜企把回退拆成可核对的四件事,并在交付前演练。

版本号与记录均为演示
ARTIFACT VERSIONS / 已归档制品 · 演示
v2.4.0

上一稳定版本 · 校验和与部署脚本齐备

可回退目标
v2.4.1

当前线上版本 · 已通过测试与发布审批

当前
v2.4.2-rc

候选构建 · 仅归档,未获发布确认

未发布
从 v2.4.1 回退到 v2.4.0:取回同一制品,按同一脚本、按环境重新执行 · 演示
01
制品版本可追溯每次发布绑定明确的制品版本、校验和与构建编号;不以「最新包」作为发布依据。
02
部署脚本参数化回退复用同一套部署脚本,通过版本号切换目标制品,避免临时手写命令。
03
人工确认与执行记录回退作为一次有审批、有日志、有结果的发布动作留痕,可事后复盘。
04
按项目设计与演练上线前在预发环境演练回退;数据库变更、消息积压、状态兼容逐项确认。
明确不承诺:Jenkins 不会自动恢复所有应用或数据库。涉及数据库结构变更、数据写入、外部系统状态与不可逆操作时,需单独制定数据回退或补偿方案,并由项目方确认后方可执行。本页不提供此类保证。
05 / TECHNICAL ARCHITECTURE

六个角色,三条边界

代码仓库、Controller、构建 Agent、测试工具、制品仓库与部署环境各自承担什么;凭据放在哪、如何被引用;网络边界划在哪里。

架构示意 · 演示
交付链路与责任分区 · 演示虚线框 = 网络边界
基于 Jenkins 的自动构建与持续交付技术架构 代码仓库通过 Webhook 触发 Jenkins Controller;Controller 调度构建 Agent,Agent 执行构建与测试并归档制品;制品仓库为外部系统;部署脚本在受控网络边界内访问测试、预发与生产环境;凭据在 Controller 加密存储并按 ID 引用。 企业内网 · 研发与构建区 部署环境 · 受控访问 / 白名单 代码仓库Git · 分支 / PR / Tag煜企接入 · Webhook 配置 制品仓库Nexus / Artifactory 等(外部系统)煜企对接 · 版本与保留策略 Jenkins Controller调度 · 授权 · 构建历史与日志WAR / Docker / 原生包 · LTS 或 Weekly核心 · 建议不在 built-in node 执行构建 凭据存储(加密)Controller 管理的密钥 · 按 credential ID 引用插件能力 · 煜企配置作用域 构建 Agentexecutor · 固定 / 容器 / K8s核心架构 + 插件接入 测试工具 / 报告单元 · 集成 · 代码扫描JUnit XML 等报告聚合插件 / 项目脚本 部署脚本 / 发布规范煜企二次开发 · 参数化版本 部署环境测试环境 / 预发环境 / 生产环境 · 测试:每次通过构建的候选版本 · 预发:发布确认后部署与演练 · 生产:审批通过 + 发布窗口执行 访问白名单 · 最小权限 凭据按需绑定到执行环境 回退按制品版本 + 脚本执行 架构说明为方案示意 · 演示 | 官方依据:/doc/book/managing/nodes、/doc/book/using/using-credentials、/doc/book/security、/doc/book/installing
Jenkins 核心 核心架构 + 插件 外部系统 / 煜企接入 DEMO / 拓扑示意 · 演示
凭据管理

Credentials 插件负责凭据存储与API,Credentials Binding 将选定凭据绑定给流水线执行环境。加密存储不等于秘密不会到达 Agent;须控制脚本、节点和访问权限,避免 Groovy 插值和日志泄漏。

网络边界

Controller 与 Agent 位于研发构建区;测试 / 预发 / 生产按白名单与最小权限受控访问。制品默认写在 Controller 文件系统,除非转存到 Nexus / Artifactory 等外部仓库——这一步需要单独接入。

安全基线

认证、权限、CSRF、输出转义、Controller 隔离、构建授权与多分支凭据隔离,均需按所选版本和环境配置、验证;不能视为安装后即完成。

06 / WHAT YUQI DELIVERS

煜企交付的五件事

Jenkins 是引擎,不等于交付结果。以下五项是按项目实施的服务内容,也是方案评估时可以直接对照的范围清单。

服务范围示意 · 演示
笔记本电脑上显示代码编辑器
01 / PIPELINE

流水线定制

按项目语言、分支策略与质量门禁编写 Jenkinsfile 与 Shared Library 模板,把阶段、条件与失败处理固化成可审阅的代码。

JenkinsfileShared Library质量门禁
服务器端口与蓝色网络线缆特写
02 / INTEGRATION

环境接入

接入代码仓库、制品仓库与测试 / 预发 / 生产环境,编写参数化部署脚本,梳理网络白名单与连通性前提。

制品仓库部署脚本网络边界
贴满便签的发布计划白板
03 / GOVERNANCE

发布规范

约定版本号规则、准入条件、发布窗口与审批矩阵,明确哪些动作自动执行、哪些必须人工确认。

版本规则审批矩阵发布窗口
团队围坐评审笔记本电脑内容
04 / ACCESS

权限配置

配置角色矩阵与凭据作用域,处理多分支凭据隔离、构建授权与操作留痕口径,收敛最小权限。

角色矩阵凭据作用域最小权限
两人在办公桌前讨论交付方案
05 / OPERATIONS

运维支持

Controller 与 Agent 的部署、升级、备份与监控,插件版本维护、故障处置与回退演练支持。

升级备份监控告警演练支持

基于 Jenkins 的二次开发与集成

煜企智能以 Jenkins 为自动化底座,按项目定制 Jenkinsfile、Shared Library、发布脚本及业务入口。第三方核心与插件不冒充自研,页面原型不代表已上线产品。

扩展方向 · 拟开发

统一发布门户

按项目、环境和角色汇总发布申请与执行结果。

测试与质量概览

接入测试报告与质量工具,展示准入条件及失败原因。

制品与版本追溯

关联提交、制品校验和、审批和部署记录。

流水线模板中心

按语言和技术栈管理可复用模板及升级策略。

以上为可规划的开发方向,具体功能、交付和验收标准以项目约定为准。

07 / BUSINESS VALUE

价值不写在口号里,写在每次发布

不承诺具体百分比与周期数字。可核对的变化是:手工动作变少、每次交付留下可追溯物、回退有路径可演练。

对比与记录项均为演示
01 / LESS MANUAL WORK
减少手工打包
与重复发布

把编译、测试、打包、归档与部署动作交给流水线执行,人只处理例外与审批。发布不再依赖某个人记得步骤顺序。

手工:本地打包 → 传包 → 手工部署→
流水线:提交即触发 → 阶段自动推进替代重复动作
02 / TRACEABLE RELEASE
每次交付有版本
有记录、有验证

构建编号、制品校验和、测试结果、审批人、部署结果与验证结论串在同一条记录上,事后能回答「这次上线到底发了什么」。

制品版本 / 校验和可追溯
测试报告 / 审批人 / 执行日志可查询
上线验证结论可复盘
03 / REHEARSED ROLLBACK
回退路径可演练
可确认

回退不是临时救火:按项目把制品版本、部署脚本、人工确认与演练步骤提前定好,并在上线前于预发环境走一遍。

指定回退目标版本明确
复用部署脚本 + 人工确认留痕
预发演练 + 数据方案单列可核对
屏幕上显示彩色源代码 SCENE / 场景配图 · 演示
一次提交,触发一条可核对的链路代码仓库 → 流水线 → 制品 → 部署记录,每一步都留下可查的依据 · 场景配图 · 演示
08 / TYPICAL SCENARIOS

这些发布现场,最常被问到

场景描述为方案示意,不含客户案例、经营数据或性能承诺。具体实现方式在需求调研阶段确认。

场景示意 · 演示
S-01

多分支并行开发

按分支触发构建,合并请求先跑编译与测试;主干保持可发布状态,避免多人共用一套手工发布口径。

MultibranchPR 验证
S-02

月度版本发布

固定发布窗口,候选版本先归档再审批;发布确认由指定角色执行,通过后才允许进入生产部署。

发布窗口人工审批
S-03

紧急修复热更

独立修复分支与精简流水线,保留最小审批链与完整执行记录;事后补齐回归测试与版本归档。

热修复记录补齐
S-04

多环境差异化交付

测试、预发、生产使用同一制品、不同配置参数;环境差异写在脚本与配置里,不靠口头交接。

参数化配置分离
S-05

外包 / 多团队协同

按项目划分角色与凭据作用域,隔离多分支凭据访问;外部团队只接触授权范围内的流水线与制品。

权限隔离凭据收敛
S-06

遗留系统逐步接入

先把手工产物纳入版本归档,再逐步补齐自动化测试与部署脚本;不要求一次性改造全部系统。

渐进改造先归档
俯拍团队协作的多台笔记本电脑SCENE / 场景配图 · 演示
多团队协同,先说清权限边界谁能触发、谁能审批、谁能看到哪些凭据 · 场景配图 · 演示
办公桌上笔记本与外接显示器显示代码SCENE / 场景配图 · 演示
开发侧保持原有习惯提交代码仍在仓库,变化发生在提交之后 · 场景配图 · 演示
09 / DEPLOYMENT OPTIONS

按现状选接入方式

官方提供 WAR、Docker 镜像与原生安装包,并有 LTS 与 Weekly 两条发布线。Controller / Agent 的组合方式按团队规模与现有基础设施确定。

选型示意 · 演示
MODE A

单 Controller + 固定 Agent

适合团队规模较小、构建类型单一的场景。独立部署 Controller,按构建类型配置固定 Agent,结构清晰、运维面小。

WAR / 原生包LTS 建议
MODE B

Controller 备份恢复 + Agent 分组

多个项目按标签调度 Agent,Controller 配置备份、恢复与升级窗口;恢复方案需演练,不代表 Jenkins 默认支持自动主备切换。

标签调度配置备份
MODE C

容器化 / 动态 Agent

通过 Docker 或 Kubernetes 插件按需拉起构建环境,减少工具链在常驻机器上的耦合;需注意插件许可与集群权限配置。

Docker PipelineKubernetes · Apache-2.0
MODE D

与既有发布体系并存

先接管构建、测试与制品归档,保留现有发布审批与部署系统,分阶段接入;避免一次性替换带来的业务风险。

渐进接入先归档后部署

※ 官方安装文档:WAR 内嵌 Winstone(Jetty 包装)独立进程运行;LTS 每 12 周选基线、每 4 周回移修复,Weekly 每周更新。Tomcat / WildFly 理论可运行但官方标注「largely untested」,WebSocket Agent 仅支持 Jetty。以上为部署选型示意 · 演示,实际以项目评估为准。

10 / DELIVERY CHECKLIST

从调研到交接,八步可对照

交付不是把 Jenkins 装起来就结束。每一步都有可核对的产出物,尤其包含插件许可复核与回退演练。

流程示意 · 演示
01现状调研

发布现状梳理

代码仓库、分支策略、现有打包与部署方式、参与角色与痛点清单。

02方案确认

边界与验收口径

明确原生 / 插件 / 二开三层范围,确认哪些环境纳入、哪些暂不改动。

03环境准备

Controller 与 Agent

版本线选择、机器与网络白名单、凭据类型与权限模型、制品仓库接入前提。

04插件复核

选型与许可核对

锁定插件版本与依赖树,逐项核对许可证,记录差异项并交项目方确认。

05流水线实现

Jenkinsfile 与脚本

阶段编排、质量门禁、制品归档、审批节点、参数化部署脚本与通知口径。

06联调演练

含失败与回退

验证成功路径、失败分支、通知与人工入口,并在预发环境演练回退。

07试运行

发布规范落地

小范围试运行,核对版本号、审批矩阵、执行记录与发布窗口是否可持续执行。

08文档交接

培训与运维支持

架构说明、操作手册、故障处置与升级备份指引,完成权限与凭据交接。

11 / LICENSE & SOURCES

许可逐项核对,不打包成一句「开源」

Jenkins 核心是 MIT,但插件是各自独立的软件与许可。以下为 2026-11-15 依据官方许可页与各插件仓库 pom.xml <licenses> 声明核对的结果。

官方资料核对
JENKINS CORE
MIT License

Jenkins 核心采用 MIT License。商业使用、修改和分发须保留适用的版权与许可声明;软件按现状提供。依赖组件与插件须分别核对。

关键限定:该许可只覆盖 Jenkins core,不自动覆盖任何插件。插件许可需逐个核对;定制成果的授权由合同约定,并保留上游及依赖的许可义务。

核对日期 2026-11-15交付前按锁定版本复核依赖树需一并检查

流水线与步骤

Pipeline · workflow-aggregator 插件套件MIT Pipeline: Basic Steps MIT Pipeline: Input Step input 审批MIT Pipeline: Nodes and Processes sh stepMIT

仓库与触发

Git plugin MIT GitHub Branch Source MIT Generic Webhook Trigger MIT

凭据与权限

Credentials API MIT Credentials Binding MIT Matrix Authorization MIT Role-based Authorization Strategy MIT

测试、通知与 Agent 接入

JUnit 1.577 起从核心拆分MIT Mailer MIT Email Extension MIT Docker Pipeline MIT Kubernetes plugin 本清单中的许可差异示例Apache-2.0

※ 上表为方案评估时可能涉及的插件,不代表每个项目都会安装。实际清单以项目锁定的插件版本与依赖树为准,交付前重新核对。

01
核心许可全文jenkins.io/license/核心 MIT;交付以选定版本的完整许可与第三方声明为准
02
官方仓库github.com/jenkinsci/jenkinsREADME:开源自动化服务器、Java 构建、2000+ 插件、WAR / Docker / 原生包、LTS 与 Weekly
03
Pipeline 文档jenkins.io/doc/book/pipeline/原文 "a suite of plugins";Jenkinsfile、Declarative / Scripted、Node / Stage / Step
04
Pipeline 语法与 Core 步骤jenkins.io/doc/pipeline/steps/core/archiveArtifacts、fingerprint 归在 Jenkins Core 步骤组;语法页列 Sections / Directives
05
安装与版本线jenkins.io/doc/book/installing/WAR 内嵌 Winstone / Jetty;LTS 每 12 周基线、每 4 周更新;Weekly 每周
06
分布式架构jenkins.io/doc/book/managing/nodes/Controller / Node / Agent / Executor;建议不在 built-in node 执行构建;制品默认写 Controller 文件系统
07
安全与凭据jenkins.io/doc/book/security/ · /doc/book/using/using-credentials/默认禁匿名、CSRF 默认开启、按环境配置;Credentials 提供凭据存储/API;Credentials Binding 提供流水线绑定;加密存储仍需配合权限与节点隔离
08
审批与测试报告插件plugins.jenkins.io/pipeline-input-step/ · /junit/input step 提供 Proceed / Abort;JUnit 报告功能自 1.577 从核心拆分为插件
素材与授权:本页使用 10 张 Unsplash 真实场景照片(本地 本地 WebP 资源,运行时不依赖外网)。Unsplash License 允许免费下载并用于商业与非商业用途、无需事先许可;照片为通用场景配图,不是煜企智能或任何客户的机房 / 办公室实拍,不指向具体人物、企业或产品,也不构成第三方背书。若用于对外广告投放,请另行核对画面中可识别元素的 model / property release。页面所有界面、日志、制品、指标与运行结果均标注「演示」。

场景配图来自用户交付的10张照片,不是煜企或客户实拍。原稿标注 Unsplash,未随附逐图来源链接;公开使用前须补齐来源核对。素材记录 · Unsplash License

12 / TALK TO US

先聊清现状,再决定要不要上流水线

项目范围经需求评估后确认
玻璃隔断的现代办公区走廊
ASSESSMENT FIRST

把现在的发布方式摊开看,通常就能发现一半问题

我们可以从一次现状梳理开始:代码怎么合、包怎么打、谁批准上线、出问题怎么退。看完再给方案,不先卖工具。

现状调研与边界确认 插件选型与许可核对清单 回退路径与演练方案建议