Jenkins部署需要哪些依赖项
小樊
32
2025-12-18 21:58:28
Jenkins 部署依赖项清单
一 核心运行依赖
- Java 运行时：推荐 JDK 17 或 JDK 21（新版本 Jenkins 建议使用 JDK 17+；部分老版本仍支持 Java 11）。需正确设置 JAVA_HOME 与 PATH。
- Jenkins 程序包：
- 传统方式：下载 jenkins.war 直接用 Java 启动；
- 系统包管理：在 Debian/Ubuntu 或 RHEL/CentOS 使用官方仓库安装；
- 容器化：使用 jenkins/jenkins:lts 镜像运行。
- Servlet 容器（可选）：Jenkins 自带 Jetty，也可部署到 Apache Tomcat/GlassFish 等。
- 操作系统与硬件：支持 Linux（Ubuntu 18.04+、CentOS 7+、RHEL 7+）、Windows 10+、macOS 10.14+；建议至少 2 核 CPU、4GB 内存、50GB 存储（生产环境更高）。
二 构建与代码拉取工具
- Git：用于拉取源码；确保可执行文件在 PATH 中。
- 构建工具：
- Java 项目常用 Maven 3.8.x（或 Gradle）；
- 在 Jenkins 的“全局工具配置”中显式配置 JDK、Git、Maven 的安装路径。
- 语言与运行环境（按项目）：如 Node.js（前端/Node 项目）、Python（脚本/测试）、.NET SDK（.NET 项目）等。
三 网络与端口依赖
- 访问端口：默认 8080/tcp（Web 界面）；50000/tcp（Agent/JNLP 通信）。
- 防火墙放行示例：
- Ubuntu/Debian：
ufw allow 8080,50000/tcp
- CentOS/RHEL：
firewall-cmd --permanent --add-port={8080,50000}/tcp && firewall-cmd --reload
- 可选端口：8443/tcp（启用 HTTPS 时）、22/tcp（SSH 相关）。
四 权限与安全依赖
- Linux 权限：如通过 sudo 执行 Docker/部署命令，需为 jenkins 用户配置 NOPASSWD 免密（在
/etc/sudoers 中设置）。
- 凭据与插件：
- 必备插件如 Credentials Binding、Git、Maven Integration、SSH 等；
- 权限策略插件如 Role-Based Authorization Strategy；
- 插件存在强依赖，安装时需一并满足依赖版本。
- 安全加固：建议启用 HTTPS、禁用匿名访问、定期备份 JENKINS_HOME。
五 离线环境补充依赖
- 离线安装介质：提前准备 jenkins.war、JDK 安装包、Maven 二进制包、Git 源码/二进制包 等。
- 构建工具链：在目标机离线安装 Maven/Git 及其依赖（如编译 Git 需 gcc 等）。
- 字体库（无头环境）：若出现 Fontconfig head is null 等 AWT/字体错误，安装 fontconfig 或拷贝相应字体文件至 JDK/lib。
- 插件离线安装：
- 在 plugins/ 目录放置所需 .jpi/.hpi 插件及其依赖；
- 或先在联网环境装好同版本插件后，整体拷贝 ~/.jenkins/plugins 目录到离线环境；
- 注意插件版本匹配与依赖顺序。
