📚 课程目录第2章 Jenkins核心架构回顾

2. Jenkins 核心架构回顾：Master/Agent 架构、Pipeline 核心概念与插件生态

在深入事件驱动与性能调优之前，必须重新夯实 Jenkins 的三大架构基石：Master/Agent 拓扑、Pipeline 抽象模型以及插件扩展机制。这三者决定了 Jenkins 的伸缩性、编排能力与可定制边界，也是后续所有调优动作的物理与逻辑基础。

2.1 Master/Agent 架构：控制平面与执行平面分离

Jenkins 采用经典的主从（Master/Agent）架构。Master 负责调度、监控、UI 与数据持久化；Agent 负责实际的任务执行。这种分离设计允许横向扩展执行能力，同时保持控制平面的稳定。

  架构要点：
  Master（控制器）：运行 Jenkins 核心服务，管理 Job 配置、构建队列、插件加载、用户权限与系统配置。不建议在 Master 上执行构建任务。
Agent（执行器）：通过 JNLP、SSH、Docker 或 Kubernetes 等方式连接到 Master，领取并执行具体的 Pipeline Stage/Step。
Executor（执行槽）：Agent 上的并发执行单元，每个 Executor 同时只能运行一个构建任务。

2.2 Pipeline 核心概念：Stage 与 Step

Pipeline 是 Jenkins 2.x 的核心编排模型，将 CI/CD 流程定义为代码（Pipeline as Code）。其最小抽象单元为 Stage（阶段）与 Step（步骤）。

概念	作用	示例
Pipeline	整个 CI/CD 流程的声明式或脚本式定义	`pipeline { agent any; stages { ... } }`
Stage	逻辑阶段，用于可视化分组与流程控制	`stage('Build')`
Step	最小执行单元，调用插件或系统命令	`sh 'mvn clean package'`
Node	分配 Agent 执行上下文	`node('linux') { ... }`

性能提示：Stage 的粒度直接影响可视化与并行效率。建议每个 Stage 执行一个独立职责（编译、测试、部署），避免将多个耗时操作塞入同一个 Stage。

2.3 插件生态与扩展点

Jenkins 的插件体系是其生态繁荣的核心。插件通过实现特定的扩展点（Extension Point）来增强 Jenkins 功能。理解扩展点机制，是自定义 Pipeline Step、优化构建行为、集成外部系统的基础。

2.3.1 核心扩展点分类

扩展点类型	作用	典型插件示例
Builder	添加构建步骤（Step）	Sh step、Docker Build
SCM	集成源代码管理	Git Plugin、SVN Plugin
Publisher	构建后处理（报告、归档）	JUnit Publisher、HTML Publisher
Trigger	触发构建的条件	Poll SCM、Webhook Trigger
Notifier	发送构建通知	Email Extension、Slack Notifier

2.3.2 插件加载与隔离

Jenkins 使用 Java ServiceLoader 机制在启动时扫描并加载插件。每个插件运行在独立的 ClassLoader 中，避免类冲突。插件通过 @Extension 注解注册到对应的扩展点。

性能警告：插件数量过多或版本冲突是 Jenkins 性能劣化的常见原因。建议定期清理未使用的插件，并保持核心插件（Pipeline、Git、Credentials）版本一致。

2.3.3 自定义 Pipeline Step 示例

通过实现 SimpleBuildStep 扩展点，可以创建自定义的 Pipeline Step：

@Extension
public class MyCustomStep extends SimpleBuildStep {

    @DataBoundSetter
    private String message;

    @Override
    public void perform(Run<?,?> run, FilePath workspace, Launcher launcher, TaskListener listener)
            throws InterruptedException, IOException {
        listener.getLogger().println("Custom Step: " + message);
    }
}

在 Pipeline 中调用：

pipeline {
    agent any
    stages {
        stage('Custom') {
            steps {
                myCustomStep message: 'Hello from custom plugin'
            }
        }
    }
}

  调优关联：事件驱动 Runbook 的核心思路之一，就是通过自定义扩展点监听 Jenkins 内部事件（构建开始/结束、队列变化、Agent 上线），从而触发自动化的性能诊断与资源调整动作。