Jenkins基础教程（193）Jenkins自动化部署和持续交付之部署到应用程序服务器上：Jenkins自动化部署：让你的代码坐上司维特，直达生产环境！

原创于 2025-11-26 08:43:48 发布 · 221 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#jenkins #自动化 #服务器

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

199 篇文章

订阅专栏

曾经手动部署代码到凌晨三点的你，会发现Jenkins就像是专属于你的司维特，7x24小时随时待命。

你好，Jenkins！码农的司维特

还记得那些年我们手动部署的痛吗？深夜三点，咖啡已经续了第五杯，你颤抖着双手执行着那些重复了千百遍的操作：拉取代码、编译构建、运行测试、部署服务器…

然后，因为一个不起眼的手误，一切崩盘，你又在困顿中开始了新一轮的debug。这种经历，简直比相亲遇到前任还要尴尬。

但好消息是——Jenkins就像一位不知疲倦的司维特，可以7x24小时帮你完成这些重复劳动。Jenkins是一个开源的自动化服务器，主要用于持续集成和持续交付。

它能够与Git、Docker、Kubernetes等技术无缝集成，是目前最流行的CI/CD工具之一。

简单来说，Jenkins就是你的自动化部署机器人：

你提交代码到Git，它自动开始工作
它负责编译、测试、打包你的应用
它自动部署到测试、预发布或生产环境
它还能监控应用状态，必要时自动回滚

CI/CD：不只是字母组合，而是开发者的福音

在我们深入Jenkins之前，先来搞清楚这两个经常被一起提及的术语：CI和CD。

CI（持续集成）：代码的“每日体检”

持续集成是指开发人员频繁地将代码提交到共享版本控制系统中，通过自动化工具进行构建、测试和验证。

想象一下，如果你的代码每次有小改动都要经历一次全面体检，是不是就能及早发现问题，而不是等到病入膏肓才后悔莫及？

CD（持续交付）：应用的“自动快递”

持续交付则是在CI的基础上，进一步将经过验证的代码自动部署到生产环境或其他指定环境。

这就像是为你的应用设置了一条自动快递线路，一旦代码通过测试，就立即打包发货到服务器，无需人工干预。

为什么你需要CI/CD？因为这四大好处

提升开发效率：通过自动化流程，减少人工操作，加快从代码提交到生产的周期。
降低风险：通过自动化测试和验证，减少人为错误，确保代码质量。
增强团队协作：统一的代码提交和测试流程，促进团队协作。
快速反馈：开发人员能够快速获得代码的测试结果，及时修复问题。

Jenkins安装：让你的机器拥有“自动驾驶”能力

好了，理论部分到此为止。现在让我们动手，给你的机器装上这个叫做Jenkins的“司维特”。

环境准备：打好地基

在开始安装Jenkins之前，需要确保你的环境满足以下要求：

操作系统：Jenkins支持多种操作系统，如Linux、Windows和macOS。
Java环境：Jenkins运行在Java虚拟机上，建议使用Java 8或更高版本。
磁盘空间：至少预留1GB可用空间（Docker部署建议10GB以上）。
内存：最低256MB（生产环境推荐1GB+，避免频繁内存溢出）。

安装Java环境（如果尚未安装）

以Ubuntu/Debian为例，安装OpenJDK 11：

sudo apt update
sudo apt install -y openjdk-11-jdk

验证安装：

java -version  # 输出应包含"openjdk version 11.x.x"

配置JAVA_HOME（全局生效）：

echo "export JAVA_HOME=$(readlink -f /usr/bin/javac | sed 's:/bin/javac::')" >> ~/.bashrc
source ~/.bashrc

Jenkins安装：四种方式，任君选择

方式一：使用包管理器安装（Linux系统）

添加Jenkins官方仓库：

Ubuntu/Debian：

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.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 update
sudo apt install -y jenkins

CentOS：

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.key
sudo yum update
sudo yum install -y jenkins

方式二：使用Docker安装（推荐，简单干净）

docker run -p 8080:8080 -p 50000:50000 --name jenkins -d jenkins/jenkins:lts

方式三：手动安装（适用于所有平台）

下载Jenkins WAR文件并使用Java运行环境启动：

java -jar jenkins.war

启动和初始配置：唤醒你的Jenkins

启动Jenkins服务：

sudo systemctl start jenkins  # 启动服务
sudo systemctl enable jenkins # 设置开机自启
sudo systemctl status jenkins # 查看状态（应显示"active (running)"）

配置防火墙（如果启用）：

Ubuntu（ufw）：

sudo ufw allow 8080
sudo ufw enable

CentOS（firewalld）：

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

解锁Jenkins：拿到“驾驶执照”

