Jenkins在Windows上的部署及通过Jenkins将.NET项目发布到IIS上

Jenkins在Windows上的部署及通过Jenkins将.NET项目发布到IIS上

背景介绍

Jenkins将项目的发布流程进行了统一管理，可以方便项目的部署，简化操作流程。但是Jenkins一般是部署在Linux上的，本次尝试在Windows上进行部署，并通过Jenkins进行一个简单的MVC5项目的部署。

一、将Jenkins在Windows上的部署

1、下载

https://www.jenkins.io/download/

选择Windows版本，注意：安装Jenkins需要Java的支持，而且最新版的Jenkins只支持Java11、java17和Java21

2、安装

官方安装教程：https://www.jenkins.io/doc/book/installing/windows/

安装完成后打开服务，可以看到后台运行了一个Jenkins的服务。

3、启动配置

安装完成后打开浏览器访问：http://localhost:8079/ (刚才配置的端口号)

这里我们注意到默认Jenkins是在C盘的，我希望修改Jenkins的默认路径。

修改Jenkins的默认路径：

配置环境变量JENKINS_HOME

修改jenkins.xml，在我们最开始的安装是选择的目录中有jenkins.xml文件

将其中：

<env name="JENKINS_HOME" value="%LocalAppData%\Jenkins\.jenkins"></pre>

改为

<env name="JENKINS_HOME" value="E:\jenkins"/>

保存后重启Jenkins：
在Jenkins安装根目录中执行：

jenkins.exe stop
jenkins.exe start

重新访问Jenkins即可。

可以选择自己新创建一个账号，我这里使用默认的账号，密码还是第一页提示的那个文件中的密码。

4、安装插件

Git、MSBuild、Publish Over SSH

5、创建一个Job

本地创建了一个ASP.NET MVC的项目，然后将它推送到了Gitee远程仓库。

暂时先没有配置要执行的步骤，暂时保存下，稍后再修改。

6、项目发布流程简单梳理

我们先来简单梳理下项目的发布流程：

1、编写代码上传到远程仓库，2、通过MSBuild.exe构建项目，3、将生成的文件放到服务器的文件夹下并配置iis。

那么当我们使用Jenkins时，就是要模仿上述流程：

1、配置git拉取代码。并建立了触发器，没两分钟检测下变化。

2、安装Nuget.exe并通过Nuget还原依赖文件。

3、通过MSBuild.exe构建项目。

4、对生成的文件放到iis中。（如果需要到远程的话，通过ssh即可）

7、Nuget.exe和MSBuild.exe

因为我们要让Jenkins去拉取代码，所以可能是没有相关依赖的，但是会有一个package.config文件，我们可通过nuget.exe对该配置文件进行还原。（所以这也是为什么更推荐通过nuget来管理dll文件，而不是用过本地dll一直复制）。
找不到nuget.exe文件，直接去：https://www.nuget.org/downloads下载一个即可。（当然我们可以自己搭建一个内部的nuget进行包管理，后续再说。）

下载完成后随便放一个位置即可。

上述流程中已经设置号git相关的信息。接下来设置MSBuild.exe，安装Visual Studio时会有的。可参考下图路径。我们在这配置下MSBuild.exe的路径信息，可以配置多个。

第一种：使用Visual Studio 2022带的

第二种：Windows系统默认带的

8、开始配置需要执行的命令

1、使用nuget还原项目包

cd \
nuget.exe restore %WORKSPACE%\Webapplication1.sln

2、使用MSBuild构建项目

3、构建完成后使用下述命令停止iis，然后将构建后的文件复制到指定文件夹，再启动iis。（至此可以在本机的iis上使用了）

4、接下来就是通过ssh连接远程服务器，然后将文件上传到服务器上。
在系统配置中配置ssh信息（注意：这里是在系统设置中配置的，不是接着3步骤执行的命令。如果系统设置没有这个选项，请查看ssh插件是否安装）

5、配置ssh相关的命令，这里接着上述的第3步骤执行即可

二、通过Jenkins将.NET项目发布到IIS上

接下来只需要在本地正常编写代码即可，当完成代码后推送到git远程仓库后，Jenkins每隔两分钟会自动检测git的远程仓库是否有变化，当发生变化后会自动拉取代码，然后在本地执行上述你配置的相关命令，从而自动完成对服务器的相关文件的更新操作。

至此，全篇介绍。

总结

大致流程，安装Jenkins（需要Java依赖），安装Git、MSBuid和SSH插件。设置好Git的远程仓库地址之后，个人感觉Jenkins就像一个管家一样，Jenkins会自动拉取镜像，执行命令行操作，打包，复制文件到服务器，从而完成项目部署。简化人工操作，不用像之前一样再复制文件。