Jenkins For Windows编译构建C#项目环境搭建（完整版）
安装Jenkins
下载Windows安装包
官方下载地址
选择稳定版，这里下载的是最新版，如需下载指定版本点击 以前的发行版
配置java环境
下载 java jdk 17
jdk17官方下载链接
这里下载的是msi版本的安装包
安装jdk17
双击运行安装包，一直下一步直到安装完成即可，安装目录用默认的即可不用修改，安装完成后会自动添加环境变量
安装Jenkins
双击运行Jenkins安装包
安装目录可自定义这里用的是默认路径
因为Jenkins这种安装方式在Windows系统中是以Windows services方式运行的，这里我们要指定管理服务的用户，可选域账号也可选本地账号
注意：选择域账号作为服务管理用户时，需要先在本地安全策略中进行配置才可验证通过
验证通过才可进行下一步安装
设置Jenkins服务端口，这里使用的是默认的8080端口
选择java环境一定要是这个层级 C:\Program Files\Java\jdk-17\
支持java11，17，21
继续下一步直到点击Install即可
初始化Jenkins
浏览器登录Jenkins console界面，根据提示找到初始密码
这里选择不使用推荐的插件
选择无先什么插件都不安装
这里可以创建一个管理员用户，我这里没有创建选择 使用admin账户继续
修改Jenkins软件安装源为国内安装源
-
点击 Manage Jenkins ————> Plugins————>Advanced settings
将 https://updates.jenkins.io/update-center.json 修改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json -
修改 C:\Users\jks\AppData\Local\Jenkins.jenkins\updates\default.json文件
将www.google.com替换为www.baidu.com
将 https://updates.jenkins.io/download/plugins 替换为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/
配置完成后重启下Jenkins可以在
http://127.0.0.1:8080/restart
安装常用插件(按需安装即可)
- Localization Support
- Localization: Chinese (Simplified)
- Locale
- Git plugin （拉去git代码）
- Email Extension Plugin （邮件通知）
- Credentials Plugin （权限管理）
- build user vars plugin （获取Jenkins自带变量）
- Active Directory plugin （配置ldap域账号使用）
- MSBuild （构建C#应用使用）
中文设置
Manage Jenkins ————> System ————> Locale————> Default Language
修改完再次重启Jenkins http://127.0.0.1:8080/restart
安装C#构建工具
下载Microsoft Visual Studio 2019
2019下载地址
安装 Visual Studio 2019
这边勾选构建环境所依赖的组件，因为之构建.NET-Framework的项目所以我只勾选了这些
安装Git
Git下载地址
点击安装包这里可以选择安装目录我这里用的是默认的
选择安装组件
这里可以将Git修改为其他名字
Git安装包中内置了很多种编辑器，可以根据自己需求选择相应的编辑器，这里我们选择默认的vim
选择初始化新项目的主干分支名称，第一个选项是git自己选择，第二个是我们自己指定默认是main
调整环境变量
选择ssh执行文件
选择https后端传输
配置行尾符号转换
后面一直下一步直到点击安装即可
配置C#构建环境
配置MSBuild环境
Manage Jenkins ————> Tools————> MSBuild 安装
将Microsoft Visual Studio2019安装目录中的MSBuild的可执行文件路径填写进去
配置Git环境
因为安装git时已经自动添加了环境变量所以不需要输入git的安装目录直接输入可执行程序名称即可
配置拉取git代码的密钥
在Jenkins所在的服务器生成密钥
- 打开Windows终端
- 在终端窗口中，输入“ssh-keygen”命令，并按回车键。
- 系统会提示您输入密钥的文件名和位置。您可以选择默认位置或自定义路径。
- 输入密码短语（如果需要）以保护私钥
这里一直回车使用默认设置即可
去gitlab添加SSH密钥
将生成的id_rsa.pub文件内容添加进去设置下到期时间即可
在Jenkins中添加凭据
Manage Jenkins ————> Credentials ————> System ————> Global credentials (unrestricted)
创建JOB
新建一个自由风格的任务
将项目的git地址输入进去选择刚刚添加的凭据作为身份认证
使用msbuild构建项目
- /t:Rebuild # 清理现有的构建输出，然后重新构建所有项目
- /p:PublishProfile=jen # 指定发布配置文件的名称
- /p:Configuration=Release # 生成优化后的代码，去除调试信息
- /p:DeployOnBuild=true # 当设置为 true 时，MSBuild 会在构建完成后立即执行部署步骤
- /p:WebPublishMethod=FileSystem # 表示将发布的文件输出到文件系统中的某个目录(jen文件中配置的目录)。
效果展示
构建成功我们可以去到指定的发布目录中看下构建后的结果
后续再配置将构建后的可执行文件发布到应用部署的服务器即可