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软件安装源为国内安装源

1. 点击 Manage Jenkins ————> Plugins————>Advanced settings
   将 https://updates.jenkins.io/update-center.json 修改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

2. 修改 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所在的服务器生成密钥

1. 打开Windows终端
2. 在终端窗口中，输入“ssh-keygen”命令，并按回车键。
3. 系统会提示您输入密钥的文件名和位置。您可以选择默认位置或自定义路径。
4. 输入密码短语（如果需要）以保护私钥
   这里一直回车使用默认设置即可
   

去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文件中配置的目录)。

效果展示

构建成功我们可以去到指定的发布目录中看下构建后的结果


后续再配置将构建后的可执行文件发布到应用部署的服务器即可