Rocky Linux 8.5下Jenkins CI/CD部署与优化指南-代码聚汇网

Rocky Linux 8.5下Jenkins CI/CD部署与优化指南

Rongrong姐·2026-08-06·阅读 27 GEO检测（免费）

JenkinsCI/CDRocky Linux

|难度：普通|阅读约 31 分钟

1. 项目概述

在当今DevOps实践中，持续集成与持续交付(CI/CD)已成为现代软件开发的标配。作为CI/CD领域的"瑞士军刀"，Jenkins凭借其强大的插件生态和灵活性，依然是大多数团队的首选工具。本文将基于Rocky Linux 8.5这一企业级Linux发行版，详细讲解Jenkins从部署到优化的全流程，特别关注跨平台构建和容器化支持这两个实际生产中的关键需求。

Rocky Linux作为RHEL的替代品，继承了其稳定性和企业级特性，非常适合作为CI/CD的基础操作系统。而Jenkins 2.0引入的Pipeline-as-Code理念，使得我们可以将整个构建、测试、部署流程代码化，实现真正的版本控制和可重复性。本文将涵盖从基础环境准备到高级优化技巧的全套方案。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与Jenkins安装

2.1 Rocky Linux 8.5基础配置

在开始安装Jenkins前，我们需要确保系统环境准备妥当：

bash复制# 更新系统
sudo dnf update -y

# 安装基础工具
sudo dnf install -y wget curl git vim java-11-openjdk-devel

# 设置时区（根据实际情况调整）
sudo timedatectl set-timezone Asia/Shanghai

# 禁用SELinux（生产环境需谨慎）
sudo setenforce 0
sudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config

# 配置防火墙
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

注意：生产环境中如需保持SELinux启用，需要额外配置Jenkins相关策略，这超出了本文范围。

2.2 Jenkins安装与初始化

Rocky Linux 8.5的官方仓库不包含Jenkins，我们需要添加Jenkins官方仓库：

bash复制# 导入Jenkins仓库密钥
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

# 添加Jenkins仓库
sudo wget -O /etc/yum.repos.d/jenkins.repo \
    https://pkg.jenkins.io/redhat-stable/jenkins.repo

# 安装Jenkins
sudo dnf install -y jenkins

# 启动Jenkins服务
sudo systemctl enable --now jenkins

安装完成后，通过浏览器访问http://<服务器IP>:8080完成初始设置。首次启动时，Jenkins会在/var/lib/jenkins/secrets/initialAdminPassword生成一个随机密码用于解锁。

2.3 推荐插件安装

初始设置时，建议选择"安装推荐插件"，这将包括：

Pipeline：Jenkins的核心流水线功能
Git：源代码管理集成
Docker：容器化构建支持
Blue Ocean：现代化的用户界面
Credentials Binding：安全凭证管理

3. Jenkins基础配置优化

3.1 系统配置调整

登录后进入"Manage Jenkins" > "Configure System"，建议进行以下调整：

执行器数量：根据CPU核心数设置（通常为核心数×2）
Jenkins URL：设置为实际的访问地址
全局属性：添加以下环境变量：
- MAVEN_OPTS=-Xmx1024m -XX:MaxPermSize=512m
- DOCKER_HOST=unix:///var/run/docker.sock

3.2 安全配置

启用矩阵权限：在"Configure Global Security"中，选择"Matrix-based security"
创建专用用户：为每个团队成员创建独立账号
配置代理：如果需要访问外部资源，在"Manage Plugins" > "Advanced"中配置代理

3.3 工具配置

在"Global Tool Configuration"中配置：

JDK：自动安装或指定已安装的JDK路径
Git：确保Git可执行文件路径正确（通常为/usr/bin/git）
Maven/Gradle：根据需要安装并配置

4. Pipeline基础与跨平台支持

4.1 Pipeline基础语法

Jenkins Pipeline支持两种语法：

Declarative Pipeline：结构化更强，适合简单流程
Scripted Pipeline：更灵活，适合复杂逻辑

示例Declarative Pipeline：

