零代码搞定ET框架服务端部署:Jenkins CI/CD全流程指南
零代码搞定ET框架服务端部署:Jenkins CI/CD全流程指南
【免费下载链接】ET Unity3D Client And C# Server Framework 项目地址: https://gitcode.com/GitHub_Trending/et/ET
ET框架作为Unity3D客户端与C#服务端一体化解决方案,其服务端部署往往让新手望而却步。本文将带你通过Jenkins实现零代码自动化部署,从环境配置到一键发布,全程可视化操作,让持续集成变得简单高效!
📋 准备工作:环境与工具清单
在开始前,请确保你的开发环境已满足以下条件:
- 已安装Jenkins(推荐LTS版本)
- 已配置Git环境并能访问仓库
- 服务器已安装.NET Core SDK
- 项目已通过
git clone https://gitcode.com/GitHub_Trending/et/ET获取到本地
开发工具配置示例
Unity外部工具配置界面可帮助你关联必要的开发环境,确保CI流程中能正确调用相关工具:
图1:Unity External Tools配置界面,可设置脚本编辑器及版本控制工具路径
🔧 Jenkins基础配置:3步完成初始化
1. 安装必要插件
进入Jenkins控制台 → 插件管理,搜索并安装以下插件:
- Git Plugin
- MSBuild Plugin
- Pipeline Plugin
- Credentials Binding Plugin
2. 配置全局工具
在系统管理 → 全局工具配置中设置:
- Git:指定git可执行文件路径
- MSBuild:添加.NET Core SDK路径(通常为
/usr/share/dotnet/dotnet) - NodeJS:若项目需要前端构建,配置对应版本
3. 添加凭证
在系统管理 → 凭证管理中添加:
- Git仓库访问凭证(推荐使用SSH密钥)
- 服务器部署凭证(根据实际部署方式选择密码或密钥)
🚀 构建CI/CD流水线:可视化配置指南
创建新任务
- 点击Jenkins首页新建任务
- 输入任务名称(如
ET-Server-Deploy) - 选择流水线类型并点击确定
配置流水线
在流水线配置页面,选择定义为"Pipeline script from SCM",然后:
- SCM选择Git,填入仓库URL:
https://gitcode.com/GitHub_Trending/et/ET - 分支指定:通常为
*/main或项目主分支 - 脚本路径:输入
Jenkinsfile(若项目根目录不存在此文件,需手动创建)
配置包管理凭证
某些私有包可能需要认证,可通过类似下图的包管理器配置界面预先设置凭证,确保CI过程中能正常获取依赖:
⚙️ 核心构建步骤:关键配置解析
示例Jenkinsfile结构
以下是基础的Jenkinsfile模板,放置在项目根目录即可自动执行:
pipeline {
agent any
stages {
stage('拉取代码') {
steps {
git url: 'https://gitcode.com/GitHub_Trending/et/ET', branch: 'main'
}
}
stage('构建服务端') {
steps {
sh 'dotnet build ./Server/ET.Server.csproj -c Release'
}
}
stage('部署到服务器') {
steps {
sh 'scp -r ./Server/bin/Release/net6.0/* user@server:/opt/et-server/'
sh 'ssh user@server "systemctl restart et-server"'
}
}
}
post {
success {
slackSend channel: '#deploy-notify', message: 'ET服务端部署成功 ✅'
}
failure {
slackSend channel: '#deploy-notify', message: 'ET服务端部署失败 ❌'
}
}
}
关键配置说明
- 构建命令:使用
dotnet build命令编译服务端项目,对应项目文件路径需根据实际结构调整 - 部署方式:示例使用
scp和ssh命令,实际可替换为FTP、Docker或K8s部署 - 通知机制:通过
slackSend实现部署结果通知,也可替换为邮件或企业微信通知
🔍 常见问题排查指南
构建失败怎么办?
- 检查依赖:确保服务器已安装所有项目依赖,可通过
dotnet restore命令验证 - 权限问题:Jenkins用户需有足够权限执行构建和部署命令
- 路径问题:确认所有文件路径在Jenkins环境中可正确访问
如何实现多环境部署?
通过Jenkins的参数化构建功能,添加环境选择参数(如env=test或env=prod),然后在部署脚本中根据参数选择不同的目标服务器。
🎯 优化建议:让部署更高效
- 缓存依赖:在Jenkinsfile中添加
dotnet restore --no-cache避免重复下载依赖 - 并行构建:使用
parallel语法同时构建客户端和服务端 - 自动化测试:添加测试阶段
dotnet test确保代码质量 - 版本控制:每次部署自动生成版本号并标记Git提交
通过本文指南,你已掌握ET框架服务端的Jenkins CI/CD部署流程。只需简单配置,即可实现代码提交后自动构建、测试和部署,大幅提升开发效率。开始尝试构建你的第一条自动化流水线吧!
【免费下载链接】ET Unity3D Client And C# Server Framework 项目地址: https://gitcode.com/GitHub_Trending/et/ET
更多推荐





所有评论(0)