Jenkins 2.426.2 LTS Docker 部署：3步配置国内插件源与8个必备插件清单

Jenkins 2.426.2 LTS Docker 部署：3步配置国内插件源与8个必备插件清单

1. 为什么需要优化Jenkins Docker部署？

当你第一次完成Jenkins的基础Docker部署后，可能会遇到两个主要问题：插件下载速度极慢，以及面对海量插件时的选择困难。这两个问题直接影响着Jenkins的使用体验和团队的工作效率。

在国内网络环境下，默认的Jenkins插件源服务器位于国外，下载速度往往只有几十KB/s，一个中等大小的插件可能需要数分钟才能完成下载。更糟糕的是，当多个插件需要同时下载时，这种延迟会被放大，导致初始化配置过程变得异常漫长。

另一个常见问题是插件选择。Jenkins拥有超过1800个官方插件，但并非所有插件都适合每个团队。选择错误的插件不仅浪费资源，还可能导致系统不稳定或安全风险。

2. 3步快速配置国内插件源

2.1 进入Jenkins容器内部

首先，我们需要进入正在运行的Jenkins容器内部执行配置命令：

docker exec -it myjenkins bash

这里的myjenkins应替换为你实际的容器名称。如果忘记容器名称，可以使用docker ps命令查看。

2.2 替换默认插件源

进入容器后，执行以下命令序列来替换插件源：

cd /var/jenkins_home/updates sed -i 's#https://updates.jenkins.io/download#https://mirrors.tuna.tsinghua.edu.cn/jenkins#g' default.json sed -i 's#http://www.google.com#https://www.baidu.com#g' default.json

这个操作会将官方插件源替换为清华大学的镜像源，同时将Google的链接替换为百度，避免因Google不可访问导致的检查失败。

2.3 修改更新中心配置

继续执行以下命令修改更新中心配置：

cd /var/jenkins_home sed -i 's#https://updates.jenkins.io/update-center.json#https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json#g' hudson.model.UpdateCenter.xml

完成后退出容器并重启Jenkins服务：

exit docker restart myjenkins

3. 8个必备插件清单与配置要点

3.1 插件安装方法

在Jenkins管理界面安装插件有两种推荐方式：

  1. Web界面安装：

    • 导航到"Manage Jenkins" > "Plugins" > "Available plugins"
    • 搜索插件名称并勾选安装

  2. 通过plugins.txt批量安装： 创建一个plugins.txt文件，内容如下：

blueocean:1.27.9 pipeline-utility-steps:2.15.0 docker-workflow:1.29 git:4.14.3 configuration-as-code:1.59 role-strategy:3.3 build-timeout:1.24 ssh-slaves:1.32.0

然后使用以下命令安装：

docker cp plugins.txt myjenkins:/var/jenkins_home/ docker exec myjenkins jenkins-plugin-cli -f /var/jenkins_home/plugins.txt

3.2 核心插件功能解析

插件名称版本主要功能配置要点
Blue Ocean1.27.9提供现代化UI和可视化流水线安装后访问/blue路径
Pipeline Utility Steps2.15.0增强流水线文件处理能力特别适合JSON/YAML处理
Docker Pipeline1.29在流水线中使用Docker需配置Docker主机连接
Git4.14.3Git版本控制集成配置全局Git路径和凭据
Configuration as Code1.59通过YAML配置Jenkins创建jenkins.yaml配置文件
Role-based Strategy3.3细粒度权限控制需手动配置角色和分配
Build Timeout1.24设置构建超时全局或项目级配置
SSH Slaves1.32.0通过SSH管理节点配置SSH密钥和连接信息

3.3 关键插件详细配置

Configuration as Code插件：

这个插件允许你将Jenkins配置存储在YAML文件中，实现配置即代码。创建一个基本的jenkins.yaml配置示例：