groovy复制pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Deploy') {
            steps {
                sh 'mvn deploy'
            }
        }
    }
}

4.2 跨平台构建实现

要实现跨平台构建（如同时支持Linux和Windows），可以使用节点标签：

groovy复制pipeline {
    agent none
    stages {
        stage('Build on Linux') {
            agent { label 'linux' }
            steps {
                sh 'make'
            }
        }
        stage('Build on Windows') {
            agent { label 'windows' }
            steps {
                bat 'msbuild'
            }
        }
    }
}

要设置Windows节点：

在Windows机器上安装Java
下载jenkins-agent.jar
通过JNLP或SSH连接到Jenkins master

4.3 参数化构建

使Pipeline支持参数输入：

groovy复制pipeline {
    parameters {
        string(name: 'VERSION', defaultValue: '1.0', description: 'Release version')
        choice(name: 'ENV', choices: ['dev', 'test', 'prod'], description: 'Deploy environment')
    }
    // 其余部分...
}

5. 容器化构建与部署

5.1 Docker集成配置

安装Docker：

bash复制sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker
sudo usermod -aG docker jenkins

在Jenkins中配置Docker：

安装"Docker Pipeline"插件
在"Manage Credentials"中添加Docker Hub凭证

5.2 在Pipeline中使用Docker

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

5.3 Kubernetes集成

对于更复杂的容器编排需求，可以集成Kubernetes：

安装"Kubernetes"插件
配置Kubernetes云：
- 在"Manage Jenkins" > "Manage Nodes and Clouds"中添加Kubernetes配置
- 提供kubeconfig文件或直接连接参数

示例Kubernetes Pod模板：

groovy复制podTemplate {
    containers {
        containerTemplate(name: 'maven', image: 'maven:3.8.4-jdk-11', ttyEnabled: true)
        containerTemplate(name: 'golang', image: 'golang:1.18', ttyEnabled: true)
    }
}

6. 高级优化技巧

6.1 并行执行优化

groovy复制stage('Parallel Tests') {
    parallel {
        stage('Unit Test') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Integration Test') {
            steps {
                sh 'mvn verify -Pintegration'
            }
        }
    }
}

6.2 缓存优化

Maven本地仓库缓存：

groovy复制stage('Build') {
    steps {
        dir('/home/jenkins/.m2/repository') {
            // 如果有共享存储，可以在这里挂载
        }
        sh 'mvn clean package'
    }
}

Docker层缓存：

dockerfile复制# 将不经常变动的依赖放在前面
COPY pom.xml .
RUN mvn dependency:go-offline

COPY src/ src/
RUN mvn package

6.3 通知与监控

邮件通知：

groovy复制post {
    always {
        emailext body: '''$DEFAULT_CONTENT''',
            subject: '''$DEFAULT_SUBJECT''',
            to: '''team@example.com'''
    }
}

Prometheus监控：

安装"Prometheus Metrics"插件
暴露/prometheus端点

7. 常见问题排查

7.1 权限问题

症状：构建失败，报权限错误

解决方案：

bash复制sudo chown -R jenkins:jenkins /var/lib/jenkins
sudo setfacl -R -m u:jenkins:rwx /path/to/directory

7.2 内存不足

症状：Jenkins频繁崩溃或响应慢

解决方案：

调整JVM参数：

bash复制# 编辑/etc/sysconfig/jenkins
JENKINS_JAVA_OPTIONS="-Xms1g -Xmx2g -XX:MaxPermSize=512m"

限制并行构建数量

7.3 插件冲突

症状：某些功能突然失效
解决方案：
1. 在"Manage Plugins" > "Advanced"中查看错误日志
2. 尝试禁用最近更新的插件
3. 使用jenkins-plugin-cli工具管理插件

8. 安全加固建议

定期备份：

bash复制# 备份Jenkins主目录
tar -czvf jenkins-backup.tar.gz /var/lib/jenkins

更新策略：

定期检查并更新Jenkins和插件
订阅Jenkins安全公告

网络隔离：

将Jenkins master放在内网
通过反向代理暴露必要端口

凭证管理：

