Jenkins基础教程（32）配置Jenkins 服务器：配置Jenkins服务器，给你的薪资来个火箭般提升！

最新推荐文章于 2025-11-24 16:27:21 发布

原创最新推荐文章于 2025-11-24 16:27:21 发布 · 354 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#jenkins #服务器 #运维

Jenkins基础教程专栏收录该内容

205 篇文章

订阅专栏

还在手动部署测试环境？Jenkins自动化部署让你从等待的苦海中解脱，成为团队中的效率之星。

Jenkins简介：不只是个“构建工具”

简单来说，Jenkins是一个开源的自动化服务器，用于实现持续集成（CI）和持续交付（CD）流程。但它远不止于此！

想象一下，Jenkins就像是你在数字世界的忠实助手，7x24小时不间断地监控你的代码仓库。一旦有代码变更，它会立即自动开始构建、测试和部署工作。你再也不用手动完成那些重复性任务，就像拥有了一个不知疲倦的机器人同事。

Jenkins的强大源于其丰富的插件生态系统，几乎可以与任何现代开发工具链集成：Git、Docker、Kubernetes、各种编程语言和测试框架。

前期准备：选择合适的Jenkins部署方式

在开始安装Jenkins之前，我们需要根据实际需求选择合适的部署方式。

环境要求：

操作系统：Jenkins支持多种操作系统，包括Linux、Windows和macOS。
Java环境：Jenkins运行在Java虚拟机上，建议使用Java 8或更高版本。
网络环境：确保Jenkins服务器可以访问互联网，以便下载插件和依赖项。

选择部署方式：

传统安装：直接在物理机或虚拟机上安装Jenkins，适合长期稳定使用的场景。
Docker容器部署：适合需要快速部署、隔离环境和灵活迁移的场景。这也是目前最流行的方式之一。
云平台部署：利用云服务商提供的Jenkins解决方案，简化运维管理。

对于大多数初学者和个人项目，我推荐使用Docker部署方式，因为它简单、干净且易于管理。对于企业级生产环境，则可能需要考虑传统安装或云平台方案。

实战：使用Docker部署Jenkins服务器

接下来，让我们一步步通过Docker方式启动一个Jenkins服务器。

第一步：启动Jenkins容器

打开终端，执行以下命令：

docker run -d --name=jenkins -p 8080:8080 -p 50000:50000 -v /your/home:/var/jenkins_home jenkins:2.7.2-alpine

这个命令做了以下几件事：

-d：以后台模式运行容器。
-name=jenkins：给容器命名为“jenkins”，方便管理。
-p 8080:8080：将容器的8080端口映射到主机的8080端口，用于Web访问。
-p 50000:50000：映射50000端口，用于Jenkins代理连接。
-v /your/home:/var/jenkins_home：将容器内的Jenkins数据目录挂载到主机目录，确保数据持久化。
jenkins:2.7.2-alpine：使用小巧的Alpine Linux版本的Jenkins镜像。

如果你已经启动过Jenkins容器，只需要使用以下命令即可重新启动：

docker stop jenkins
docker start jenkins

第二步：初始设置

容器启动后，在浏览器中访问 http://localhost:8080（如果Jenkins安装在远程服务器上，请将localhost替换为服务器IP地址）。
第一次访问时，Jenkins会要求输入初始管理员密码。这个密码可以在容器的日志中找到：

docker logs jenkins

在日志输出中查找一长串随机生成的密码，将其复制粘贴到Jenkins页面的密码字段中。

接下来，选择安装推荐的插件或自定义选择插件。对于初学者，建议安装推荐的插件，这些插件涵盖了大多数常用功能。
最后，创建第一个管理员用户账户，填写用户名、密码等信息。

恭喜！现在你已经拥有了一个属于自己的Jenkins服务器。但这只是个开始，接下来我们要让它变得真正有用。

配置Jenkins系统设置

登录Jenkins后，点击左侧菜单的**"Manage Jenkins"**（管理Jenkins），进入系统配置。

配置工具路径

在**"Global Tool Configuration"**（全局工具配置）部分，我们需要配置开发工具路径：

