2021-11-21 06:18:06
环境准备
确保宝塔面板已安装并运行(建议使用最新版本)。
服务器需配置 Java 环境(Jenkins 依赖 Java 8 或更高版本)。
在宝塔面板的“软件商店”中搜索 JDK,选择 OpenJDK 8/11 安装。
安装完成后,通过命令 java -version 验证是否成功。
通过宝塔安装 Jenkins
在宝塔面板的“软件商店”中搜索 Jenkins,点击“安装”。
安装完成后,记录自动生成的 访问地址(如 http://服务器IP:端口,默认端口为 8080)。
若端口冲突,可在宝塔毕祥的“安全”模块中放行新端口,或通过 Jenkins 配置文件修改端口。
初始化 Jenkins
首次访问 Jenkins 时,需解锁页面:
根据提示,通过命令 cat /root/.jenkins/secrets/initialAdminPassword 获取管理员密码(路径可能因安装方式不同而变化)。
选择安装插件方式:
推荐:选择“安装建议插件”,自动安装常用插件(如 Git、Pipeline、SSH 等)。
设置管理员账号和密码,完成初始化。
全局工具配置
进入 Jenkins 后台,依次点击 系统管理 → 全局工具配置孝数答:
JDK:取消勾选“自动安装”,指定宝塔安装的 JDK 路径(如 /usr/java/jdk1.8.0_291)。
Git:填写 Git 安装路径(通过宝塔安装的 Git 路径通常为 /usr/bin/git)。
Maven(如需):若项目使用 Maven 构建,需在此配置本地安装的 Maven 路径。
插件管理
进入 系统管理 → 插件管理:
已安装:检查核心插件巧慧(如 Git、Pipeline、SSH Pipeline Steps)是否已安装。
可选插件:根据需求安装其他插件(如 Docker Pipeline、Kubernetes Plugin 等)。
系统配置
进入 系统管理 → 系统配置:
Jenkins Location:填写 Jenkins 地址和系统管理员邮箱。
SSH Servers(如需远程部署):添加目标服务器的 SSH 信息(IP、用户名、密码/密钥)。
新建任务
点击 Jenkins 首页的 新建任务,输入任务名称,选择 构建一个自由风格的软件项目(或 Pipeline 项目,适合复杂流程)。
源码管理配置
在“源码管理”选项卡中选择 Git:
填写仓库 URL(如
添加认证信息(用户名密码或 SSH 密钥)。
指定分支(如 main 或 */develop)。
构建触发器
根据需求选择触发方式:
轮询 SCM:定期检查代码变更(如 H/5 * * * * 表示每 5 分钟检查一次)。
GitHub/GitLab Webhook:配置代码仓库的 Webhook,推送代码时自动触发构建。
构建环境与步骤
构建环境:勾选“删除工作空间旧文件”避免冲突。
构建步骤:
执行 Shell:编写构建命令(如 mvn clean package 或 npm install && npm run build)。
复制文件到服务器:通过 Send files or execute commands over SSH 插件将构建产物(如 JAR 包、静态文件)传输到目标服务器。
构建后操作
可配置邮件通知、归档构建产物、触发下游任务等。
创建 Pipeline 项目
新建任务时选择 Pipeline,在“Pipeline 脚本”区域编写 Jenkinsfile(或从 SCM 读取)。
示例 Jenkinsfile
持续集成(CI)
每次代码提交后自动触发构建和测试,通过单元测试、代码扫描(如 SonarQube)确保质量。
持续交付(CD)
构建成功后自动部署到测试环境,通过人工审核后进一步部署到生产环境。
分布式构建
在 系统管理 → 节点管理 中添加从节点(如其他服务器或 Docker 容器),将构建任务分发到多台机器以加速流程。
查看构建日志
进入任务页面,点击具体构建记录查看详细日志,快速定位问题。
性能优化
清理旧构建记录(系统管理 → 磁盘空间清理)。
使用 Build Timeout Plugin 限制构建时间,避免长时间卡顿。
安全加固
启用 HTTPS(通过宝塔配置 SSL 证书)。
限制匿名访问(系统管理 → 全局安全配置)。
通过以上步骤,您可以在宝塔面板中快速搭建 Jenkins 并实现代码的自动化构建、测试与部署,结合 Pipeline 和插件进一步扩展功能,满足复杂项目的需求。