使用Jenkins的Credentials Binding
避免在Pipeline中硬编码敏感信息

9. 性能调优实战

9.1 JVM调优

编辑/etc/sysconfig/jenkins：

bash复制JENKINS_JAVA_OPTIONS="-Xms2g -Xmx4g -XX:MaxMetaspaceSize=512m -XX:+UseG1GC -XX:ParallelGCThreads=4"

关键参数说明：

-Xms和-Xmx：堆内存初始和最大值
-XX:MaxMetaspaceSize：元空间大小
-XX:+UseG1GC：使用G1垃圾收集器
-XX:ParallelGCThreads：GC线程数

9.2 数据库优化

默认使用H2数据库，对于大型实例建议迁移到MySQL：

创建数据库：

sql复制CREATE DATABASE jenkins CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL ON jenkins.* TO 'jenkins'@'%' IDENTIFIED BY 'password';

配置Jenkins使用MySQL：

安装"Database"插件
在/var/lib/jenkins/config.xml中添加：

xml复制<dataSource>jdbc:mysql://localhost:3306/jenkins</dataSource>

9.3 构建代理优化

使用轻量级代理：考虑使用JNLP代理而非SSH
静态代理与动态代理结合：关键节点使用静态代理，临时任务使用动态代理
资源限制：为每个构建设置资源限制

10. 扩展与集成

10.1 与GitLab集成

安装"GitLab"插件
配置Webhook：
- 在GitLab项目的"Settings" > "Webhooks"中添加Jenkins URL
- 格式：http://jenkins.example.com/project/<project-name>

10.2 与SonarQube集成

安装"SonarQube Scanner"插件
配置SonarQube服务器：
- 在"Manage Jenkins" > "Configure System"中添加SonarQube服务器
在Pipeline中使用：

groovy复制stage('SonarQube Analysis') {
    steps {
        withSonarQubeEnv('SonarQube') {
            sh 'mvn sonar:sonar'
        }
    }
}

10.3 与Artifactory集成

安装"Artifactory"插件
配置Artifactory服务器
在Pipeline中使用：

groovy复制stage('Publish') {
    steps {
        rtServer (
            id: "artifactory",
            url: "http://artifactory.example.com",
            credentialsId: "artifactory-cred"
        )
        rtMavenDeployer (
            id: "deployer",
            serverId: "artifactory",
            releaseRepo: "libs-release-local",
            snapshotRepo: "libs-snapshot-local"
        )
        rtMavenRun (
            resolverId: "deployer",
            goals: "clean install deploy"
        )
    }
}

11. 备份与恢复策略

11.1 定期备份方案

创建备份脚本/usr/local/bin/jenkins-backup.sh：

bash复制#!/bin/bash
BACKUP_DIR="/backup/jenkins"
TIMESTAMP=$(date +%Y%m%d%H%M%S)

# 停止Jenkins服务
sudo systemctl stop jenkins

# 创建备份
tar -czvf $BACKUP_DIR/jenkins_$TIMESTAMP.tar.gz \
    --exclude=/var/lib/jenkins/workspace \
    /var/lib/jenkins \
    /etc/sysconfig/jenkins \
    /etc/init.d/jenkins

# 启动Jenkins服务
sudo systemctl start jenkins

# 保留最近7天备份
find $BACKUP_DIR -name "jenkins_*.tar.gz" -mtime +7 -exec rm {} \;

添加到cron任务：

bash复制0 2 * * * /usr/local/bin/jenkins-backup.sh

11.2 灾难恢复步骤

在新服务器上安装相同版本的Jenkins
停止Jenkins服务
恢复备份：

bash复制tar -xzvf jenkins_backup.tar.gz -C /

启动Jenkins服务

11.3 配置即代码(JCasC)

使用Jenkins Configuration as Code插件管理配置：

安装"Configuration as Code"插件
创建配置文件/var/lib/jenkins/jenkins.yaml
示例配置：

yaml复制jenkins:
  systemMessage: "Jenkins Configured as Code"
  numExecutors: 4
  scmCheckoutRetryCount: 2

12. 监控与日志管理

12.1 日志配置

