Ubuntu 上搭建可协作的 Jenkins 实践指南
一 基础架构与安装
- 在 Ubuntu 22.04/24.04 上安装 OpenJDK 11，添加 Jenkins 官方 APT 源并安装服务，启动并设置开机自启；默认访问端口为 8080。如需外网访问，开放防火墙端口（如 ufw allow 8080）。
- 建议以 Docker 方式运行，便于数据持久化与迁移：映射 /var/jenkins_home 到宿主机数据目录，映射 8080→9000（便于与系统已有服务区分）、50000→50000（代理通信），并挂载 SSH 密钥、JDK、Gradle、Android SDK 等工具目录，统一团队构建环境。
- 初始化后在 Manage Jenkins → Manage Plugins 安装常用插件：Git、Pipeline、SSH、JUnit、HTML Publisher 等，为协作提供代码拉取、流水线编排与报告能力。
二 版本控制与代码触发
- 与 GitLab/GitHub 集成：在代码仓库根目录放置 Jenkinsfile，将构建流程纳入版本控制；在 Jenkins 中创建 Multibranch Pipeline 或普通 Pipeline 任务，统一从仓库拉取代码并执行流水线。
- 事件驱动构建：使用 Generic Webhook Trigger 接收仓库推送事件，提取 ref/分支名/提交ID 等参数，按需触发对应分支的构建，避免全量扫描与无效构建。
- 构建状态回写：调用 GitLab/GitHub API 将 pending/success/failed 状态回写到提交或合并请求，提升 Code Review 与 CI 可视化 的协作效率。
- 分支策略：结合团队节奏选择 Git Flow（适合多环境、多阶段发布）或 GitHub Flow（轻量、快速迭代）。
三 权限与多团队协作
- 启用安全：在 Manage Jenkins → Configure Global Security 打开安全，选择 Jenkins 自有用户数据库 或 LDAP 等认证方式，并开启 CSRF 保护。
- 授权模型：优先使用 Role-Based Strategy 插件，按 Global roles（全局）、Item roles（项目）、Agent roles（节点） 分层授权；为 开发/测试/运维 等角色配置最小权限，避免越权操作。
- 凭证管理：使用 Credentials 存储 SSH 私钥、Git 令牌、镜像仓库凭据 等，配合 凭据绑定 在流水线中安全使用，避免明文配置。
四 流水线设计与质量门禁
- 标准化 Jenkinsfile：以 agent any 或指定 Docker 镜像 运行，分阶段组织流程（Checkout → Build → Test → Package → Deploy），并在 post 阶段统一处理 成功/失败 通知与状态回写。
- 质量与安全：接入 单元测试/集成测试（如 JUnit）、静态检查（如 cppcheck）、代码质量（如 SonarQube），失败即阻断合并，保障主干稳定。
- 缓存与产物：对 Composer/NPM/Maven/Gradle 依赖与构建中间产物进行缓存，缩短构建时长；将 Docker 镜像 推送至 私有仓库，二进制产物上传 Nexus 等制品库，避免重复构建。
- 人工审核与灰度发布：在预生产阶段加入 审批 与 冒烟测试，通过后再执行 蓝绿/滚动 发布；生产回滚策略可基于 Kubernetes 的 rollout undo 或版本标签快速回退。
五 通知、可视化与运维效率
- 通知机制：安装 Email Extension 插件，配置 收件人/抄送、触发条件 与 HTML 报告，在构建成功、失败、不稳定时自动推送；也可结合企业微信/钉钉机器人进行即时通知。
- 可视化与报告：在流水线中收集 JUnit XML、覆盖率、静态检查 等报告并发布到 Jenkins，便于团队查看趋势与定位问题。
- 性能与扩展：合理设置 JVM 堆大小 与 并发构建数，避免资源争用；通过 Docker 层缓存 与 分布式构建（Agent/节点） 提升吞吐；使用 JCasC（Configuration as Code） 将系统配置纳入版本控制，保证环境一致性与可重现性。
