利用Jenkins+SVN+Windows服务对NetCore项目实行持续集成、自动化部署CI/CD

前言：
最近在做NetCore项目，因为项目是部署在WinServer的IIS上(别问我为啥不用Linux)，而更新的办法是采用mstsc(远程桌面)后手动复制覆盖dll文件。
而作为一个只会CRUD的菜鸟本鸟，在每次修改完代码提交SVN以后，都得知会专人等待发布更新，相当痛苦。
由于是项目开发初期，代码的版本迭代很频繁，不及时更新造成的结果就是与前端的对接也相应延后，项目进度拖延是肯定的，这好吗？这不好！
由此可见部署一套可行的版本管理、CI/CD方案是多么重要。
下面本人将展示，自己安装配置这一套的全过程（多图警告!）

1. 准备工具：

Jdk 8(用于支撑Jenkins运行)
Jenkins（CI/CD主要工具）
SVN Server (搭建本地svn服务)
TortoiseSVN (连接svn仓库的工具)
NetCore 5.0 SDK（net5开发运行环境）

2. 搭建SVN Server服务并建立svn仓库

下载上面的安装包以后，我们就开始安装SVNServer了，一路下一步就ok了，这里我指定端口为4437。
安装完了SVN服务，我们就要建立一个用于管理代码版本的SVN仓库了
这里建一个名为Net5Repo的仓库
并建一个具有读写权利的用户admin
建完了仓库，我们再把SVN连接工具安装上（也是一路下一步，这里不多赘述）。
然后找个文件夹CheckOut下来。因为我们是搭的本地SVN服务，路径就是https://localhost:4437/svn/ {仓库名}，这里{仓库名}就是上面我们建的Net5Repo，
点击OK后会验证账户密码，输入正确以后就能把仓库拉取下来了。

3. 新建Net5.0项目,并传至svn仓库

打开VS2019新建Net5.0项目，
这里我们就建一个名为NetApi的Web项目
注意选择NetCore版本
这里用运行win+r打开cmd，cd到项目根目录，然后启动项目。

cd C:WorkSpaceSVNNet5RepoNetApi
dotnet run

因为net 5.0集成了swagger，因此我们可以直接访问Api地址: https://localhost:5001/swagger/index.html
swagger可以代替接口文档对接前端，实际开发中只要把这个地址丢过去就行了，简直不要太完美。
提交我们项目的第一版到SVN仓库
但是可以看到提交的文件非常多，乱七八糟，有些是vs编译产生的临时文件，例如/bin、/obj、*.csproj.user(vs用户的本地配置文件)，我们肯定是不能维护进版本库的，因此添加规则，忽略之。
- 首先右键我们的项目文件夹NetApi，依次选择TortoiesSVN->Properties，点击New...，选择Other，属性名选择svn:global-ignores，然后敲入bin和obj，点击ok。
- 然后对NetApi文件夹下的bin以及obj文件夹标记为删除，最后提交。这样一来编译产生的文件就不会出现在提交列表里，非常的干净清爽。

4. 安装并配置jenkins

首先安装Jenkins
- 这里把端口指定为8888。
- 然后按提示步骤一步步下去。
- 这里要注意选择安装推荐的插件，可以省不少事。
- 安装完插件重启后，会让你创建管理员，这里我们创建一个admin账户。
然后登录jenkins
安装Subversion插件，依次点击Manage Jenkins->Manage Plugins,搜索Subversion勾选安装并重启。
接下来就开始配置任务了，我们在首页点击新建Item，任务名就叫NetApi，选择FreeStyle Project (yeah~ freestyle!)

我们在源码管理里选择Subversion(SVN)
- Credentials就是凭据，也就是我们的svn用户连接账号admin，添加之。
- Repository URL里输入我们前面建的本地svn仓库地址（https://localhost:4437/svn/Net5Repo/NetApi ）
构建触发器里定义条件，选择Poll SCM(具体规则可以点击右侧的查看)，这里我们设定5分钟检测一次 H/5 * * * *
我们先保存后点击Build Now构建一次看看效果。可以看到东西都被下载到了工作区。
这里我们以Jenkins构建后的工作区（workspace）为主，编译发布NetCore项目，然后建立成服务。
- 我们打开cmd，cd到工作区里，一般文件路径为：主目录路径(可在首页点击Manage Jenkins->Configure System中查看)workspace任务名（这里我们是NetApi）
  cd C:WindowsSystem32configsystemprofileAppDataLocalJenkins.jenkinsworkspaceNetApi
- 然后发布到指定文件夹（微软dotnet CLI指令文档），这里指定为 C:WorkSpacePublishSiteNetApi
  dotnet publish -o C:WorkSpacePublishSiteNetApi
- 可以看到编译后的文件都被发布到了我们指定的目录下，
- 接着我们以管理员方式打开cmd，输入以下指令，建立服务。服务名为NetApi，bindPath需要绝对路径指定到具体的*.exe文件，端口我们设置为8800，启动方式为auto(自动)，然后敲入启动指令，却发现失败了。
  sc create NetApi binPath= "C:WorkSpacePublishSiteNetApiNetApi.exe --urls="http://127.0.0.1:8800"" DisplayName= "net接口" start= auto
- 查阅文档是缺少了引用包，Microsoft.Extensions.Hosting.WindowsServices 与Microsoft.AspNetCore.Hosting.WindowsServices，并修改Program.cs的IHostBuilder方法。我们照做之，代码如下。
```
namespace NetApi
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }
        public static IHostBuilder CreateHostBuilder(string[] args) =>
             Host.CreateDefaultBuilder(args)
                .UseWindowsService()//添加此行
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                });
    }
}
```
- 然而此处有一个坑，因为发布后的版本采用的环境是Production，新建项目默认只在Development开启Swagger,因此我们需要修改Startup.cs的Configure方法。
```
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
   app.UseDeveloperExceptionPage();
}
   app.UseSwagger();
   app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "NetApi v1"));
   app.UseRouting();
   app.UseAuthorization();
   app.UseEndpoints(endpoints =>
   {
       endpoints.MapControllers();
   });
}
```
- 然后我们提交svn，可以看到jenkins自动构建了本次提交。
- 重复上述cd到jenkins工作区，然后发布dotnet publish -o 的工作，我们成功注册了NetApi的服务，并启动之。
- 然后打开浏览器访问 http://localhost:8800/swagger/index.html 可以看到服务起来了。
- 打开任务管理器也能看到
- 如此一来我们也就清楚了，该如何利用cmd的命令行来编译、发布并部署Net5.0项目，继续配置jenkins
在构建里我们选择Execute Windows batch command。并贴入如下代码并保存。
```
sc stop NetApi
dotnet publish -o C:WorkSpacePublishSiteNetApi
sc start NetApi
```
- 点击Build Now，检查下是否构建成功。
- 可以看到一切顺利，服务也成功跑起来了。