Jenkins 下载安装与使用

简介

Jenkins 是一个开源的自动化服务器，用于自动化构建、测试和部署软件项目。它支持多种编程语言和构建工具，是持续集成/持续部署(CI/CD)的核心工具。

主要特性

支持多种编程语言和构建工具
丰富的插件生态系统
分布式构建支持
实时构建状态监控
详细的构建报告和日志

系统要求

最低要求

Java: JDK 8 或更高版本
内存: 256MB 可用内存
磁盘空间: 1GB 可用空间

下载安装

方法一：使用安装包（推荐）

Windows 安装

访问 Jenkins 官网
下载 Windows 安装包 (.msi 文件)
双击运行安装程序
按照安装向导完成安装
安装完成后，Jenkins 将作为 Windows 服务自动启动

Linux 安装

# Ubuntu/Debian
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo apt-key add -
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt-get update
sudo apt-get install jenkins

# CentOS/RHEL
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key
sudo yum install jenkins

方法二：使用 Docker

# 拉取 Jenkins 镜像
docker pull jenkins/jenkins:lts

# 运行 Jenkins 容器
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

方法三：使用 WAR 文件

下载 Jenkins WAR 文件
确保已安装 Java
运行命令：

java -jar jenkins.war --httpPort=8080

初始配置

1. 启动 Jenkins

安装完成后，Jenkins 通常会自动启动。如果没有，可以手动启动：

Windows:

# 启动服务
net start jenkins

# 或通过服务管理器启动
services.msc

Linux:

# 启动服务
sudo systemctl start jenkins
sudo systemctl enable jenkins

# 检查状态
sudo systemctl status jenkins

2. 访问 Jenkins

打开浏览器，访问 http://localhost:8080
等待 Jenkins 初始化完成

3. 获取初始管理员密码

Windows:

C:\Program Files\Jenkins\secrets\initialAdminPassword

Linux:

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

4. 安装推荐插件

输入初始管理员密码
选择"安装推荐的插件"
等待插件安装完成

5. 创建管理员账户

设置管理员用户名和密码
配置 Jenkins URL（通常保持默认）
完成初始设置

基本使用

1. 创建第一个任务

点击"新建任务"
输入任务名称
选择任务类型（如"自由风格的软件项目"）
点击"确定"

2. 配置构建

在任务配置页面中：

源代码管理:

选择 Git 或 SVN
输入仓库 URL
配置分支

构建触发器:

轮询 SCM
定时构建
远程触发

构建步骤:

执行 Shell 脚本
执行 Windows 批处理
调用 Maven 目标
调用 Gradle 脚本

构建后操作:

发送邮件通知
归档构建产物
发布测试报告

3. 执行构建

在任务页面点击"立即构建"
查看构建进度
查看构建日志和结果

插件管理

安装插件

进入"管理 Jenkins" > "插件管理"
选择"可选插件"标签
搜索需要的插件
勾选插件并点击"安装"

常用插件推荐

Git Integration: Git 集成
Pipeline: 流水线支持
Blue Ocean: 现代化界面
Credentials Binding: 凭据管理
SSH Agent: SSH 代理
Docker Pipeline: Docker 支持
SonarQube Scanner: 代码质量分析
JUnit: 单元测试报告

更新插件

进入"管理 Jenkins" > "插件管理"
选择"可更新"标签
选择要更新的插件
点击"下载并在重启后安装"

构建项目

1. 自由风格项目

适用于简单的构建任务：

// 构建步骤示例
echo "开始构建..."
mvn clean install
echo "构建完成"

2. 流水线项目

使用 Jenkinsfile 定义构建流程：

pipeline {
    agent any

    stages {
        stage('检出代码') {
            steps {
                checkout scm
            }
        }

        stage('构建') {
            steps {
                sh 'mvn clean compile'
            }
        }

        stage('测试') {
            steps {
                sh 'mvn test'
            }
            post {
                always {
                    junit '**/target/surefire-reports/*.xml'
                }
            }
        }

        stage('部署') {
            steps {
                sh 'mvn deploy'
            }
        }
    }

    post {
        always {
            cleanWs()
        }
    }
}

3. 多分支流水线

自动为每个分支创建构建任务：

创建多分支流水线项目
配置分支源（Git、SVN 等）
在代码仓库根目录添加 Jenkinsfile
Jenkins 自动扫描分支并创建任务

安全配置

1. 用户管理

进入"管理 Jenkins" > "管理用户"
创建新用户账户
设置用户权限

2. 权限配置

进入"管理 Jenkins" > "全局安全配置"
启用安全选项
配置授权策略（如"基于角色的策略"）

3. 凭据管理

进入"管理 Jenkins" > "管理凭据"
添加 SSH 密钥、用户名密码等凭据
在构建任务中使用凭据

监控和维护

1. 系统监控

查看系统信息：管理 Jenkins > 系统信息
查看系统日志：管理 Jenkins > 系统日志
监控磁盘使用情况

2. 备份和恢复

# 备份 Jenkins 数据
tar -czf jenkins_backup.tar.gz /var/lib/jenkins

# 恢复 Jenkins 数据
tar -xzf jenkins_backup.tar.gz -C /

3. 性能优化

定期清理构建历史
配置构建保留策略
使用分布式构建
优化插件使用

常见问题

1. Jenkins 无法启动

问题: Jenkins 服务启动失败 解决方案:

检查 Java 版本是否兼容
检查端口是否被占用
查看错误日志

2. 插件安装失败

问题: 插件下载或安装失败 解决方案:

检查网络连接
更新 Jenkins 版本
手动下载插件文件

3. 构建失败

问题: 构建任务执行失败 解决方案:

查看构建日志
检查依赖项
验证构建脚本

4. 内存不足

问题: Jenkins 运行缓慢或崩溃 解决方案:

增加 JVM 堆内存
清理构建历史
优化构建配置

5. 权限问题

问题: 无法访问文件或执行命令 解决方案:

检查文件权限
配置用户权限
使用适当的凭据

最佳实践

1. 项目组织

使用有意义的项目名称
按团队或功能分组
使用视图组织项目

2. 构建优化

使用并行构建
缓存依赖项
优化构建脚本

3. 安全考虑

定期更新 Jenkins
使用 HTTPS
限制用户权限
定期备份数据

4. 监控告警

配置构建失败通知
监控系统资源
设置健康检查