部署.NET6.0 Web API项目到Docker

介绍

使用VS2022创建一个.NET6的Web API项目，将其打包，并部署到Linux服务器上的Docker中。

Linux和Docker环境已经备好，本文不再赘述，主要记录一下.NET6项目的创建和部署流程。

其中，部署方式不止一种，本文给出常见的一种方式。

代码及配置文件参考：https://gitee.com/redcod/net6-webapi-deploy-demo

创建.NET WebAPI项目

1. 选择ASP.NET Core Web API项目：
   

2. 项目名称叫做web-dotnet：
   

3. 项目参数
   

4. 启动项目

5. （开启了OpenAPI支持）启动后会自动打开Swagger页面，从中找到接口地址

6. 在浏览器中访问该地址

项目打包

1. 在Program.cs中配置一下端口（此示例使用端口9530），配置端口的方式不止一种，只试验了这一种：

builder.WebHost.UseUrls("http://*:9530");

2. 右击项目，点击【发布】
   

3. 选择【文件夹】的方式
   

4. 使用默认的发布输出路径，也可以更改
   

5. 点击【发布】，可以在【更多操作】中配置其他发布参数，本文采用默认参数。
   

6. 发布成功，点击【目标位置】则打开发布文件夹
   

7. 发布结果都在public文件夹内
   

8. 将public文件夹压缩为zip（方便上传到Linux后再解压，也可以直接上传public文件夹）：
   

项目部署

文件准备

可以使用MobaXterm工具远程连接Linux服务器。

在Linux服务器某个文件夹内准备好以下五个内容：

1. public文件夹（打包结果）
2. Dockerfile配置文件（构建docker镜像时的参数）

# 此阶段用于在快速模式(默认为调试配置)下从 VS 运行时
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 9530
COPY ./publish ./

ENTRYPOINT ["dotnet", "web-dotnet.dll"]

3. build.sh脚本（生成docker镜像的脚本）
   后面部署时直接运行脚本，不必输入很长的命令。
   脚本内容（需根据项目名称灵活调整）：

docker  build -t web-dotnet:prod-1.0 -f Dockerfile .

4. docker-compose.yml配置文件（用于配置镜像运行环境，即容器环境）

version: "3"
services:
  web-dotnet:
    container_name: web-dotnet
    image: web-dotnet:prod-1.0
    restart: always
    networks:
     - docker_net
    ports:
     - 9530:9530
networks:
  docker_net:
    external:
      name: docker_net

5. deploy.sh脚本（根据镜像创建容器并运行）

docker-compose -f docker-compose.yml up -d

部署命令

上面文件准备好后，依次运行build.sh和deploy.sh两个脚本即可。

效果图：

后续更新项目时，只需要先更新public文件夹，再依次运行这两个脚本，最后再删除旧版本的镜像。

可能的问题与解决

初次运行脚本时可能会出现无权限的提示：

则可以参考：https://blog.csdn.net/j123kaishichufa/article/details/9193475
也就是执行：

chmod 777 build.sh
chmod 777 deploy.sh