使用ASP.NET Core和Docker容器化部署：从开发到生产的实战指南
你好，我是源码库的技术博主。在微服务和云原生架构大行其道的今天，将应用程序容器化部署已成为开发者的必备技能。今天，我想和你分享一个完整的实战流程：如何将一个ASP.NET Core应用程序打包成Docker镜像，并最终运行起来。这个过程我走过不少弯路，也踩过不少坑，希望我的经验能让你事半功倍。
一、准备工作：环境与项目搭建
首先，确保你的“武器库”已经齐备。你需要安装：
- .NET SDK（建议使用长期支持版本，如.NET 6/8）。
- Docker Desktop（Windows/Mac）或 Docker Engine（Linux）。安装后，务必在终端运行
docker --version和docker run hello-world来验证安装成功。我第一次就忘了启动Docker服务，折腾了半天。 - 一个代码编辑器，比如VS Code或Visual Studio。
接下来，我们创建一个简单的演示项目。打开终端，执行：
dotnet new webapi -n MyDockerizedApp
cd MyDockerizedApp
这个命令会创建一个基础的Web API项目，包含一个经典的WeatherForecast控制器。为了演示清晰，我们可以稍微修改一下 Program.cs，让输出更友好：
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
// 添加一个简单的根路径响应
app.MapGet("/", () => "MyDockerizedApp is running successfully!");
app.Run();
运行 dotnet run，访问 https://localhost:7000 或 http://localhost:5000，确认应用能正常启动。
二、核心步骤：编写Dockerfile
这是容器化的灵魂所在。Dockerfile是一个文本文件，包含了构建镜像的所有指令。在项目根目录（与MyDockerizedApp.csproj同级）创建一个名为 Dockerfile 的文件（注意没有扩展名）。
我强烈推荐使用多阶段构建，它能显著减小最终镜像的体积。下面是一个针对.NET 8的优化版Dockerfile，每一行我都加了详细注释：
# 第一阶段：构建阶段 (build stage)
# 使用包含SDK的官方镜像来编译和发布应用
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
# 复制项目文件并恢复NuGet包。分开COPY这两步可以利用Docker的缓存层，提高构建速度。
COPY ["MyDockerizedApp.csproj", "./"]
RUN dotnet restore "MyDockerizedApp.csproj"
# 复制所有源代码并构建发布版本
COPY . .
RUN dotnet publish "MyDockerizedApp.csproj" -c Release -o /app/publish
# 第二阶段：运行时阶段 (runtime stage)
# 使用仅包含运行时的镜像，体积更小，安全性更高
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
# 设置环境变量，确保应用在容器内使用正确的端口（ASP.NET Core默认是8080）
ENV ASPNETCORE_URLS=http://+:8080
EXPOSE 8080
# 从构建阶段复制发布好的文件
COPY --from=build /app/publish .
# 指定容器启动时运行的命令
ENTRYPOINT ["dotnet", "MyDockerizedApp.dll"]
踩坑提示：早期我常犯的错误是直接用SDK镜像作为最终镜像，导致镜像大小超过1GB。使用多阶段构建后，最终镜像通常只有200MB左右，部署和传输效率大大提升。
三、构建与测试：本地运行Docker镜像
现在，让我们在本地构建并运行它。在终端（确保位于Dockerfile所在目录）执行构建命令：
docker build -t mydockerizedapp:1.0 .
这个命令中，-t 是为镜像打标签（名称:版本），最后的 . 表示使用当前目录的Dockerfile。构建过程会下载基础镜像并执行Dockerfile中的每一步，第一次可能会花点时间。
构建成功后，使用 docker images 查看镜像列表。接下来运行它：
docker run -d -p 5000:8080 --name myapp mydockerizedapp:1.0
解释一下参数：
-d：后台运行（守护进程模式）。-p 5000:8080：端口映射，将宿主机的5000端口映射到容器的8080端口（我们在Dockerfile中设置的）。--name myapp：给容器起个名字，方便管理。
现在，打开浏览器访问 http://localhost:5000，你应该能看到 “MyDockerizedApp is running successfully!” 的字样。太棒了！我们的应用已经在容器里跑起来了。
你可以用以下命令管理容器：
docker ps # 查看运行中的容器
docker logs myapp # 查看容器日志（排查问题的利器）
docker stop myapp # 停止容器
docker rm myapp # 删除容器
四、进阶优化：使用.dockerignore与生产配置
为了构建更快、镜像更精简，我们需要一个 .dockerignore 文件。它类似于 .gitignore，告诉Docker在构建时忽略哪些文件和目录。在项目根目录创建它：
**/.classpath
**/.dockerignore
**/.env
**/.git
**/.gitignore
**/.project
**/.settings
**/.toolstarget
**/.vs
**/.vscode
**/*.*proj.user
**/*.dbmdl
**/*.jfm
**/bin
**/obj
**/node_modules
**/Dockerfile*
**/docker-compose*
**/README.md
这能避免将本地开发环境文件、编译输出目录等不必要的文件复制到镜像中。
生产环境配置：在 appsettings.Production.json 或通过环境变量来配置生产环境设置。在Docker运行时可以传入环境变量：
docker run -d -p 5000:8080
-e ASPNETCORE_ENVIRONMENT=Production
-e "ConnectionStrings:DefaultConnection=YourProdDbString"
--name myapp-prod mydockerizedapp:1.0
五、发布与部署：推送到镜像仓库
本地测试无误后，就可以将镜像推送到公共（如Docker Hub）或私有镜像仓库，供生产服务器拉取。
- 登录Docker Hub：
docker login - 重新打标签，符合仓库命名规范（你的用户名/镜像名）：
docker tag mydockerizedapp:1.0 yourdockerhubusername/mydockerizedapp:1.0 - 推送镜像：
docker push yourdockerhubusername/mydockerizedapp:1.0
在生产服务器上，只需要安装Docker，然后一行命令即可部署：
docker run -d -p 80:8080 --restart=always yourdockerhubusername/mydockerizedapp:1.0参数 --restart=always 确保容器在意外退出或服务器重启时自动启动，这对于生产服务至关重要。
六、总结与后续方向
至此，我们已经走完了ASP.NET Core应用容器化部署的核心流程：准备 -> 编写Dockerfile -> 构建 -> 本地测试 -> 优化 -> 发布部署。整个过程一旦跑通，你会发现部署变得异常简单和一致。
但这只是起点。要真正用于生产，你还需要探索：
- Docker Compose：用于定义和运行多容器应用（比如应用+数据库）。
- Kubernetes (K8s)：用于容器编排、自动扩缩容和服务发现，是管理大规模容器化应用的工业标准。
- CI/CD流水线：将Docker构建和推送集成到GitHub Actions、GitLab CI或Azure DevOps中，实现自动化。
容器化就像给应用程序打包了一个独立的“旅行箱”，里面装好了运行所需的一切，让它能在任何支持Docker的环境中无缝运行。希望这篇实战指南能帮你顺利打好这个“行李”，开启云原生开发之旅。如果在实践中遇到问题，欢迎在源码库社区交流讨论，我们共同进步。
评论(0)