首次访问 http://<服务器IP>:8080，需输入初始密码：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword  # 查看密码

输入密码后点击"Continue"，然后选择"Install suggested plugins"（自动安装Git、Maven、Pipeline等常用插件）。

最后，创建管理员用户，填写用户名、密码、邮箱等信息，点击"Save and Finish"，完成初始配置。

恭喜！现在你已经成功安装了Jenkins，相当于拿到了自动化部署的"驾驶执照"。

Pipeline和Jenkinsfile：定义你的“行驶路线”

有了司维特，接下来需要告诉它目的地和行驶路线。在Jenkins中，这就是Pipeline和Jenkinsfile的作用。

Pipeline是什么？你的自动化部署流水线

Jenkins Pipeline是一套插件，支持将整个软件交付流程实现持续集成和持续交付。

它使用代码（通常是Jenkinsfile）来定义自动化流程，使得整个CI/CD过程可以被版本化、代码化和审查。

可以将Pipeline看作是一条生产线，你的代码从原材料（源代码），经过多个工序（阶段），最终变成可交付的产品（部署的应用）。

Jenkinsfile：Pipeline的“设计图纸”

Jenkinsfile是一个文本文件，包含了Pipeline的定义，使用Groovy语法编写。它可以被提交到项目的源代码仓库中，实现"Pipeline as Code"。

Pipeline语法：学会跟Jenkins“说话”

一个基本的Jenkinsfile结构如下：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                // 从版本控制系统拉取代码
            }
        }
        stage('Build') {
            steps {
                // 编译构建代码
            }
        }
        stage('Test') {
            steps {
                // 运行测试
            }
        }
        stage('Deploy') {
            steps {
                // 部署到服务器
            }
        }
    }
}

让我们分解一下这个结构：

pipeline：声明这是一个Pipeline
agent：指定Pipeline在哪里执行，"any"表示任何可用代理
stages：包含一个或多个stage的序列
stage：表示Pipeline的一个阶段，如构建、测试、部署
steps：在一个stage中执行的具体步骤

实战演练：亲手打造自动化部署流水线

理论说了这么多，是时候动手实战了。我们将通过一个完整的示例，演示如何将Java应用自动部署到应用程序服务器。

示例背景：一个简单的Java Web应用

假设我们有一个简单的Java Web应用，使用Maven构建，需要部署到Tomcat服务器。

步骤一：准备Jenkinsfile

在项目根目录创建Jenkinsfile，内容如下：

pipeline {
    agent any
    tools {
        maven 'maven3'  // 需要在Jenkins中配置的Maven工具名称
        jdk 'jdk11'     // 需要在Jenkins中配置的JDK工具名称
    }
    stages {
        stage('Checkout') {
            steps {
                git branch: 'main',
                    url: 'https://github.com/your-username/your-java-app.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean compile'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
            post {
                always {
                    junit 'target/surefire-reports/*.xml'
                }
            }
        }
        stage('Package') {
            steps {
                sh 'mvn package -DskipTests'
            }
        }
        stage('Deploy to Tomcat') {
            steps {
                sh '''
                    # 停止Tomcat
                    sudo systemctl stop tomcat9
                    
                    # 备份旧应用
                    sudo cp /var/lib/tomcat9/webapps/yourapp.war /var/lib/tomcat9/webapps/yourapp.war.bak
                    
                    # 删除旧应用
                    sudo rm -rf /var/lib/tomcat9/webapps/yourapp*
                    
                    # 复制新应用
                    sudo cp target/yourapp.war /var/lib/tomcat9/webapps/
                    
                    # 启动Tomcat
                    sudo systemctl start tomcat9
                    
                    # 等待应用启动
                    sleep 30
                '''
            }
        }
    }
    post {
        success {
            emailext (
                subject: "SUCCESS: Pipeline ${env.JOB_NAME} - ${env.BUILD_NUMBER}",
                body: "构建成功！应用已部署到服务器。\n检查地址：http://yourserver:8080/yourapp",
                to: "dev-team@yourcompany.com"
            )
            slackSend(color: "good", message: "构建 ${env.JOB_NAME} - ${env.BUILD_NUMBER} 成功！")
        }
        failure {
            emailext (
                subject: "FAILED: Pipeline ${env.JOB_NAME} - ${env.BUILD_NUMBER}",
                body: "构建失败！请检查：${env.BUILD_URL}",
                to: "dev-team@yourcompany.com"
            )
            slackSend(color: "danger", message: "构建 ${env.JOB_NAME} - ${env.BUILD_NUMBER} 失败！")
        }
    }
}

步骤二：配置Jenkins任务

在Jenkins控制台中，导航至"新建项"。
选择"流水线"并为项目命名。
在"配置"页面中，选择"Pipeline script from SCM"作为Pipeline定义。
选择Git作为SCM，并填写你的代码仓库URL。
指定Jenkinsfile的路径（默认为Jenkinsfile）。
点击"保存"。

步骤三：触发构建

保存后，你可以手动触发第一次构建：

返回项目页面
点击"立即构建"
观察Pipeline执行情况，查看各个阶段的日志

进阶功能：让部署更智能

1. 参数化构建：增加部署灵活性

让你的Pipeline接受参数，实现更灵活的部署：

properties([
    parameters([
        choice(
            choices: ['dev', 'staging', 'production'],
            description: '选择部署环境',
            name: 'ENVIRONMENT'
        ),
        string(
            defaultValue: 'latest',
            description: '部署版本',
            name: 'VERSION'
        ),
        booleanParam(
            defaultValue: false,
            description: '是否跳过测试',
            name: 'SKIP_TESTS'
        )
    ])
])

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                git branch: params.VERSION,
                    url: 'https://github.com/your-username/your-java-app.git'
            }
        }
        // 其他阶段根据参数进行调整
    }
}