JDK：添加JAVA_HOME路径或让Jenkins自动安装。
Git：确保Git可执行文件路径正确，以便Jenkins可以从代码仓库拉取代码。
Maven/Gradle：根据项目需要配置构建工具。

这些工具可以配置为自动安装，这样Jenkins会在需要时自动下载和设置它们，特别适合在多个代理节点上保持环境一致性。

配置系统选项

在**"Configure System"**（系统配置）中，你可以设置：

Jenkins URL：设置Jenkins服务器的访问地址。
执行者数量：控制Jenkins主节点可以同时运行多少个构建任务。根据服务器CPU核心数合理设置。
安静期：设置在SCM触发构建后等待多少秒才开始执行，避免在快速连续提交时触发多次构建。

理解Jenkins架构：主节点与代理节点

在配置任务之前，理解Jenkins的架构很重要。Jenkins采用主从架构，其中主节点（Master）负责管理任务调度、界面展示和插件管理，而代理节点（Agent/Slave）负责执行具体的构建任务。

为什么使用代理节点？

资源隔离：构建任务可能消耗大量CPU和内存资源，使用代理可以避免影响主节点稳定性。
多环境支持：可以在不同操作系统和环境的代理上运行构建任务，例如同时支持Windows、Linux和macOS平台。
并行构建：多个代理可以同时执行不同的构建任务，大幅提升效率。

在实际生产中，主节点应该只管理代理节点，而不执行任何构建任务。所有构建任务都应该分配给代理节点执行。

创建你的第一个Jenkins流水线任务

现在来到最激动人心的部分——创建Jenkins任务！我们将重点介绍流水线（Pipeline）任务，这是目前最强大、最灵活的任务类型。

什么是流水线？

流水线是一系列自动化步骤的集合，定义了从代码提交到部署的完整流程。它使用代码（具体是Jenkinsfile）来定义流程，因此可以像其他源代码一样进行版本控制。

流水线代码可以写在Jenkins的Web界面中，但最佳实践是将其存储在代码仓库的Jenkinsfile中。这样做有诸多好处：

代码评审/迭代流水线
流水线的审计跟踪
流水线的单一可信数据源，可由项目的多个成员查看和编辑

创建基础流水线任务

点击Jenkins首页的**"New Item"**（新建任务）。
输入任务名称，选择**"Pipeline"**（流水线）类型，然后点击OK。
在配置页面中，滚动到**"Pipeline"**（流水线）部分。
在**"Definition"（定义）下拉菜单中选择"Pipeline script"**（流水线脚本）。
在脚本文本框中，输入以下基础流水线脚本：

pipeline {
    agent any
    
    stages {
        stage('Checkout') {
            steps {
                echo 'Checking out source code...'
                // 实际使用时这里会是git命令，例如：
                // git url: 'https://github.com/your-repository.git', branch: 'main'
            }
        }
        stage('Build') {
            steps {
                echo 'Building...'
                // 这里可以调用Maven、Gradle或其他构建工具
                // sh 'mvn clean install'
            }
        }
        stage('Test') {
            steps {
                echo 'Testing...'
                // 运行测试套件
                // sh 'mvn test'
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploying....'
                // 部署到测试环境或生产环境
            }
        }
    }
    
    post {
        always {
            echo 'Pipeline finished.'
            // 这里可以添加构建后操作，如发送通知邮件
        }
        success {
            echo 'Pipeline succeeded!'
        }
        failure {
            echo 'Pipeline failed!'
        }
    }
}

点击**"Save"（保存），然后点击"Build Now"**（立即构建）来运行你的第一个流水线。

这个简单的流水线展示了四个基本阶段：检出代码、构建、测试和部署。每个阶段包含一个简单的回声命令，在实际使用中，你会将这些步骤替换为实际的构建、测试和部署命令。

进阶示例：真实的Jenkinsfile

下面是一个更接近真实项目的Jenkinsfile示例，它使用Docker容器作为构建环境，并集成了常见的构建步骤：

