用Jenkins搭建Linux CI流水线的核心是自动化代码拉取、编译、测试、打包、部署，关键在于步骤稳定、错误可定位、Git分支与触发逻辑清晰。
用 Jenkins 搭建 Linux 下的 CI 流水线，核心是把代码拉下来、编译（或安装依赖）、测试、打包、部署这一串动作自动化跑通。关键不在工具多炫，而在每步能稳住、出错能定位、联调 Git 项目时分支和触发逻辑清晰。
环境准备与 Jenkins 基础配置
确保 Linux 服务器（推荐 Ubuntu 22.04 / CentOS 7+）已装好 Java 11+、Git、Docker（如需容器化部署），再用官方包安装 Jenkins：
- 添加 Jenkins 官方源，执行 apt install jenkins（Debian/Ubuntu）或 yum install jenkins（CentOS）
- 启动服务：systemctl start jenkins，首次访问 http://你的IP:8080，用 /var/lib/jenkins/secrets/initialAdminPassword 解锁
- 装必要插件：Git、Pipeline、Blue Ocean、Publish Over SSH（如需远程部署）、Docker Pipeline（如用镜像）
- 在 系统设置 → 全局工具配置 中配好 JDK、Maven、Git 路径（Jenkins 默认可能找不到系统 Git，填 /usr/bin/git）
Git 仓库接入与分支触发策略
Jenkins 不是“连上 Git 就自动跑”，得明确告诉它：监听哪个分支、什么动作触发、怎么拉代码。以主流场景为例：
- 开发用 dev 分支提交，合并到 main 后自动构建上线 —— 在流水线脚本里用 checkout scm，配合 Webhook 触发（GitHub/GitLab 配置 Payload URL 为 http://你的Jenkins地址:8080/github-webhook/）
- 若用轮询（不推荐但内网可用），在流水线定义里加 triggers { pollSCM('H/5 * * * *') }，表示每 5 分钟检查一次 Git 变更
- 多分支流水线（Multibranch Pipeline）更省心：新建任务选该类型，填 Git 地址，Jenkins 自动扫描所有含 Jenkinsfile 的分支并建对应任务
写一个可运行的 Jenkinsfile（声明式 Pipeline）
把流程写进项目根目录的 Jenkinsfile，这是真正驱动 CI 的配置。以下是一个 Python Flask 项目的典型例子（替换成你项目的语言和命令即可）：
pipeline {
agent any
environment {
APP_NAME = 'my-flask-app'
REMOTE_HOST = '192.168.1.100'
REMOTE_PATH = '/opt/myapp'
}
stages {
stage('Checkout') {
steps {
checkout scm
}
}
stage('Install Dependencies') {
steps {
sh 'pip3 install -r requirements.txt --user'
}
}
stage('Run Tests') {
steps {
sh 'python3 -m pytest tests/ -v || true' // 失败不中断，方便看日志
}
}
stage('Deploy') {
steps {
sh 'rsync -avz --delete . ${REMOTE_HOST}:${REMOTE_PATH}/'
sh 'ssh ${REMOTE_HOST} "cd ${REMOTE_PATH} && systemctl restart ${APP_NAME}"'
}
}
}
post {
failure {
echo '构建失败，请检查控制台输出'
}
success {
echo '✅ 构建部署完成'
}
}
}注意：agent any 表示用任意可用节点；sh 命令默认在 Jenkins 工作目录执行；|| true 是临时绕过测试失败导致流程终止，正式环境建议用 when { expression { ... } } 精细控制。
联调要点：权限、路径、环境一致性
CI 跑通但线上出问题？大概率卡在这三块：
- 权限问题：Jenkins 用户（通常是 jenkins）需有 Git 读权限（SSH key 放 /var/lib/jenkins/.ssh/ 并 chmod 600）、目标服务器 SSH 写权限、Docker socket 访问权（如需 build 镜像，加 jenkins 用户进 docker 组）
- 路径别硬编码：用 WORKSPACE 环境变量代替绝对路径，例如 sh "cd $WORKSPACE && make build"
- 环境要对齐：本地能跑 ≠ Jenkins 能跑。检查 Python 版本、Node.js 版本、gcc 是否安装、.env 文件是否被忽略（Jenkins 默认不传）—— 建议把运行时依赖写进 Dockerfile 或用 pyenv/nvm 管理
基本上就这些。不复杂但容易忽略细节，比如忘了给 Jenkins 用户加 sudo 权限去重启服务，或者 Git webhook 没开 TLS 验证导致请求被 Jenkins 拒收。跑通一次之后，把 Jenkinsfile 提交进 Git，后续每次 push 就真成了“提交即上线”。
