开篇语
自己从头开始走一遍docker部署.net的流程,作为一种学习总结,以及后续会写一些在该基础之上的文章。
本次示例环境:vs2019、net5、docker、postman
创建项目
本次事例代码是用过vs2019创建的ASP.NET Core Web API项目
![](https://img-blog.csdnimg.cn/img_convert/98fd0ce2d9bd93fa2887647fcd9ef4fb.png)
目标框架是.Net5,无需身份验证,不配置HTTPS(根据个人需求勾选),启动Docker(我习惯于后期添加),启用OpenAPI支持(添加swagger文档)
![](https://img-blog.csdnimg.cn/img_convert/dad6ef7c4539e8b65e154ccc11e81613.png)
默认配置
创建完成后,我们查看项目目录为下
![](https://img-blog.csdnimg.cn/img_convert/25d32cee42a9c563d858756146e9dcd0.png)
我们直接F5启动项目,发现直接跳转一个API文档页面
![](https://img-blog.csdnimg.cn/img_convert/cfa2f0f5744353dfc7721d23fae663c4.png)
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。
修改配置
我基于个人习惯,我修改launchSettings.json文件,删除IIS配置,删除后如下所示:
{
"iisSettings": {
"windowsAuthentication": false,
"anonymousAuthentication": true,
"iisExpress": {
"applicationUrl": "http://localhost:51539",
"sslPort": 0
}
},
"$schema": "http://json.schemastore.org/launchsettings.json",
"profiles": {
"Net5ByDocker": {
"commandName": "Project",
"launchBrowser": true,
"launchUrl": "swagger",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
},
"dotnetRunMessages": "true",
"applicationUrl": "http://localhost:5000"
}
}
}
删除默认控制器,添加新的控制器UserController,在里面添加默认一些方法操作,如下
基于个人习惯的操作,也可以不删除默认控制器
[Route("api/[controller]/[action]")]
[ApiController]
public class UserController : ControllerBase
{
public static List<string> userInfo = new();
[HttpGet]
public IEnumerable<string> Get()
{
return userInfo;
}
[HttpPost]
public List<string> Post([FromBody] string value)
{
if (!string.IsNullOrWhiteSpace(value))
userInfo.Add(value);
return userInfo.ToList();
}
[HttpDelete("{id}")]
public List<string> Delete(string id)
{
if (!string.IsNullOrWhiteSpace(id))
userInfo.Remove(id);
return userInfo.ToList();
}
}
其他配置保持默认,启动项目
![](https://img-blog.csdnimg.cn/img_convert/06019b0dc2f765741d38d5e2c039ff6d.png)
生成镜像
添加dockerfile
选中项目右键添加docker支持,本次部署在windows平台
![](https://img-blog.csdnimg.cn/img_convert/db941d9ebb51b68df4a22d4f64271163.png)
拉取基础镜像和sdk,还原nuget包,重新生成,发布
此时项目的目录结构为
![](https://img-blog.csdnimg.cn/img_convert/ac112a1fff59e244812a4e2c64c6edfd.png)
运行命令
在文件资源管理器打开文件
![](https://img-blog.csdnimg.cn/img_convert/a16413e11980b2b804ba5d534b76c256.png)
在上层目录下运行cmd输入命令
docker build -f .\Net5ByDocker\Dockerfile -t net5sample .
在不同的目录下命令有些许差异,这点非常感谢我的朋友王老师
![](https://img-blog.csdnimg.cn/img_convert/9efbd1cd43dacac26eb3db076345fd7b.png)
注意:可能部分朋友在这一步会拉取官方镜像比较慢,可以配置docker加速器使用
通过docker客户端查看我们已经生成的镜像
![](https://img-blog.csdnimg.cn/img_convert/35cd89ffab69a86b21bcd1d280d2953a.png)
生成容器
本文通过Terminal软件执行命令
docker run --name net5sampleone -d -p 8060:80 net5sample
命令简述:
-d 后台运行
--name 容器名称
-p 端口映射
截至到这,我们已经把刚才的项目生成了容器,下面我们可以直接通过容器方法上面的项目
验证项目
通过浏览器访问地址:localhost:8060/swagger
![](https://img-blog.csdnimg.cn/img_convert/5b9c481ca79b727a4148a838505b18f1.png)
懵逼!!!这个时候不是应该出来swagger文档的界面吗?难道我们部署的方式有问题?
让我们访问下项目的接口
![](https://img-blog.csdnimg.cn/img_convert/bedb1f508e99eb58268644443513ac7c.png)
说明我们的项目运行是正常的,仔细查看swagger配置后发现,因为为了安全默认不允许发布后出来swagger文档
![](https://img-blog.csdnimg.cn/img_convert/6acb0162f0d4ff1ef156991ba82fc199.png)
如果是测试环境或者特殊情况可以通过调整swagger配置位置来显示文档
通过Postman访问
添加用户
![](https://img-blog.csdnimg.cn/img_convert/22ed542613d3a72445886e2f4fb96491.png)
查询用户
![](https://img-blog.csdnimg.cn/img_convert/6192bc068af936f107219ef6d062c7d1.png)
删除用户
![](https://img-blog.csdnimg.cn/img_convert/5243ab906230d4b1d636a83b8dcbbdd1.png)
再次运行查询接口数据已经为空了。