调整日志级别：

进入"Manage Jenkins" > "System Log"
添加新的日志记录器，例如：
- 名称：hudson.model.Computer
- 级别：FINE

12.2 Prometheus监控

安装"Prometheus Metrics"插件
暴露指标端点：/prometheus
配置Prometheus抓取：

yaml复制scrape_configs:
  - job_name: 'jenkins'
    metrics_path: '/prometheus'
    static_configs:
      - targets: ['jenkins.example.com:8080']

12.3 ELK日志收集

配置Filebeat收集Jenkins日志：

yaml复制filebeat.inputs:
- type: log
  paths:
    - /var/log/jenkins/jenkins.log
output.elasticsearch:
  hosts: ["elasticsearch:9200"]

在Kibana中创建可视化仪表板

13. 多分支流水线实践

13.1 多分支Pipeline配置

创建新的"Multibranch Pipeline"项目
配置源代码仓库
在仓库根目录添加Jenkinsfile

示例Jenkinsfile：

groovy复制pipeline {
    agent any
    options {
        timeout(time: 1, unit: 'HOURS')
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
    }
    post {
        success {
            slackSend channel: '#builds', message: "Build succeeded: ${env.BRANCH_NAME}"
        }
    }
}

13.2 分支策略

主分支：仅允许合并请求，自动部署到测试环境
特性分支：自动触发构建和单元测试
发布分支：自动部署到预生产环境

13.3 PR构建验证

在GitHub/GitLab中配置：

安装"GitHub Pull Request Builder"或"GitLab Merge Request"插件
配置Webhook
在Jenkinsfile中添加特定于PR的stage：

groovy复制stage('PR Verification') {
    when {
        changeRequest()
    }
    steps {
        sh 'mvn verify -Ppr'
    }
}

14. 大规模部署架构

14.1 主从架构

主节点：只处理UI请求和调度
构建节点：专门执行构建任务
配置方法：
- 进入"Manage Jenkins" > "Manage Nodes and Clouds"
- 添加新节点，选择"Permanent Agent"

14.2 基于Kubernetes的动态扩展

安装"Kubernetes"插件
配置Kubernetes云：

yaml复制clouds:
- kubernetes:
    name: "kubernetes"
    serverUrl: "https://kubernetes.default"
    namespace: "jenkins"
    jenkinsUrl: "http://jenkins.example.com"
    containerCap: 10
    templates:
    - name: "maven"
      label: "maven"
      containers:
      - name: "jnlp"
        image: "jenkins/inbound-agent:4.3-4"
      - name: "maven"
        image: "maven:3.8.4-jdk-11"
        command: "cat"
        ttyEnabled: true

14.3 地理分布式部署

在不同区域设置构建代理

使用标签区分代理：

groovy复制agent {
    label 'region-east || region-west'
}

考虑网络延迟，设置就近的制品仓库

15. 最佳实践总结

Pipeline代码管理：
- 将Jenkinsfile与源代码一起版本控制
- 使用共享库避免重复代码
安全实践：
- 定期轮换凭证
- 使用RBAC控制访问
- 审计插件权限
资源管理：
- 为每个构建设置资源限制
- 监控构建队列长度
可观测性：
- 收集构建指标
- 设置合理的告警阈值
灾难恢复：
- 定期测试恢复流程
- 文档化关键步骤

在Rocky Linux上运行Jenkins的额外优势是其与RHEL的兼容性，这意味着：

长期稳定的更新支持
更好的安全补丁管理
企业级硬件支持
与现有RHEL工具的兼容性

实际部署中，我发现以下配置特别重要：

为/var/lib/jenkins使用高性能存储
调整Jenkins的GC参数以减少停顿
为不同的项目团队设置独立的文件夹和权限

对于容器化构建，建议：

使用固定版本的构建镜像
定期扫描镜像中的漏洞
考虑使用Kaniko等无守护进程的构建工具

最后，Jenkins的灵活性既是优势也是挑战。建议团队：

制定统一的Pipeline标准
建立共享库减少重复工作
定期审查和优化构建流程
监控关键指标如构建时间和成功率