第1篇：入门启航篇 —— 从零搭建你的第一个 Jenkins 服务#

1.1 大白话讲透什么是 CI/CD#

你肯定经常听到 CI/CD 这个高大上的缩写，全称是 Continuous Integration (持续集成) 和 Continuous Delivery/Deployment (持续交付/部署)。别被名词唬住，我们用大白话来解释：

• CI（持续集成）：就像是汽车流水线上的质检环节。多个程序员每天都在提交代码，CI 会自动把大家的代码拉取下来，自动编译、自动运行单元测试。一旦有人提交了有 Bug 的代码，系统立马亮红灯报警。它的核心目的是：尽早发现问题，防止代码在合并时发生冲突。
• CD（持续交付/部署）：就像是流水线上的打包发货环节。测试通过的代码，会自动打包成可执行文件（比如 Jar 包、Docker 镜像），甚至直接自动发布到测试环境或生产环境的服务器上。它的核心目的是：让软件随时保持可发布的状态，解放运维双手。

1.2 传统手工部署 vs CI/CD 自动化部署：痛点对比#

在没有 Jenkins 的年代，发布一个新版本通常是这样的：

核心价值

自动化部署不仅是为了“偷懒”，更是为了标准化和消除人为失误。机器不会因为疲劳而敲错命令，但人会。

1.3 Jenkins 是什么？为什么它是 CI/CD 的主流工具？#

Jenkins 是一个开源的、基于 Java 开发的持续集成工具。为什么在 GitLab CI、GitHub Actions、Drone CI 等众多现代工具层出不穷的今天，Jenkins 依然稳坐头把交椅？

1. 极其恐怖的插件生态：拥有数千个插件，无论你是用 Git、SVN，还是想部署到 Docker、K8s、AWS、阿里云，甚至发个钉钉/微信通知，都有现成的插件支持。
2. 极高的可定制性：通过 Pipeline（流水线）脚本，你可以把极度复杂的部署逻辑用代码写出来（Pipeline as Code）。
3. 完全免费且成熟：经历了十几年的市场检验，遇到任何报错，搜索引擎上都能找到解决方案。

1.4 本系列学习路线 + 前置基础说明#

• 学习路线：环境搭建（本篇） -> Freestyle 项目实战 -> Pipeline 流水线语法详解 -> 集成 Git/Maven/Docker 完整部署项目 -> 进阶分布式构建与权限管理。
• 前置基础：需要你具备基本的 Linux 命令行操作知识，了解一点点 Docker 的基本概念。

2.1 前置环境要求#

• 系统：Linux（推荐 CentOS/Ubuntu）、Windows 或 macOS。
• 硬件配置：强烈建议至少 2GB 以上内存。Jenkins 基于 Java，运行时比较吃内存，1GB 内存的轻量云服务器极易出现 OOM（内存溢出）导致服务崩溃。

2.2 方式一：Docker 一键安装（推荐，零依赖踩坑少）#

这是目前最主流、最干净的安装方式，不污染宿主机环境，强烈推荐新手使用。

1
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
2
systemctl enable --now docker

1
# 1. 创建宿主机的数据挂载目录
2
mkdir -p /opt/jenkins_home
3

4
# 2. 赋予权限（极其重要！见下方警告）
5
chown -R 1000:1000 /opt/jenkins_home
6

7
# 3. 启动 Jenkins 容器
8
docker run -d \
9
  --name jenkins \
10
  -p 8080:8080 \
11
  -p 50000:50000 \
12
  -v /opt/jenkins_home:/var/jenkins_home \
13
  -v /etc/localtime:/etc/localtime:ro \
14
  --restart=always \
15
  jenkins/jenkins:lts

1
docker logs -f jenkins

2.3 方式二：Linux 系统直接安装（CentOS/Ubuntu）#

如果你不想用 Docker，也可以直接在 Linux 上安装。Jenkins 依赖 Java，所以必须先装 JDK。

Ubuntu/Debian 体系：

1
# 1. 安装 JDK 17 (Jenkins 新版要求 Java 11/17)
2
sudo apt update
3
sudo apt install -y openjdk-17-jre
4

5
# 2. 添加 Jenkins 官方密钥和源
6
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
7
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null
8
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
9
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
10
  /etc/apt/sources.list.d/jenkins.list > /dev/null
11

12
# 3. 安装并启动
13
sudo apt update
14
sudo apt install -y jenkins
15
sudo systemctl enable --now jenkins

CentOS/RHEL 体系：

1
# 1. 安装 JDK 17
2
sudo yum install -y java-17-openjdk
3

4
# 2. 添加源
5
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
6
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key
7

8
# 3. 安装并启动
9
sudo yum install -y jenkins
10
sudo systemctl enable --now jenkins

2.4 方式三：Windows 本地安装（适合单机练习）#

如果你只是想在自己的 Windows 电脑上体验一下：

1. 确保电脑已安装 JDK 17。
2. 前往官网下载 jenkins.war 文件。
3. 打开 CMD 或 PowerShell，进入 war 包所在目录，执行：

   1
   java -jar jenkins.war --httpPort=8080
   

4. 保持黑窗口不关闭，浏览器访问 http://localhost:8080 即可。

2.5 避坑指南：防火墙/端口放行常见问题#

无论使用哪种方式，如果启动成功但浏览器无法访问 http://你的IP:8080，99% 是防火墙问题。

• 云服务器（阿里云/腾讯云等）：必须在云控制台的“安全组”中，添加入方向规则，放行 8080 端口。
• 本地虚拟机（CentOS firewalld）：

  1
  firewall-cmd --zone=public --add-port=8080/tcp --permanent
  2
  firewall-cmd --reload
  

