Jenkins 部署依赖项清单

准备部署 Jenkins？别急着动手。一份清晰的依赖项清单，能帮你避开不少“坑”。下面这份清单，涵盖了从核心运行到离线环境的方方面面，咱们按图索骥，逐一核对。

一 核心运行依赖

这是 Jenkins 能“跑起来”的基石，缺一不可。

• Ja va 运行时：这是 Jenkins 的“心脏”。当前推荐使用 JDK 17 或 JDK 21（新版本 Jenkins 建议 JDK 17+；部分老版本仍兼容 Ja va 11）。安装后，务必正确设置 JA VA_HOME 与 PATH 环境变量，这是很多启动失败的根源。
• Jenkins 程序包：获取方式很灵活：
  • 传统方式：直接下载 jenkins.war 包，用 ja va -jar jenkins.war 命令启动。
  • 系统包管理：在 Debian/Ubuntu 或 RHEL/CentOS 等系统上，使用官方仓库安装，管理起来更方便。
  • 容器化：直接拉取官方 jenkins/jenkins:lts Docker 镜像运行，环境最干净。
• Servlet 容器（可选）：Jenkins 自带 Jetty 服务器，开箱即用。当然，你也可以将其部署到 Apache Tomcat 或 GlassFish 等外部容器中。
• 操作系统与硬件：主流系统都支持，包括 Linux（如 Ubuntu 18.04+、CentOS 7+、RHEL 7+）、Windows 10+ 和 macOS 10.14+。硬件方面，起步建议至少 2 核 CPU、4GB 内存和 50GB 存储空间。如果是生产环境，这个配置还得往上提。

二 构建与代码拉取工具

光能运行还不够，Jenkins 的核心任务是构建。这就得为它准备好“工具链”。

• Git：源码拉取的基础。确保 Git 可执行文件在系统的 PATH 环境变量中，让 Jenkins 能找到它。
• 构建工具：根据项目技术栈来定。
  • Ja va 项目常用 Ma ven（推荐 3.8.x 及以上版本）或 Gradle。
  • 关键一步：记得在 Jenkins 管理后台的“全局工具配置”里，显式地配置好 JDK、Git、Ma ven 等工具的安装路径，别让 Jenkins 去猜。
• 语言与运行环境（按项目）：这就是“看菜吃饭”了。比如前端或 Node.js 项目需要 Node.js，做自动化脚本或测试可能需要 Python，.NET 项目则离不开 .NET SDK。提前在目标机器或袋里节点上装好。

三 网络与端口依赖

网络不通，一切白搭。这些端口必须畅通。

• 访问端口：
  • 8080/tcp：这是 Web 管理界面的默认入口。
  • 50000/tcp：用于主节点与 Agent（袋里节点）之间的 JNLP 通信。
• 防火墙放行示例（以常见 Linux 发行版为例）：
  • Ubuntu/Debian：执行 sudo ufw allow 8080,50000/tcp。
  • CentOS/RHEL：执行 sudo firewall-cmd --permanent --add-port={8080,50000}/tcp && sudo firewall-cmd --reload。
• 可选端口：如果启用 HTTPS，会用到 8443/tcp；如果涉及 SSH 连接，则需要 22/tcp。