jenkins: systemMessage: "Jenkins Configured as Code" numExecutors: 3 unclassified: location: url: http://your-jenkins-url/ adminAddress: admin@example.com credentials: system: domainCredentials: - credentials: - usernamePassword: scope: GLOBAL id: "git-credentials" username: "git-user" password: "secure-password"

将此文件放入/var/jenkins_home目录后，Jenkins会自动应用这些配置。

Docker Pipeline插件使用示例：

pipeline { agent any stages { stage('Build') { agent { docker { image 'maven:3.8.6-jdk-11' args '-v $HOME/.m2:/root/.m2' } } steps { sh 'mvn clean package' } } } }

4. 高级优化与最佳实践

4.1 性能调优建议

  1. JVM参数优化： 在启动容器时添加JVM参数可以显著提升性能：

    docker run -d \ -p 8080:8080 -p 50000:50000 \ --env JAVA_OPTS="-Xms1g -Xmx2g -XX:MaxRAMPercentage=70.0 -Dhudson.slaves.NodeProvisioner.initialDelay=0" \ -v jenkins_home:/var/jenkins_home \ jenkins/jenkins:2.426.2-lts

  2. 定期清理构建历史： 安装Workspace Cleanup插件，或在流水线中添加清理步骤：

    post { always { cleanWs() } }

4.2 安全加固措施

  1. 启用CSRF防护：

    • 进入"Manage Jenkins" > "Configure Global Security"
    • 勾选"Prevent Cross Site Request Forgery exploits"

  2. 配置项目矩阵授权：

    • 安装Role-based Authorization Strategy插件
    • 创建不同角色并分配精确权限

  3. 定期备份策略： 使用ThinBackup插件或简单的cron作业：

    docker exec myjenkins tar czf /var/jenkins_home/backup-$(date +%Y%m%d).tar.gz /var/jenkins_home

4.3 监控与日志管理

  1. Prometheus监控集成： 安装Prometheus metrics插件，暴露监控指标：

    jenkins: metrics: prometheus: enabled: true port: 9936

  2. 日志收集配置： 修改logging.properties文件：

    handlers=java.util.logging.ConsoleHandler jenkins.level=INFO hudson.level=WARNING java.util.logging.ConsoleHandler.level=INFO

  3. 健康检查端点： 添加Docker健康检查：

    docker run -d \ --health-cmd="curl -f http://localhost:8080/login || exit 1" \ --health-interval=30s \ --health-timeout=3s \ --health-retries=3 \ jenkins/jenkins:2.426.2-lts

5. 常见问题解决方案

5.1 插件安装失败处理

当插件安装失败时，可以尝试以下步骤：

  1. 检查网络连接和插件源配置

  2. 清理插件缓存：

    rm -rf /var/jenkins_home/plugins/* /var/jenkins_home/plugins/.lock

  3. 手动下载插件并安装：

    wget https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/plugin-name/version/plugin-name.hpi docker cp plugin-name.hpi myjenkins:/var/jenkins_home/plugins/

5.2 Docker内部使用Docker

要让Jenkins容器能够执行Docker命令，需要绑定Docker socket：

docker run -d \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $(which docker):/usr/bin/docker \ jenkins/jenkins:2.426.2-lts

5.3 时区与语言设置

  1. 设置容器时区：

    docker run -d \ -v /etc/localtime:/etc/localtime:ro \ -v /etc/timezone:/etc/timezone:ro \ jenkins/jenkins:2.426.2-lts

  2. 安装本地化插件： 安装Locale插件，然后在"Manage Jenkins" > "Configure System"中设置"Default Language"为zh_CN

5.4 资源限制与扩展

对于大型团队，建议设置资源限制并考虑水平扩展：

docker run -d \ --memory=4g --cpus=2 \ --env JENKINS_OPTS="--sessionEviction=86400 --sessionTimeout=1440" \ jenkins/jenkins:2.426.2-lts

对于超大规模使用，可以考虑：

  • 使用Jenkins Configuration as Code插件管理多个实例
  • 部署Jenkins Controller + Agent架构
  • 考虑Kubernetes上的Jenkins部署方案