• 本地虚拟机（Ubuntu UFW）：

  1
  ufw allow 8080/tcp
  

3.1 解锁 Jenkins：获取初始管理员密码#

页面会提示你输入“管理员密码”（Administrator password）。为了证明你是服务器的主人，Jenkins 在首次启动时生成了一个随机密码存在文件中。

根据页面提示的路径（如果是 Docker 安装，则查看挂载的宿主机目录）：

1
# 如果是 Docker 安装
2
cat /opt/jenkins_home/secrets/initialAdminPassword
3

4
# 如果是 Linux 原生安装
5
cat /var/lib/jenkins/secrets/initialAdminPassword

将终端输出的这一长串字符复制，粘贴到网页中，点击“继续”。

3.2 插件安装选择：新手直接装「推荐插件」#

接下来会进入插件安装页面，有两个选项：

• 安装推荐的插件（Install suggested plugins）：新手无脑选这个，包含了绝大多数常用的基础插件（如 Git, Pipeline, SSH 等）。
• 选择插件来安装（Select plugins to install）：适合老手按需定制。

点击“安装推荐的插件”后，Jenkins 会开始下载。

避坑技巧：插件下载慢/大面积失败怎么办？

由于 Jenkins 的默认插件中心在国外，国内网络下载经常龟速甚至报错。 如果失败，可以刷新页面跳过插件安装，先进入系统。然后修改插件源：

1. 进入 Manage Jenkins (系统管理) -> Plugins (插件管理) -> Advanced settings (高级)。
2. 找到页面底部的 Update Site (升级站点)。
3. 将 URL 替换为清华大学镜像源： https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
4. 点击 Submit 提交后，回到服务器重启 Jenkins（docker restart jenkins 或 systemctl restart jenkins），再次安装即可快步如飞。

3.3 创建管理员账号 + 实例 URL 配置#

插件安装完成后：

1. 创建第一个管理员用户：输入你的账号、密码、全名和邮箱。请务必记住这个账号，后续登录全靠它。
2. 实例配置（Instance Configuration）：系统会让你确认 Jenkins URL（通常就是 http://你的IP:8080/），保持默认点击“保存并完成”。
3. 点击 “开始使用 Jenkins”，进入经典的 Jenkins Dashboard 控制台。

4.1 JENKINS_HOME 核心目录速查表#

进入你的 Jenkins 数据挂载目录，使用 ls -la 可以看到非常多文件。以下是生产环境中你需要重点关注的核心目录和文件：

4.2 目录认知带来的运维启示#

万物皆文件的优势

因为 Jenkins 遵循“万物皆文件”的设计理念，所以在进行全量备份或服务器迁移时非常简单： 你只需要把整个 JENKINS_HOME 目录打包（tar -czvf jenkins_backup.tar.gz /opt/jenkins_home），扔到新服务器上解压，然后重新运行 Docker 容器并挂载该目录，你的 Jenkins 就能做到100% 无缝复原。

5.1 新建一个自由风格项目#

1. 在 Jenkins 首页左侧菜单，点击 新建 Item (New Item)。
2. 任务名称输入：My-First-HelloWorld。
3. 选择 Freestyle project (构建一个自由风格的软件项目)。
4. 点击底部的 确定 (OK)。

5.2 最简配置：添加 Shell 构建步骤#

进入任务的配置页面，向下滚动到 Build Steps (构建步骤) 区域：

1. 点击 Add build step (增加构建步骤) 下拉菜单。
2. 选择 Execute shell (执行 shell)。
3. 在弹出的文本框中，输入一段简单的 Linux 命令：

   1
   echo "====================================="
   2
   echo "Hello World! 欢迎来到 Jenkins 的世界！"
   3
   echo "当前执行构建的用户是："
   4
   whoami
   5
   echo "当前的工作目录是："
   6
   pwd
   7
   echo "====================================="
   

4. 点击页面最底部的 保存 (Save)。

5.3 手动触发构建#

回到任务面板，点击左侧的 Build Now (立即构建)。 你会发现在左下角的 Build History (构建历史) 中，瞬间多了一个 #1，并且旁边有一个小圆球（蓝色或绿色代表成功，红色代表失败）。

5.4 查看构建日志、解读构建结果#

点击 #1 旁边的成功小球，或者点击 #1 后在左侧选择 Console Output (控制台输出)。 你将看到类似如下的日志：

1
Started by user Admin
2
Running as SYSTEM
3
Building in workspace /var/jenkins_home/workspace/My-First-HelloWorld
4
[My-First-HelloWorld] $ /bin/sh -xe /tmp/jenkins890123456.sh
5
+ echo =====================================
6
=====================================
7
+ echo Hello World! 欢迎来到 Jenkins 的世界！
8
Hello World! 欢迎来到 Jenkins 的世界！
9
+ echo 当前执行构建的用户是：
10
当前执行构建的用户是：
11
jenkins
12
+ pwd
13
当前的工作目录是：
14
/var/jenkins_home/workspace/My-First-HelloWorld
15
+ echo =====================================
16
=====================================
17
Finished: SUCCESS

日志解读：

• Started by user Admin：记录了是谁触发了这次任务（方便追溯责任）。
• Building in workspace：Jenkins 会为每个项目分配一个独立的工作空间目录（Workspace）。
• 脚本执行过程及结果清晰可见，最后打印 Finished: SUCCESS 表示整个流水线毫无报错地执行完毕。