Jenkins在Linux怎样集成版本控制

在 Linux 上，Jenkins 集成版本控制的主流方式是 Git 与 SVN。下面给出从环境准备到触发器与排错的完整落地步骤，覆盖两种版本控制系统与常见场景。

环境准备与插件安装

安装基础运行环境：确保已安装 Java 8+、Git（或 Subversion）。在 Debian/Ubuntu 可参考：sudo apt update && sudo apt install -y openjdk-11-jdk git；在 RHEL/CentOS 可参考：sudo yum install -y java-11-openjdk git。
安装并启动 Jenkins：添加官方仓库后安装并启动服务（默认监听 8080 端口），完成初始化向导。
安装插件：进入 Manage Jenkins > Manage Plugins，安装 Git plugin（Git 集成必备）；如使用 SVN，安装 Subversion Plugin。
全局工具配置：进入 Manage Jenkins > Global Tool Configuration，配置 JDK、Git（如未自动识别需手动指定路径）。

准备凭据：生成 SSH 密钥对，将公钥添加到 Git 仓库（GitHub/GitLab/Gitee 或自建 Git 服务器），私钥作为 Jenkins 凭据 保存（推荐凭据 ID 如：github-ssh）。
新建任务：选择 Freestyle project 或 Pipeline。在源码管理中选 Git，填写仓库 URL（如 git@github.com:org/repo.git 或 https://…），选择上一步的 SSH 凭据。
构建触发器：
- 轮询 SCM：如 **H/5 * * * *** 每 5 分钟检查变更；
- Webhook：在 GitHub/GitLab 仓库 Settings > Webhooks 添加 http:///github-webhook/（或 gitlab 对应路径），用于 push 后自动触发。
构建步骤：根据项目类型执行 mvn clean install、npm 构建或 Execute shell。
Pipeline 示例（Jenkinsfile）：
pipeline {
agent any
environment {
GIT_REPO = ‘git@github.com:org/repo.git’
DEPLOY_PATH = ‘/var/www/html’
}
stages {
stage(‘Checkout’) { steps { git credentialsId: ‘github-ssh’, url: GIT_REPO } }
stage(‘Build’) { steps { sh ‘mvn clean install’ } }
stage(‘Deploy’) { steps { sh ‘scp target/*.war user@server:${DEPLOY_PATH}’ } }
}
}
远程部署：如需发布到远程主机，可安装 Publish Over SSH 插件并在系统设置中配置目标服务器，然后在构建后步骤中传输产物并执行远程命令。

安装与建库：在 Linux 安装 Subversion，创建仓库（如 svnadmin create /opt/svn/repos），并按需配置 svnserve.conf / passwd / authz 的访问与权限；启动服务（如 svnserve -d -r /opt/svn/repos）。
Jenkins 插件与任务：安装 Subversion Plugin；新建任务后在源码管理选择 Subversion，填写仓库 URL（如 svn://ip/repos/project/trunk），添加 用户名/密码 凭据。
触发器与钩子：
- 轮询 SCM：如 **H * * * *** 每分钟检查一次变更；
- 提交后触发：在 SVN 服务器仓库的 hooks/post-commit 中调用 Jenkins CLI 触发构建（需提前在 Jenkins 生成 API Token 或使用 jenkins-cli.jar 与凭据）。
常见构建：结合 Maven 执行 mvn 构建，或使用 Execute shell 执行自定义脚本。

轮询 SCM：简单可靠，适合公网或无法开放 Webhook 的环境；示例 **H/5 * * * *** 每 5 分钟检查一次。
Webhook：实时性最好；GitHub/GitLab 配置 Webhook 指向 /github-webhook/（或 GitLab 对应端点），并确保 Jenkins 任务已勾选对应触发器。
SVN 钩子：在 post-commit 中通过 jenkins-cli.jar 调用构建，实现提交即构建（注意在钩子中处理认证与日志）。

SSH 权限错误（Permission denied publickey）：确认 私钥已导入 Jenkins 凭据、仓库 Deploy keys 或 个人访问令牌配置正确；必要时在本机先执行一次 git clone 验证连通性与 known_hosts。
构建失败与环境不一致：核对 JDK 版本、Maven/Git 版本与项目配置一致；依赖下载慢可配置 Maven 镜像源。
Webhook 未触发：核对 URL、端口与路径是否正确，Jenkins 是否允许匿名读取（CSRF 保护下需正确配置），以及网络连通性（公网/内网、反向代理/防火墙）。
SVN 权限或路径错误：检查 svnserve.conf / passwd / authz 配置与仓库 URL 路径是否匹配，必要时用 svn 命令行本地验证。