2. 配置源码管理（Git）

任务目标

在Jenkins自由风格项目中，完成Git源码管理配置：指定仓库地址、选择凭据、设置构建分支，并验证Jenkins能够成功拉取指定分支代码。

前置条件

• Jenkins已安装Git Plugin（默认安装）及Credentials Plugin
• Jenkins服务器已安装Git客户端，且git命令在PATH中可用
• 已有一个可访问的Git仓库（本案例使用公开仓库 https://github.com/jenkins-docs/simple-java-maven-app.git）

实现步骤

1. 创建自由风格项目

在Jenkins Dashboard点击新建任务，输入名称（如 git-source-demo），选择自由风格软件项目，点击确定。

2. 配置Git源码管理

在项目配置页的源码管理区域，选择Git，按以下内容填写：

• Repository URL：https://github.com/jenkins-docs/simple-java-maven-app.git
• Credentials：公开仓库无需凭据，选择 - none -；若为私有仓库，需先添加凭据（见下文）
• Branches to build：*/main（该仓库默认分支为 main）

3. 添加构建步骤（验证拉取结果）

在构建区域，点击增加构建步骤 → 执行shell，输入以下命令：

echo "=== 当前工作目录内容 ==="
ls -la
echo "=== 当前分支 ==="
git branch --show-current
echo "=== 最近一次提交 ==="
git log -1 --oneline

4. 保存并构建

点击保存，然后点击项目页面左侧的立即构建。等待构建完成后，查看控制台输出。

私有仓库凭据配置（可选）

若目标仓库为私有仓库，需先在Jenkins中添加凭据：

1. 进入Dashboard → Manage Jenkins → Credentials → System → Global credentials (unrestricted) → Add Credentials
2. Kind选择Username with password（或SSH key），填写Git用户名/密码（或私钥），设置ID（如 github-access）
3. 在项目源码管理配置中，Credentials选择刚添加的凭据ID

验证方法与通过标准

构建完成后，在控制台输出中检查：

• 出现 Cloning repository https://github.com/jenkins-docs/simple-java-maven-app.git 且无 ERROR 或 Failed to connect 报错
• 构建步骤输出的 ls -la 中包含 pom.xml 和 src 目录，说明代码已成功拉取到工作区
• git branch --show-current 输出为 main，与配置的分支一致
• git log -1 --oneline 输出一条提交记录，格式类似 a1b2c3d (HEAD -> main) commit message

满足以上条件即表示Git源码管理配置成功，Jenkins已具备从指定仓库拉取指定分支代码的能力。

常见问题

• 报错 Failed to connect to repository：检查仓库URL是否正确、网络是否可达；私有仓库需确认凭据有效且具有访问权限
• 拉取的分支不是预期分支：确认 Branches to build 中的分支名与仓库实际分支名一致（注意 */main 与 */master 的区别）
• 工作区为空：检查构建日志中是否出现 Nothing to do 或 Checkout skipped，确认源码管理区域确实勾选了Git且URL填写正确