0基础轻松玩转.NET Web API 8.0【CICD】项目实战
1.背景
最近在学习CI/CD，为了加快熟悉CI/CD，我实操了下基于.Net 8.0的CI/CD项目实战。Ci/CD就是自动化作业，实现项目自动编译、发布、执行等，也有用于拉取推送数据的场景。本文主要介绍了在win 11下搭建CI/CD，实现自动发布.net 8.0 WebAPI，并支持代码更新后的发布。通过本文可以快速了解CI/CD流程和思路，不过暂时还没接入docker容器，后续抽空会出支持dokcer的CI/CD文章。
2.知识储备
2.1 CI/CD概念
CI/CD就是项目自动化。解放手工操作，将项目自动编译，自动发布，自动执行。这里的项目，我们定义为.NET Web API 8.0；
2.2 CI/CD架构
下面是1个完整的CI/CD架构图：
VS2022：开发IDE
gitee：码云，国内版的github
jenkins：CI/CD工具
项目：操作的目标对象，本文是.NET Web API 8.0
路由侠：内网映射工具
这里可能会有疑问？为什么要用路由侠去做内网映射了？
答案：gitee在代码提交后，可能会触发jenkins流水线任务等，底层原理是调用jenkins接口，让jenkins去干活。在我们这架构模式下，gitee是外网模式，jenskin是部署在内网，比如本地电脑。这样就需要内网映射到外网。在gitee上面就能访问到jenkins接口。
当然，如果你在服务器上部署jenkins，那就不需要内网映射了。直接通过服务器ip或者域名就能解析。
2.3 CI/CD环境准备
2.3.1 项目准备
新增 .NET Web API 8.0项目：WebAPI_CICD
新增CICDController，代码如下
using Microsoft.AspNetCore.Mvc;
namespace WebAPI_CICD.Controllers
{
[ApiController]
[Route("[controller]/[action]")]
public class CICDController : ControllerBase
{
private readonly ILogger<WeatherForecastController> _logger;
public CICDController(ILogger<WeatherForecastController> logger)
{
_logger = logger;
}
[HttpGet(Name = "GetCICD")]
public string GetCICD()
{
return $"CI/CD部署成功:{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")}";
}
}
}
2.3.2 gitee准备
官网地址：Gitee - 基于 Git 的代码托管和研发协作平台
创建仓库 WebAPI_CICD：
2.3.3 jenkins准备
官网下载安装包，安装到本地win11电脑，安装教程可以百度；
经过几分钟的安装后，打开jenkins，地址:工作台 [Jenkins]
2.3.4 路由侠准备
官网下载， 安装到本地win11电脑，安装比较简单；
安装成功后，打开软件主界面
2.4 CI/CD架构实战
2.4.1 项目上传
将.net 8.0项目上传到gitee
将gitee上面的仓库地址，复制到VS2022的 远程URL
2.4.2 下载项目
在jenkins上面下载项目源代码。下面是操作步骤
选择 保存
验证jenkins是不是能从gitee拉取代码？按照下列操作来验证
可以明显看出，项目源代码下载成功。代码下载的路径是
C:\ProgramData\Jenkins\.jenkins\workspace\WebAPI_CICD
额外介绍，jenkins工作目录是
C:\ProgramData\Jenkins\.jenkins\workspace2.4.3 运行项目
在jenkins进行配置，就能将下载后的项目源代码，运行起来，下面是操作步骤
验证jenkins是不是正常运行项目？按照下列操作来验证
从上图可以看到运行项目成功。拼接地址/CICD/GetCICD后，地址为 http://localhost:5089/CICD/GetCICD，浏览器访问如下：
验证jenkins运行项目是成功的。
2.4.4 更新项目
目标：代码提交到分支，需要触发CI/CD。
思路：1.在本地win11电脑配置内网映射，将本地jenkins映射到外网；2.gitee webhook触发jenkins构建：自动拉取代码，编译，发布，运行项目。
接下来，按照下图去配置：
使用路由侠工具，进行内网映射，将jenkins映射到外网进行访问
将上图的公网地址http://laiger.w1.luyouxia.net，放到浏览器访问
明显看到。我们内网映射配置成功。现在jenkins支持公网访问了。
在jenkins页面正常输入用户名和密码，进行登录后如下所示：
到这里，jenkins内网映射配置完成，接下来是配置gitee webhook触发jenkins构建的过程；
在jenkins安装插件Gitee Plugin
接下来配置 gitee webhook：
根据上图，又因为jenkins已经做了 内网映射，所以 Gitee webhook地址是
http://laiger.w1.luyouxia.net/gitee-project/WebAPI_CICD按照下面操作，生成gitee webhook密码，将密码记下来
拿到gitee webhook地址和密码后，去gitee按照下图去配置
在VS2022 修改源代码，推送到gitee会触发jenkins任务
提交到后，发现jenkins已经触发了构建任务
检查下.Net WebAPI 8.0项目是不是最新版本
显而易见，版本已经成功更新
2.5 CI/CD原理分析
CI/CD关键是jenkins，无非就是是作业自动化。将作业定义为流水线，支持各种操作，比如脚本、接口等等，实现了自动作业的功能。
3.结束
本文是CI/CD简单版本的探索，属demo系列。正常部署生产环境，是在服务器部署jenkins，无需内网映射，公司内自建gitlab仓库等，用docker容器去部署。后续抽空出支持容器的CI/CD介绍。