在目前的软件开发流程中，自动化部署已经成为团队标配。把代码推送到Git仓库后，自动触发构建并发布到目标服务器，能够大幅减少人工操作失误并显著提升交付效率。这篇教程将以实操为主线，带你从零开始使用Jenkins配合Git完成一次完整的自动化部署。内容聚焦核心步骤，避开冗长理论，确保你看完就能直接上手配置。
环境准备与基础安装
开始前需要确保你的服务器已安装Linux系统、Java运行环境以及基础网络连通性。推荐直接使用Docker一键拉起Jenkins，或者通过官方提供的war包部署。安装完成后访问服务器的8080端口，按页面提示解锁系统并完成初始管理员注册。与此同时，你需要准备一台或多台目标应用服务器，并在上面安装Git客户端。务必在Jenkins所在服务器生成SSH密钥对，并将公钥添加到目标服务器的authorized_keys文件中，这样才能实现免密拉取代码和上传文件。先用命令行手动测试一次clone和scp操作，确认链路畅通后再进入Jenkins配置阶段。
配置Git凭据与依赖插件
进入Jenkins后台，打开系统管理页面，在插件管理中找到并安装Git插件以及Publish Over SSH插件。插件安装完成后返回主页，点击凭据管理，选择系统级别的全局凭据，新建一个SSH类型的凭据。在用户名校验处填入服务器登录账号，将之前生成的私钥完整粘贴到Key区域，注意不要有多余空格或换行。保存后该凭据就会出现在后续任务的配置列表中。这一步决定了整个流程的安全性与连通性，许多新手部署失败都是因为私钥格式错误或权限未正确赋予，务必仔细核对。
创建自由风格任务与源码配置
点击首页新建任务，输入名称后选择自由风格项目。进入配置页面向下滚动找到源码管理模块，勾选Git并在仓库地址栏填入你的项目链接。在凭据下拉菜单中选择刚创建的SSH密钥。分支 specifier 通常填写*/master或*/main，根据实际主分支调整。接着配置构建触发器，如果希望开发者推送代码后立即触发，可以配置Webhook回调；若追求简单稳定，直接选择轮询SCM，表达式填写H/5 * * * *，表示每五分钟检查一次代码变更。对于日常维护的小项目，轮询方式最不容易出错且无需额外配置网关。
编写构建脚本与部署映射
在构建环节选择执行Shell，这里需要填写拉取代码后的处理逻辑。首先进入工作空间目录，执行rm命令清理历史残留文件。随后调用git pull fetch origin main && git reset --hard FETCH_HEAD来强制同步最新代码，避免本地缓存导致版本错乱。如果你的项目包含静态资源，直接cp -r dist/* /var/www/html即可覆盖。若是后端服务，则补充对应的编译命令如mvn clean install。完成构建后，在高级选项中找到Send files or execute commands over SSH，填写目标IP、端口与根目录路径，传输工具推荐选用Sftp以保证断点续传能力。在源文件匹配规则中输入build/output/**，目标路径设为/var/app/release，最后勾选Run only if build succeeds，在远程命令栏写入systemctl restart your-service-name。保存后点击立即构建，控制台会逐行打印执行状态。
排错技巧与长期维护建议
部署过程中难免遇到网络中断或权限拦截。若Git拉取报认证失败，检查私钥是否被剪贴板截断，或尝试在Jenkins全局工具配置中重新导入。SSH传输缓慢时可开启Compression选项，或将大体积日志排除在同步范围外。频繁构建会导致磁盘堆积，建议在高级设置中勾选Discard old builds，保留最近十个构建记录即可。为了保障生产环境安全，建议将Jenkins置于内网并通过Nginx反向代理暴露，同时开启双因素验证。熟练这套流程后，你可以逐步过渡到Pipeline流水线模式，用Groovy脚本替代图形化配置，让任务结构更清晰可控。自动化部署的核心在于不断试错与复盘，多看控制台红色报错定位根因，很快就能建立起稳定高效的发布节奏。
