零代码搞定ET框架服务端部署:Jenkins CI/CD全流程指南

【免费下载链接】ET Unity3D Client And C# Server Framework 【免费下载链接】ET 项目地址: 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流程中能正确调用相关工具:

Unity外部工具配置界面 图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流水线:可视化配置指南

创建新任务

  1. 点击Jenkins首页新建任务
  2. 输入任务名称(如ET-Server-Deploy
  3. 选择流水线类型并点击确定

配置流水线

在流水线配置页面,选择定义为"Pipeline script from SCM",然后:

  1. SCM选择Git,填入仓库URL:https://gitcode.com/GitHub_Trending/et/ET
  2. 分支指定:通常为*/main或项目主分支
  3. 脚本路径:输入Jenkinsfile(若项目根目录不存在此文件,需手动创建)

配置包管理凭证

某些私有包可能需要认证,可通过类似下图的包管理器配置界面预先设置凭证,确保CI过程中能正常获取依赖:

包管理器凭证配置界面 图2:包管理器凭证配置示例,可存储私有仓库访问令牌

⚙️ 核心构建步骤:关键配置解析

示例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服务端部署失败 ❌'
        }
    }
}

关键配置说明

  1. 构建命令:使用dotnet build命令编译服务端项目,对应项目文件路径需根据实际结构调整
  2. 部署方式:示例使用scpssh命令,实际可替换为FTP、Docker或K8s部署
  3. 通知机制:通过slackSend实现部署结果通知,也可替换为邮件或企业微信通知

🔍 常见问题排查指南

构建失败怎么办?

  1. 检查依赖:确保服务器已安装所有项目依赖,可通过dotnet restore命令验证
  2. 权限问题:Jenkins用户需有足够权限执行构建和部署命令
  3. 路径问题:确认所有文件路径在Jenkins环境中可正确访问

如何实现多环境部署?

通过Jenkins的参数化构建功能,添加环境选择参数(如env=testenv=prod),然后在部署脚本中根据参数选择不同的目标服务器。

🎯 优化建议:让部署更高效

  1. 缓存依赖:在Jenkinsfile中添加dotnet restore --no-cache避免重复下载依赖
  2. 并行构建:使用parallel语法同时构建客户端和服务端
  3. 自动化测试:添加测试阶段dotnet test确保代码质量
  4. 版本控制:每次部署自动生成版本号并标记Git提交

通过本文指南,你已掌握ET框架服务端的Jenkins CI/CD部署流程。只需简单配置,即可实现代码提交后自动构建、测试和部署,大幅提升开发效率。开始尝试构建你的第一条自动化流水线吧!

【免费下载链接】ET Unity3D Client And C# Server Framework 【免费下载链接】ET 项目地址: https://gitcode.com/GitHub_Trending/et/ET

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