Jenkins 安装部署完整教程：JDK 配置、插件加速与中文界面

十二月 04, 2021 2140

Jenkins 简介

Jenkins 是一个用 Java 编写的开源持续集成工具，提供软件开发的持续集成服务，支持自动化构建、测试和部署流程。

官方地址

Jenkins 安装部署

1. 安装 JDK

Jenkins 推荐安装 JDK 11

1
2
3
4
5
6
7
8
# 下载 JDK
wget https://download.java.net/openjdk/jdk11/ri/openjdk-11+28_linux-x64_bin.tar.gz

# 解压 JDK 到 /opt 目录
tar -zxvf openjdk-11+28_linux-x64_bin.tar.gz -C /opt

# 配置环境变量
vim /etc/profile

在 /etc/profile 底部追加以下内容：

1
2
3
export JAVA_HOME=/opt/jdk-11
export CLASSPATH=.:${JAVA_HOME}/lib
export PATH=${PATH}:${JAVA_HOME}/bin
1
2
3
4
5
# 使环境变量生效
source /etc/profile

# 验证 Java 版本
java -version

安装成功后输出示例：

1
2
3
openjdk version "11" 2018-09-25
OpenJDK Runtime Environment 18.9 (build 11+28)
OpenJDK 64-Bit Server VM 18.9 (build 11+28, mixed mode)

2. 下载 Jenkins

根据自己实际情况在官网下载

本文使用 Debian 系统，具体安装步骤参考官方文档。

3. 启动 Jenkins

1
sudo service jenkins start

若启动报错：

1
2
Job for jenkins.service failed because the control process exited with error code.
See "systemctl status jenkins.service" and "journalctl -xe" for details.

这通常是因为 /etc/init.d/jenkins 文件找不到 JDK 路径，需要手动指定：

1
2
3
4
5
6
7
8
9
10
11
# 打开 jenkins 启动脚本
sudo vim /etc/init.d/jenkins

# 在 PATH 变量中加入 Java 的路径（改为你自己的实际路径）
PATH=/bin:/usr/bin:/sbin:/usr/sbin:/opt/jdk-11/bin

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 重新启动 Jenkins
sudo service jenkins start

4. 访问 Jenkins

在浏览器中访问 http://IP:8080 进入 Jenkins 页面。

若出现以下报错：

1
2
AWT is not properly configured on this server. Perhaps you need to run your container with
"-Djava.awt.headless=true"? See also: https://www.jenkins.io/redirect/troubleshooting/java.awt.headless

这是因为系统缺少字体库，根据自己的系统安装对应工具。

Debian/Ubuntu 系统执行以下命令：

1
2
3
4
5
6
7
8
9
10
11
12
# 安装字体配置工具（通常安装这一个即可）
sudo apt-get install fontconfig

# 若仍有问题，继续安装以下依赖
sudo apt-get install ttf-dejavu
sudo apt-get install xvfb

# 刷新字体缓存
fc-cache --force

# 重启 Jenkins
sudo service jenkins restart

刷新页面后可以看到 Jenkins 初始化界面：

安装 Jenkins安装 Jenkins

按照页面提示找到初始密码并继续安装。

5. 初始化配置

  • 选择 安装推荐的插件 并等待安装完成，插件安装失败可以跳过，后续按需安装
  • 根据需要创建管理员账号，或直接使用默认的 admin 账号
  • 进入 Jenkins 后建议修改 admin 密码：admin → Configure → 拉到底部修改密码

更换国内插件源（加速插件下载）：

进入 Manage Jenkins → Manage Plugins → Advanced，将 Update Site 地址修改为：

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

切换中文界面：

安装插件 Localization: Chinese (Simplified) 即可将界面切换为中文。

以上就是 Jenkins 的完整安装流程，如有问题欢迎在下方评论。

查看评论