1. 项目概述

在上一篇文章中，我们已经完成了Ubuntu服务器上Docker环境的安装和配置。本文将重点介绍如何将一个.NET 6 Web API应用程序部署到Docker容器中运行。通过容器化部署，我们可以实现应用程序与运行环境的解耦，提高部署效率和可移植性。

对于.NET开发者来说，将应用程序容器化是一个非常重要的技能。Docker提供了轻量级的虚拟化方案，使得我们的应用程序可以在任何支持Docker的环境中运行，无需担心环境差异带来的兼容性问题。

2. 为项目添加Docker支持

2.1 创建Dockerfile

在Visual Studio中为.NET项目添加Docker支持非常简单。右键点击项目，选择"添加"→"Docker支持"，系统会自动生成一个Dockerfile文件。这个文件包含了构建Docker镜像所需的所有指令。

注意：如果你的解决方案中有多个项目，请确保在API项目上右键添加Docker支持，而不是在类库项目上。

自动生成的Dockerfile通常包含多个构建阶段（多阶段构建），这对于生产环境部署很有帮助。但在开发阶段，我们可以先简化这个文件，专注于让应用程序能够正常运行。

2.2 简化Dockerfile

以下是经过简化后的Dockerfile示例：

# 使用官方.NET 6运行时镜像作为基础 FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base WORKDIR /app EXPOSE 80 # 复制发布文件到容器中 COPY . . ENTRYPOINT ["dotnet", "CityInvest.Api.dll"]

这个简化版的Dockerfile做了以下几件事：

1. 基于官方的.NET 6运行时镜像
2. 设置工作目录为/app
3. 暴露80端口（这是ASP.NET Core的默认端口）
4. 将当前目录下的所有文件复制到容器的/app目录
5. 设置容器启动时执行的命令

提示：在生产环境中，建议使用多阶段构建来减小最终镜像的体积。但在开发阶段，简化版更容易调试。

3. 发布项目

3.1 配置发布选项

在Visual Studio中发布项目时，需要选择"文件夹"发布方式。在发布配置中，确保选择"Release"配置和"可移植"的目标运行时。

发布配置的几个关键点：

1. 配置：选择Release以获得优化后的代码
2. 目标框架：选择net6.0
3. 部署模式：选择框架依赖或独立（通常选择框架依赖）
4. 目标运行时：选择可移植（portable）

3.2 手动添加Dockerfile

发布完成后，检查发布文件夹中是否包含Dockerfile。如果没有，需要手动将项目中的Dockerfile复制到发布文件夹中。这是非常重要的一步，因为docker build命令需要这个文件来构建镜像。

常见问题：如果忘记复制Dockerfile，构建时会收到"unable to locate Dockerfile"错误。

4. 构建Docker镜像

4.1 准备构建环境

将发布文件夹上传到Ubuntu服务器。可以使用scp命令或任何你熟悉的文件传输工具。例如：

scp -r publish_folder user@server_ip:/path/to/destination

4.2 执行构建命令

在服务器上，进入包含Dockerfile的目录，执行以下命令构建镜像：

docker build -t cityinvest.api .

这个命令的各个部分含义：

• docker build: 构建Docker镜像的命令
• -t cityinvest.api: 为镜像指定名称和标签（这里是默认的latest标签）
• .: 表示使用当前目录中的Dockerfile

构建过程可能需要几分钟，具体时间取决于你的网络速度和项目大小。构建完成后，可以使用以下命令查看所有本地镜像：

docker images

5. 运行容器

5.1 启动容器命令

使用以下命令启动容器：

docker run -d -p 8080:8000 --name cityinvest-docker cityinvest.api

参数说明：

• -d: 以分离模式运行（后台运行）
• -p 8080:8000: 端口映射（主机端口:容器端口）
• --name cityinvest-docker: 为容器指定名称
• cityinvest.api: 使用的镜像名称

5.2 验证容器运行状态

使用以下命令查看正在运行的容器：

docker ps

如果容器没有正常运行，可以使用以下命令查看日志：

docker logs cityinvest-docker

6. 测试API

6.1 防火墙配置

在测试API之前，确保服务器的防火墙允许8080端口的入站连接。可以使用以下命令检查防火墙状态：

sudo ufw status

如果需要开放端口：

sudo ufw allow 8080

6.2 使用Postman测试

使用Postman或其他API测试工具，向服务器的8080端口发送请求。例如：

http://your_server_ip:8080/api/values

如果一切正常，你应该能收到API的响应。

7. 常见问题与解决方案

7.1 依赖注入错误

如果遇到类似以下的错误：

System.InvalidOperationException: Unable to resolve service for type '***.***.***' while attempting to activate '***.***.***'

这通常是因为依赖注入容器无法解析某些服务。解决方法：

1. 确保所有需要的服务都在Startup.cs或Program.cs中正确注册
2. 检查发布配置，确保选择了"Release"和"可移植"
3. 清理并重新构建解决方案

7.2 端口冲突

如果指定的端口已被占用，docker run命令会失败。解决方法：

1. 更改主机端口（如-p 8081:8000）
2. 停止占用端口的其他服务
3. 使用以下命令查找占用端口的进程：

sudo netstat -tulnp | grep :8080

8. 常用Docker命令参考

8.1 容器管理

# 查看运行中的容器 docker ps # 查看所有容器（包括停止的） docker ps -a # 停止容器 docker stop container_name_or_id # 启动已停止的容器 docker start container_name_or_id # 重启容器 docker restart container_name_or_id # 删除容器（必须先停止） docker rm container_name_or_id

8.2 镜像管理

# 列出所有本地镜像 docker images # 删除镜像 docker rmi image_name # 强制删除镜像（即使有容器使用） docker rmi -f image_name

8.3 日志与调试

# 查看容器日志 docker logs container_name_or_id # 实时查看日志 docker logs -f container_name_or_id # 进入容器内部 docker exec -it container_name_or_id /bin/bash

9. 性能优化建议

9.1 镜像大小优化

1. 使用多阶段构建：在最终镜像中只包含运行时必要的文件
2. 使用.dockerignore文件：排除不必要的文件（如bin, obj文件夹）
3. 选择更小的基础镜像：如mcr.microsoft.com/dotnet/aspnet:6.0-alpine

9.2 容器资源限制

在生产环境中，建议为容器设置资源限制：

docker run -d -p 8080:8000 --name cityinvest-docker \ --memory=512m --cpus=1 \ cityinvest.api

10. 后续步骤

成功将.NET API部署到Docker容器后，你可以考虑以下进阶主题：

1. 使用Docker Compose管理多个容器
2. 配置容器健康检查
3. 设置容器自动重启策略
4. 学习Kubernetes进行容器编排

在实际项目中，我发现在开发阶段保持Dockerfile简单明了有助于快速迭代。当应用程序稳定后，再考虑优化镜像大小和性能。另外，建议在CI/CD流水线中自动化构建和部署过程，这可以显著提高团队的工作效率。