.NET 之 Docker 部署详细流程

朴灿烈づ我的快乐病毒、 2023-01-23 13:59 141阅读 0赞

开篇语

自己从头开始走一遍docker部署.net的流程，作为一种学习总结，以及后续会写一些在该基础之上的文章。

> 本次示例环境：vs2019、net5、docker、postman

# 创建项目 #

本次事例代码是用过vs2019创建的ASP.NET Core Web API项目

![图片][3a4475b12c5d12bc97b09d870e13bd94.png]

目标框架是.NET 5，无需身份验证，不配置HTTPS(根据个人需求勾选)，启动Docker(我习惯于后期添加)，启用OpenAPI支持(添加swagger文档)

![图片][da18f6cb4626049516c4f1cecaafe06e.png]

## 默认配置 ##

创建完成后，我们查看项目目录为下

![20210715145658910.gif][]

我们直接F5启动项目，发现直接跳转一个API文档页面

![20210715145658909.gif][]

> 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();
            }
        }

其他配置保持默认，启动项目

![图片][6507921fd0e2202f07af86b3e2937bd2.png]

# 生成镜像 #

## 添加dockerfile ##

选中项目右键添加docker支持，本次部署在windows平台

![图片][7925a56217ee30e796847af283003542.png]

> 拉取基础镜像和sdk，还原nuget包，重新生成，发布

此时项目的目录结构为

![图片][66c3b9ea9aa2e945c320fa8261cb54d8.png]

## 运行命令 ##

在文件资源管理器打开文件

![图片][7c50d759f7b5d2f6d4fc0aa227b50087.png]

在上层目录下运行cmd输入命令

docker build -f .\Net5ByDocker\Dockerfile -t net5sample .

> 在不同的目录下命令有些许差异，这点非常感谢我的朋友**王老师**

![20210715145658910.gif][]

> 注意：可能部分朋友在这一步会拉取官方镜像比较慢，可以配置docker加速器使用

通过docker客户端查看我们已经生成的镜像

![20210715145658907.gif][]

# 生成容器 #

本文通过**Terminal**软件执行命令

docker run --name net5sampleone -d -p 8060:80 net5sample

> 命令简述：
> 
> \-d 后台运行
> 
> \--name 容器名称
> 
> \-p 端口映射

截至到这，我们已经把刚才的项目生成了容器，下面我们可以直接通过容器方法上面的项目

# 验证项目 #

通过浏览器访问地址：localhost:8060/swagger

![20210715145658908.gif][]

懵逼！！！这个时候不是应该出来swagger文档的界面吗？难道我们部署的方式有问题？

让我们访问下项目的接口

![20210715145658876.gif][]

说明我们的项目运行是正常的，仔细查看swagger配置后发现，因为为了安全默认不允许发布后出来swagger文档

![20210715145658906.gif][]

> 如果是测试环境或者特殊情况可以通过调整swagger配置位置来显示文档

## 通过Postman访问 ##

### 添加用户 ###

![20210715145658908.gif][]

### 查询用户 ###

![图片][082d519f25bcb0ee41d4a18c83f5bafe.png]

### 删除用户 ###

![图片][9ed5493901f6a1cb3c833fb46ebe6710.png]  
再次运行查询接口数据已经为空了。

> 转自：Azing
> 
> 链接：cnblogs.com/azrng/p/14730149.html

[3a4475b12c5d12bc97b09d870e13bd94.png]: /images/20221004/e3e1642091c445b69a2031bfcdcf864d.png
[da18f6cb4626049516c4f1cecaafe06e.png]: /images/20221004/01645b105e04496a9ad4d70b643f1198.png
[20210715145658910.gif]: /images/20221004/4e741da72880497995b48b7cbc05ee6b.png
[20210715145658909.gif]: /images/20221004/3019f799518346c2a288f9f21ab7fa0f.png
[6507921fd0e2202f07af86b3e2937bd2.png]: /images/20221004/22ad665e4dec411fa8baf286221a1c2b.png
[7925a56217ee30e796847af283003542.png]: /images/20221004/f7df23baaa4445d99d9d94d6205f502a.png
[66c3b9ea9aa2e945c320fa8261cb54d8.png]: /images/20221004/78c542d2b1f040bcbab0e375870be7f0.png
[7c50d759f7b5d2f6d4fc0aa227b50087.png]: /images/20221004/ec033dd3633f46fbbd207e74de324e92.png
[20210715145658907.gif]: /images/20221004/0c7220e1de544163b04a7c1acfcf1220.png
[20210715145658908.gif]: /images/20221004/d89e9a19500e480abf681a3b06268650.png
[20210715145658876.gif]: /images/20221004/d6a032ceb66343cd8b9ff249270ec7bf.png
[20210715145658906.gif]: /images/20221004/ff6b101c508247cd827e27e0b050638a.png
[082d519f25bcb0ee41d4a18c83f5bafe.png]: /images/20221004/74a4918eb59c4fd3a5dd4d240ecbf328.png
[9ed5493901f6a1cb3c833fb46ebe6710.png]: /images/20221004/11b33dc7104c4a029c4fa0d34906f4a6.png