pipeline {
    agent {
        docker {
            image 'maven:3.7.3-openjdk-17'
            args '-v $HOME/.m2:/root/.m2' // 缓存Maven依赖
        }
    }
    
    stages {
        stage('Checkout') {
            steps {
                git url: 'https://github.com/your-username/your-project.git', 
                    branch: 'main',
                    credentialsId: 'your-git-credential-id'
            }
        }
        
        stage('Build') {
            steps {
                sh 'mvn clean compile'
            }
        }
        
        stage('Unit Test') {
            steps {
                sh 'mvn test'
            }
            post {
                always {
                    junit 'target/surefire-reports/*.xml' // 收集测试结果
                }
            }
        }
        
        stage('Integration Test') {
            steps {
                sh 'mvn verify -Pintegration-tests'
            }
        }
        
        stage('Build Package') {
            steps {
                sh 'mvn package -DskipTests'
            }
        }
        
        stage('Deploy to Test') {
            when {
                branch 'main'
            }
            steps {
                sh 'scp target/*.war user@test-server:/path/to/deploy'
                // 或者使用Docker、Kubernetes等现代部署方式
            }
        }
    }
    
    post {
        always {
            emailext (
                subject: "Build #${BUILD_NUMBER} - ${currentBuild.result}",
                body: """
                Project: ${JOB_NAME}
                Build: #${BUILD_NUMBER}
                Status: ${currentBuild.result}
                Build URL: ${BUILD_URL}
                """,
                to: "dev.team@example.com"
            )
        }
        changed {
            emailext (
                subject: "Build Status Changed - ${JOB_NAME} - ${currentBuild.result}",
                body: "Build status changed to ${currentBuild.result}",
                to: "dev.team@example.com"
            )
        }
    }
}

这个流水线示例做了更多实际工作：

使用Docker容器作为构建环境，确保环境一致性。
通过凭据ID安全地访问Git仓库，避免在代码中硬编码密码。
包含多个测试阶段，并收集测试结果。
使用条件部署（仅当在main分支时部署到测试环境）。
丰富的构建后通知，通过邮件发送构建结果。

配置Jenkins代理节点

要充分发挥Jenkins的威力，我们需要设置代理节点来执行构建任务。

添加永久代理节点

进入**"Manage Jenkins"** > "Manage Nodes and Clouds"。
点击**"New Node"（新建节点），输入节点名称，选择"Permanent Agent"**（永久代理）。
配置节点参数：

- 远程根目录：代理节点上的工作目录路径，如/var/jenkins。
- 启动方式：根据环境选择，常见的有"SSH"、"Java Web Start"等。
- 主机：代理节点的IP地址或主机名。
- 凭据：用于连接代理节点的SSH凭据。

点击Save保存配置。

一旦代理节点连接成功，你可以在流水线中指定在特定代理上运行任务：

pipeline {
    agent {
        label 'linux-slave' // 使用具有此标签的代理节点
    }
    // 其余阶段定义...
}

Jenkins最佳实践与技巧

1. 数据备份策略

定期备份Jenkins数据非常重要。由于我们将Jenkins数据目录挂载到了主机目录，备份变得很简单：

# 备份jenkins_home目录
tar -czf jenkins-backup-$(date +%Y%m%d).tar.gz /your/home

# 恢复时只需解压备份文件到Jenkins数据目录

你也可以使用docker cp命令从容器中提取数据：docker cp $ID:/var/jenkins_home /backup/path。

2. 凭据管理

切勿在流水线脚本中硬编码密码或API密钥！使用Jenkins的凭据管理功能：

进入**"Manage Jenkins"** > "Manage Credentials"。
添加需要存储的凭据（如Git仓库密码、SSH密钥、API令牌等）。
在流水线中通过凭据ID引用：

withCredentials([usernamePassword(
    credentialsId: 'my-git-credential',
    usernameVariable: 'GIT_USERNAME',
    passwordVariable: 'GIT_PASSWORD'
)]) {
    sh 'git push https://${GIT_USERNAME}:${GIT_PASSWORD}@github.com/your-repo.git'
}