Window平台安装Jenkins 并联动Gitlab实现自动发布Asp.Net Core 网站

1. 安装JDK(请自行下载安装)
2. 安装Git(请自行下载安装)
3. 安装.NetCore SDK( dotnet-sdk-5.0.402-win-x64 dotnet-hosting-5.0.11-win 请自行下载安装)
4. 下载并运行Jenkins.msi 安装程序。
5. 一路下一步进行安装，唯一需要注意的地方是如果你以后需要利用脚本运行桌面程序(.exe)那么在选择账户时就不要选择本地系统账户,而是新建立一个足够权限的账户登录。
6. 打开管理页面(服务器IP加端口号 默认8080 。记得将服务器的防火墙例外设置好)，根据系统提示，到服务器指定路径打开初始密码文件并输入在网页中。
7. 进入系统后选择安装推荐的插件，并耐心等待安全完成。
8. 依次选择Jenkins管理，插件管理，搜索并安装 gitlab 相关插件。
9. 安装完成后继续搜索PowerShell插件进行安装。
10. 回到首页。进入 Manage Jenkins ---> Configure System 。设置Jenkins Url
11. 回到首页，选择新建Item，输入名称并选择 Freestyle Project。
12. 选择Git ，并输入项目地址
13. 在Gitlab中创建一个用于拉取代码的用户，并在Jenkins此处添加该账户需要注意的是，在此处登记并选择账户时经常有一些延迟，导致报出未授权无法获取代码的错误。多刷新几次或者重新添加授权可以解决(如果不能解决就需要在gitlab那边看一下是不是真的没有权限了)。
14. 切换到构建触发器，选择Gitlab 并记录下这个Url 地址。
15. 切换到构建步骤，添加构建步骤。选择PowerShell。然后添加脚本。

    //构建并发布网站
    dotnet restore
    dotnet clean
    dotnet build
    dotnet publish -o C:\ZxProgram\ZxAuto\TestWeb01
    
    
    //停止网站
    C:\Windows\System32\inetsrv\appcmd.exe stop apppool /apppool.name:"TestWeb01"
    //复制文件
    xcopy "C:\ZxProgram\ZxAuto\TestWeb01" "C:\ZxProgram\ZxWebs\TestWeb01" /s/e/y
    //启动网站
    C:\Windows\System32\inetsrv\appcmd.exe start apppool /apppool.name:"TestWeb01"

    注意：我发布的是Asp.net core(5.0) 所以。如果此处脚本报错 请检查服务器是否安装了如下SDK。如果没有请自行下载安装。

    1.  dotnet-sdk-5.0.402-win-x64

    2. dotnet-hosting-5.0.11-win

16. 进入Gitlab的指定项目中 "设置"---> "Webhooks" 添加如下项目。

    图中的【网址】是Jenkins中的Gitlab webhook的Url也就是构建触发器中显示的(上面有图)。如果发生无法在Gitlab中添加Webhooks的情况，请检查一下下图中Gitlab中的设置。

17. 配置完成后可以点击 测试按钮 测试一下是否能正确触发Webhook。

18. 也可以在Jenkins中手动点击 构建 按钮进行构建测试。如果发生无法获取源代码的情况，可以尝试添加SSH密钥的方式。 

19. 如果出现403错误请尝试关闭 跨站伪造请求防护

    1、找到Jenkins配置文件 [Jenkins目录]\jenkins.xml
    
    2、增加参数 -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true
    
    
    <arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true -jar "%BASE%\jenkins.war" --httpPort=8080 --webroot="%BASE%\war"</arguments>

到此，在Windows平台安装Jenkins并且与Gitlab Webhooks配置自动构建发布就全部完成了。