Jenkins 服务器上安装 Git

安装 Git

# 更新包列表
sudo apt update

# 安装 Git
sudo apt install git

验证安装

# 检查 Git 版本
git --version

查看所有全局配置

git config --global --list

查看特定配置项

# 查看用户名配置
git config --global user.name

# 查看邮箱配置
git config --global user.email

查看配置文件位置

# 查看全局配置文件位置
git config --global --list --show-origin

查看当前 Git 配置

# 查看所有配置（包括全局和本地）
git config --list

查看配置文件内容

# 查看全局配置文件内容
cat ~/.gitconfig

如果这些命令显示配置为空或报错，说明还没有配置全局变量。你可以使用以下命令进行配置

# 配置用户名
git config --global user.name "Your Name"

# 配置邮箱
git config --global user.email "your.email@example.com"

配置 Git 凭证（如果需要访问私有仓库）

# 配置凭证存储
sudo git config --global credential.helper store

在 Jenkins 中配置 Git

• 进入 Jenkins 管理界面

• 进入 "Manage Jenkins" > "Global Tool Configuration"

• 找到 "Git" 部分

• 配置：

• 名称：Default

• 路径：/usr/bin/git（或使用 which git 命令查看实际路径）

配置 SSH 密钥（如果需要 SSH 访问）：

# 生成 SSH 密钥
sudo -u jenkins ssh-keygen -t rsa -b 4096 -C "jenkins@example.com"

# 查看公钥
sudo cat /var/lib/jenkins/.ssh/id_rsa.pub

配置 Git 仓库访问

• 如果使用 HTTPS：

• 在 Jenkins 中配置用户名和密码

• 如果使用 SSH：

• 将生成的公钥添加到 Git 仓库的 SSH 密钥中

测试 Git 配置

# 测试 Git 连接
sudo -u jenkins git ls-remote <repository-url>

常见问题解决

如果遇到权限问题

# 确保 Jenkins 用户有权限访问 Git
sudo chown -R jenkins:jenkins /var/lib/jenkins/.git

如果遇到 SSL 证书问题

# 配置 Git 忽略 SSL 验证（不推荐用于生产环境）
sudo git config --global http.sslVerify false

1. Jenkins 中的 Git 插件：

• 确保安装了 "Git plugin"

• 在 Jenkins 管理界面中检查已安装的插件

• 如果没有安装，可以通过 "Manage Jenkins" > "Manage Plugins" 安装

Git 配置示例

# 配置 Git 使用 HTTPS 代理（如果需要）
sudo git config --global http.proxy http://proxy.example.com:8080

# 配置 Git 使用 SSH 代理（如果需要）
sudo git config --global core.sshCommand 'ssh -i /var/lib/jenkins/.ssh/id_rsa'

Jenkins Pipeline 中的 Git 使用示例

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                git branch: 'main',
                    url: 'https://github.com/example/repo.git',
                    credentialsId: 'git-credentials'
            }
        }
    }
}

安全建议：

• 使用 Jenkins 的凭证管理功能存储 Git 凭证

• 定期更新 Git 到最新版本

• 使用 SSH 密钥而不是密码认证

• 限制 Jenkins 用户的权限

性能优化：

• 配置 Git 的缓存

• 使用浅克隆（shallow clone）减少下载时间

• 配置 Git 的压缩级别