2. 使用Docker实现环境一致性

通过Docker容器化部署，确保环境一致性：

stage('Docker Build') {
    steps {
        script {
            docker.build("yourapp:${env.BUILD_ID}")
        }
    }
}
stage('Docker Deploy') {
    steps {
        script {
            // 停止并删除旧容器
            sh 'docker stop yourapp || true'
            sh 'docker rm yourapp || true'
            // 运行新容器
            sh "docker run -d --name yourapp -p 8080:8080 yourapp:${env.BUILD_ID}"
        }
    }
}

故障排除：当司维特“迷路”时的自救指南

即使是世界上最可靠的司维特，偶尔也会迷路。以下是一些常见的Jenkins问题及其解决方案：

1. 插件安装失败

症状：插件下载缓慢或安装失败。

解决方案：更换国内镜像源。

进入"Manage Jenkins" > "Plugin Manager" > "Advanced"，修改"Update Site"为：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

2. 内存不足

症状：构建过程中出现OutOfMemoryError。

解决方案：增加JVM内存。

编辑Jenkins配置文件（/etc/sysconfig/jenkins或/etc/default/jenkins），修改JAVA_OPTS：

JAVA_OPTS="-Xmx2048m -Xms1024m"  # 分配2GB最大内存、1GB初始内存

然后重启Jenkins服务：

sudo systemctl restart jenkins

3. 权限问题

症状：Pipeline执行命令时权限不足。

解决方案：将Jenkins用户添加到sudoers（谨慎使用）：

sudo usermod -aG sudo jenkins

或者更安全的方式：只为特定命令配置权限：

# 在/etc/sudoers.d/jenkins中添加：
jenkins ALL=(ALL) NOPASSWD: /bin/systemctl stop tomcat9, /bin/systemctl start tomcat9

4. 端口冲突

症状：Jenkins启动失败，端口被占用。

解决方案：修改Jenkins端口。

编辑配置文件（/etc/sysconfig/jenkins或/etc/default/jenkins），修改HTTP_PORT：

HTTP_PORT=8081

然后重启Jenkins服务。

最佳实践：老司机的经验之谈

为了让你的Jenkins之旅更加顺畅，这里有一些老司机总结的经验：

1. 代码化一切

将Pipeline定义为Jenkinsfile并存储在源代码库中
使用版本控制管理Jenkinsfile的变更
将服务器配置也代码化（如使用Dockerfile、Ansible等）

2. 保持构建快速

并行执行独立任务
使用增量构建避免重复工作
合理使用缓存（如Maven依赖、Node模块）

3. 安全第一

定期更新Jenkins和插件
使用凭据管理敏感信息，不要在Pipeline中硬编码密码
限制权限，遵循最小权限原则

4. 监控和优化

定期检查构建历史和日志
监控Jenkins服务器性能（CPU、内存、磁盘）
清理旧构建数据释放磁盘空间

结语：拥抱自动化，告别加班

通过本文，你已经掌握了Jenkins的核心概念、安装配置、Pipeline编写和实战技巧。现在，是时候告别手动部署的苦日子，拥抱自动化部署的未来了！

记住，Jenkins只是一个工具，真正的价值在于它为你节省的时间和精神健康。把这些宝贵资源投入到更有创造性的工作中，比如写更优雅的代码，或者…准时下班享受生活？

毕竟，作为一名开发者，你的价值不在于你能多晚下班部署代码，而在于你能写出多么稳定、优雅、不需要深夜加班部署的代码。

祝你部署愉快，准时下班！