.NET项目Docker容器化实战教程

.NET项目Docker容器化实战教程

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

前言

容器化技术已经成为现代应用开发和部署的重要方式。Docker作为最流行的容器化平台，为.NET应用的打包和分发提供了标准化的解决方案。本教程将手把手教你如何将一个简单的.NET控制台应用程序容器化，让你掌握Docker与.NET结合的核心技能。

准备工作

在开始之前，请确保你的开发环境已安装以下工具：

1. .NET SDK（8.0或9.0版本）
2. Docker Desktop（社区版即可）
3. 一个用于存放项目的临时工作目录（本教程使用docker-working）

创建.NET控制台应用

首先我们需要一个简单的.NET应用作为容器化的目标。打开终端，执行以下命令创建一个控制台项目：

dotnet new console -o App -n DotNet.Docker

这会在App目录下创建一个基本的"Hello World"控制台应用。为了演示容器化效果，我们将修改Program.cs文件，使其成为一个持续运行的计数器程序：

var count = 0;
while (true)
{
    Console.WriteLine($"Counter: {++count}");
    await Task.Delay(1000);
}

这个程序会每秒输出一个递增的数字，直到被手动终止。

发布应用

为了容器化，我们需要先发布应用：

dotnet publish -c Release

发布后的文件会生成在bin/Release/<TFM>/publish目录下，其中包含我们需要的DLL和可执行文件。

编写Dockerfile

Dockerfile是定义容器构建过程的核心文件。在项目根目录创建Dockerfile，内容如下：

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /App
COPY . .
RUN dotnet publish -c Release -o out

# 运行时阶段
FROM mcr.microsoft.com/dotnet/aspnet:9.0
WORKDIR /App
COPY --from=build /App/out .
ENTRYPOINT ["dotnet", "DotNet.Docker.dll"]

这个Dockerfile使用了多阶段构建技术：

1. 第一阶段基于SDK镜像构建应用
2. 第二阶段仅包含运行时环境
3. 最终镜像只包含必要的运行时和发布文件

构建Docker镜像

执行以下命令构建镜像：

docker build -t counter-image -f Dockerfile .

参数说明：

• -t 指定镜像名称和标签
• -f 指定Dockerfile路径
• . 表示当前目录为构建上下文

构建完成后，可以使用docker images查看生成的镜像。

运行容器

创建容器

docker create --name core-counter counter-image

启动容器

docker start core-counter

查看运行日志

docker logs core-counter

停止容器

docker stop core-counter

高级技巧

传递参数

如果你想在容器启动时传递参数给应用，可以使用：

docker run counter-image 5

环境变量配置

可以在Dockerfile中设置环境变量：

ENV DOTNET_EnableDiagnostics=0

容器资源限制

启动时可以限制容器资源：

docker run -d --name my-counter --memory=512m --cpus=1 counter-image

常见问题解决

1. Windows容器问题：如果使用Windows容器，需要指定完整的镜像标签，如mcr.microsoft.com/dotnet/aspnet:9.0-nanoserver-1809

2. 权限问题：Linux容器可能需要调整文件权限，可以在Dockerfile中添加：

   RUN chmod +x ./DotNet.Docker
   

3. 时区问题：如果需要正确时区，可以添加：

   ENV TZ=Asia/Shanghai
   RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime
   

总结

通过本教程，你已经学会了：

1. 创建基本的.NET控制台应用
2. 编写高效的Dockerfile
3. 构建优化的Docker镜像
4. 运行和管理容器

容器化技术为.NET应用提供了标准化的部署方式，使应用可以在任何支持Docker的环境中一致运行。掌握这些技能将为你的DevOps实践打下坚实基础。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs