HoRain云--Jenkins自动化部署全攻略

本文介绍了Jenkins自动化部署的完整指南，包括两种主流安装方式（传统系统级安装和Docker容器化安装）、核心配置步骤（初始化解锁、插件安装、账户创建等）以及创建第一个自动化部署任务的详细流程。文章还提供了高级优化建议，如使用Docker确保环境一致性、配置Webhook实现自动触发、安全凭据管理等，旨在帮助用户搭建高效可靠的自动化部署流程，提升软件交付效率。

HoRain 云小助手

151人浏览 · 2025-12-01 09:33:32

HoRain 云小助手 · 2025-12-01 09:33:32 发布

🎬 HoRain 云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

通过 Jenkins 实现自动化部署，可以显著提升软件交付的效率与可靠性。下面我将为您梳理一份从环境搭建到实践优化的详细指南。

🚀 Jenkins 安装与部署方式

Jenkins 主要有两种主流的安装方式，您可以根据自身需求选择：

特性	传统系统级安装	Docker容器化安装
适用系统	CentOS, Ubuntu, Debian 等	任何支持 Docker 的系统
隔离性	一般	强
部署速度	较快	极快
维护成本	中	低
推荐场景	传统服务器环境，需深度系统集成	追求快速部署、环境一致性和隔离性的现代架构

传统系统级安装（以 CentOS/Ubuntu 为例）

这种方式直接将 Jenkins 安装到主机系统上。

安装 Java：Jenkins 依赖于 Java 环境，需先安装 OpenJDK 11 或 8 。

# CentOS
sudo yum install java-11-openjdk
# Ubuntu
sudo apt install openjdk-11-jdk

安装 Jenkins：通过包管理器安装 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 install jenkins
# Ubuntu
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 jenkins

启动服务：安装后启动并设置开机自启。

sudo systemctl start jenkins
sudo systemctl enable jenkins

Docker 容器化安装（推荐）

使用 Docker 安装可避免环境冲突，便于迁移和管理。
- 启动 Jenkins 容器：一条命令即可完成部署。
```
docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins_data:/var/jenkins_home jenkins/jenkins:lts
```
  参数说明：-d后台运行，-p映射端口（Web界面和代理通信），-v持久化数据卷。
- 获取初始密码：容器启动后，查看初始管理员密码。
```
docker logs <container_id>  # 或直接查看容器内的密码文件
```

⚙️ 核心配置步骤

无论以何种方式安装，后续的 Web 界面配置流程是相似的。

初始化解锁：浏览器访问 http://<你的服务器IP>:8080，输入初始密码完成解锁。
安装插件：选择“安装推荐插件”或根据项目需要手动安装必备插件，如 Git Plugin、Pipeline Plugin、Docker Plugin 等。
创建管理员账户：设置第一个管理员用户。
配置工具路径：在 Manage Jenkins > Global Tool Configuration 中，配置项目构建所需的工具路径，如 JDK、Git、Maven 等。可以设置自动安装。

🔧 创建你的第一个自动化部署任务

Jenkins 的核心是任务（Job）。以下是创建一个流水线任务的基本步骤。

新建任务：在 Jenkins 主页点击“新建 Item”，输入任务名，选择“Pipeline”类型。
配置流水线：
- 定义 Pipeline：在任务配置页面的“Pipeline”部分，选择“Pipeline script from SCM”。这意味着流水线脚本将由代码仓库中的文件定义。
- 配置仓库：在“SCM”处选择 Git，填入你的代码仓库地址，并配置访问凭据。
- 指定脚本路径：指定仓库中 Jenkinsfile 的路径（默认为 ./Jenkinsfile）。

编写 Jenkinsfile：在代码仓库的根目录创建 Jenkinsfile。这是一个用 Groovy 语法编写的脚本，定义了构建、测试、部署的完整流程。以下是一个简单示例：

pipeline {
    agent any // 指定执行节点
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package' // 构建步骤，例如Maven打包
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test' // 测试步骤
            }
        }
        stage('Deploy') {
            steps {
                sh 'scp target/myapp.jar user@server:/path/to/deploy' // 部署步骤，例如通过SCP传输
            }
        }
    }
}

触发构建：保存任务后，可手动点击“立即构建”，或配置触发器实现代码推送时自动构建。

💡 高级实践与优化建议

使用 Docker 进行构建和部署：在 Jenkinsfile 的 agent部分指定 Docker 镜像，确保每次构建都在一个全新、一致的环境中进行，消除环境差异。
利用 Webhook 实现自动触发：在 Jenkins 中安装 GitHub Webhook 等插件，并在代码仓库（如 GitHub、GitLab）中配置 Webhook。这样一旦有代码推送，仓库会自动通知 Jenkins 触发构建，实现真正的持续集成。
安全与凭据管理：切勿在脚本中硬编码密码。使用 Jenkins 内置的“凭据管理”功能安全地存储 SSH 密钥、数据库密码等，并在 Pipeline 中通过 withCredentials绑定使用。