当前位置：首页 > 资讯 > 系统环境

Jenkins基础教程（10）Jenkins环境搭建：Jenkins环境搭建全攻略：从此告别“它在我电脑上是好的”

时间：2025-11-22 21:36 作者：来源：阅读：0
扫一扫，手机访问

摘要：每次听到开发人员说“它在我电脑上是好的”，运维人员的血压就会升高一点。而Jenkins正是专治这种“本地魔法”的良药。你是否曾经在代码部署到服务器后，遭遇各种诡异问题，然后听到开发人员那句经典名言：“但它在我的电脑上是好的！”？别担心，今天我们要介绍的Jenkins，正是为了解决这种“本地魔法”而生的自动化神器。作为一名开发者，我清楚地记得第一次使用Jenkins后，那种“早知道就好了”的

每次听到开发人员说“它在我电脑上是好的”，运维人员的血压就会升高一点。而Jenkins正是专治这种“本地魔法”的良药。

你是否曾经在代码部署到服务器后，遭遇各种诡异问题，然后听到开发人员那句经典名言：“但它在我的电脑上是好的！”？别担心，今天我们要介绍的Jenkins，正是为了解决这种“本地魔法”而生的自动化神器。

作为一名开发者，我清楚地记得第一次使用Jenkins后，那种“早知道就好了”的懊悔与喜悦交织的复杂感受——再也不用手动编译、打包、上传、部署了，一切都交给Jenkins自动完成！

🤔 什么是Jenkins？为什么你需要它？

Jenkins是一款开源自动化服务器，是全球范围内最流行的持续集成和持续交付（CI/CD） 工具。它就像一个不知疲倦的构建助手，每次当你提交代码到共享仓库时，它会自动构建、集成和测试代码。

Jenkins的核心价值：

早期问题发现：自动检测错误和bug，避免问题累积到后期。团队协作增强：自动获取最新代码并触发构建，及时通知构建结果。部署速度提升：通过自动化流程，实现快速、频繁的部署。

想象一下，你刚提交了一段代码到Git仓库，几分钟后，Jenkins自动拉取代码、运行测试、构建项目、部署到测试环境，并发送邮件告诉你结果——而你只需要喝杯咖啡☕！

🛠️ 准备工作：选择合适的Jenkins安装方式

在开始安装之前，我们需要根据自身情况选择最合适的安装方式。Jenkins提供了多种安装选项，就像挑选合适的工具才能事半功倍。

系统要求：

操作系统：支持Linux、Windows和macOS等主流系统。Java环境：Jenkins运行在Java虚拟机上，建议使用Java 8或更高版本。推荐安装OpenJDK 11。磁盘空间：至少预留1GB可用空间（Docker部署建议10GB以上）。内存：最低256MB，生产环境推荐1GB以上。

下面是三种常见的Jenkins安装方式对比，帮助你做出明智选择：

安装方式	优点	缺点	适用场景
传统系统安装	性能好，直接控制	需要手动配置环境	生产环境、有系统管理经验
Docker安装	环境隔离，一键部署	需要学习Docker基础	开发测试、快速体验
WAR包安装	灵活，无需系统权限	需自行管理Java环境	临时测试、自定义环境

💻 传统系统安装Jenkins（以Linux为例）

对于生产环境，传统系统安装通常能提供更好的性能和可控性。以下是详细的安装步骤：

1. 安装Java环境

Jenkins依赖于Java，首先需要安装合适的Java环境：



# Ubuntu/Debian 系统
sudo apt update
sudo apt install -y openjdk-11-jdk
 
# 验证安装
java -version
 
# 配置JAVA_HOME环境变量
echo "export JAVA_HOME=$(readlink -f /usr/bin/javac | sed 's:/bin/javac::')" >> ~/.bashrc
source ~/.bashrc

2. 添加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

3. 启动Jenkins服务

安装完成后，需要启动Jenkins服务并设置为开机自启：



# 启动Jenkins服务
sudo systemctl start jenkins
 
# 设置开机自启
sudo systemctl enable jenkins
 
# 查看服务状态
sudo systemctl status jenkins

如果一切正常，最后一个命令会显示"active (running)"。

4. 配置防火墙

如果系统启用了防火墙，需要开放Jenkins的默认端口（8080）：



# Ubuntu (使用ufw)
sudo ufw allow 8080
sudo ufw enable
 
# CentOS (使用firewalld)
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

🐳 使用Docker安装Jenkins（推荐新手）

如果你想要一个干净、隔离的环境，或者想快速体验Jenkins，Docker是最佳选择。只需一条命令：


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

参数解释：

-d

：后台运行容器


--name=jenkins

：为容器指定一个名称


-p 8080:8080

：将容器的8080端口映射到主机8080端口（Web界面）


-p 50000:50000

：用于代理连接


-v /home/jenkins_home:/var/jenkins_home

