.NET之Docker部署详细流程
dotNET跨平台 今天
以下文章来源于鹏祥 ,作者AZRNG
开篇语
自己从头开始走一遍docker部署.net的流程,作为一种学习总结,以及后续会写一些在该基础之上的文章。
本次示例环境:vs2019、net5、docker、postman
创建项目
本次事例代码是用过vs2019创建的ASP.NET Core Web API项目
目标框架是.Net5,无需身份验证,不配置HTTPS(根据个人需求勾选),启动Docker(我习惯于后期添加),启用OpenAPI支持(添加swagger文档)
默认配置
创建完成后,我们查看项目目录为下
我们直接F5启动项目,发现直接跳转一个API文档页面
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(); } }
其他配置保持默认,启动项目
生成镜像
添加dockerfile
选中项目右键添加docker支持,本次部署在windows平台
拉取基础镜像和sdk,还原nuget包,重新生成,发布
此时项目的目录结构为
运行命令
在文件资源管理器打开文件
在上层目录下运行cmd输入命令
docker build -f .\Net5ByDocker\Dockerfile -t net5sample .
在不同的目录下命令有些许差异,这点非常感谢我的朋友王老师
注意:可能部分朋友在这一步会拉取官方镜像比较慢,可以配置docker加速器使用
通过docker客户端查看我们已经生成的镜像
生成容器
本文通过Terminal软件执行命令
docker run --name net5sampleone -d -p 8060:80 net5sample
命令简述:
-d 后台运行
--name 容器名称
-p 端口映射
截至到这,我们已经把刚才的项目生成了容器,下面我们可以直接通过容器方法上面的项目
验证项目
通过浏览器访问地址:localhost:8060/swagger
懵逼!!!这个时候不是应该出来swagger文档的界面吗?难道我们部署的方式有问题?
让我们访问下项目的接口
说明我们的项目运行是正常的,仔细查看swagger配置后发现,因为为了安全默认不允许发布后出来swagger文档
如果是测试环境或者特殊情况可以通过调整swagger配置位置来显示文档
通过Postman访问
添加用户
查询用户
删除用户
再次运行查询接口数据已经为空了。