：将Jenkins数据目录挂载到主机，保证数据持久化

注意：首次运行会自动下载Docker镜像，这可能需要几分钟时间。

🚀 初始配置：解锁你的Jenkins世界

无论采用哪种安装方式，完成安装后都需要进行初始配置。

1. 访问并解锁Jenkins

打开浏览器，访问 http://你的服务器IP:8080。首次访问时，Jenkins会要求输入初始管理员密码。

获取初始密码的方法：



# 传统系统安装
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
 
# Docker安装
docker logs jenkins

2. 安装插件

接下来会提示安装插件。建议选择"Install suggested plugins"（安装推荐插件），这会自动安装Git、Maven、Pipeline等常用插件。

如果网络环境受限导致插件安装失败，可以切换至国内镜像源：

进入 Manage Jenkins > Plugin Manager > Advanced在"Update Site"处填写清华镜像源：


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

保存后重试安装

3. 创建管理员用户

插件安装完成后，需要创建一个管理员账户。建议使用强密码并妥善保存凭证。

⚙️ 基础配置：打造得心应手的Jenkins

Jenkins初始配置完成后，还需要进行一些基础设置，让它更好地为你服务。

配置全局工具

进入 Manage Jenkins > Global Tool Configuration，配置开发工具：

JDK：添加JDK，取消"自动安装"，手动指定JDK路径（如


/usr/lib/jvm/java-11-openjdk-amd64

）。Maven：添加Maven，指定名称和路径。Git：添加Git，指定Git可执行文件路径（如


/usr/bin/git

）。

性能优化

如果你的服务器资源有限，可以通过以下方式优化Jenkins性能：

调整JVM内存：编辑配置文件（Ubuntu：


/etc/default/jenkins

，CentOS：


/etc/sysconfig/jenkins

），修改JAVA_OPTS：


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

限制并发构建数：进入 Manage Jenkins > Configure System，修改"Number of executors"（如设置为2），避免资源过度占用。

🏃‍♀️ 创建你的第一个Jenkins项目：Hello World流水线

现在到了最激动人心的部分——创建第一个Jenkins项目！我们将创建一个简单的自由风格项目，展示基本的自动化流程。

1. 创建新项目

在Jenkins首页，点击"New Item"，输入项目名称"MyFirstJob"，选择"Freestyle project"，点击"OK"。

2. 配置源代码管理

在项目配置页面，找到"Source Code Management"部分：

选择"Git"在Repository URL处填写你的代码仓库地址，例如：


https://github.com/your-repository.git

3. 配置构建触发器

在"Build Triggers"部分，可以选择何时自动触发构建：

Poll SCM：定时检查代码更新，如


H/5 * * * *

表示每5分钟检查一次。Webhook：代码推送到仓库时自动触发，更适合实时构建。

4. 添加构建步骤

在"Build"部分，点击"Add build step"，选择"Execute shell"（Linux）或"Execute Windows batch command"（Windows），然后输入构建命令：



echo "=== 开始构建 ==="
echo "当前目录："
pwd
echo "文件列表："
ls -la
echo "Java版本："
java -version
echo "=== 构建完成 ==="

5. 保存并构建

点击"Save"保存配置，返回项目页面后点击"Build Now"开始手动构建。构建完成后，点击构建号查看"Console Output"，可以观看构建的详细输出。

恭喜你！ 你已经成功创建并运行了第一个Jenkins任务！虽然它现在只是输出一些基本信息，但已经奠定了自动化流程的基础。

📜 进阶技巧：使用Jenkinsfile定义流水线

自由风格项目简单易用，但对于复杂的项目，推荐使用Jenkins Pipeline，它使用Jenkinsfile定义整个CI/CD流程。

创建一个名为"Jenkinsfile"的文件，内容如下：



pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                git url: 'https://github.com/your-repository.git', branch: 'main'
            }
        }
        stage('Build') {
            steps {
                echo 'Building...'
                sh 'mvn clean install'
            }
        }
        stage('Test') {
            steps {
                echo 'Testing...'
                sh 'mvn test'
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploying...'
                sh 'scp target/*.jar user@production-server:/path/to/deploy'
            }
        }
    }
    post {
        always {
            echo '构建完成'
        }
        success {
            mail to: 'team@example.com', subject: "构建成功 #${BUILD_NUMBER}", body: "恭喜！构建成功完成。"
        }
        failure {
            mail to: 'team@example.com', subject: "构建失败 #${BUILD_NUMBER}", body: "注意！构建失败，请及时检查。"
        }
    }
}

这个流水线定义了四个明确的阶段：检出代码、构建项目、运行测试和部署。无论成功与否，都会发送通知邮件。

要使用此流水线，只需在创建项目时选择"Pipeline"类型，然后在Pipeline部分选择"Pipeline script from SCM"，指定包含Jenkinsfile的代码仓库即可。