mpospisil/dotnet-runtime-windowsdesktop

.NET 运行时集成Docker镜像文档

镜像概述

本Docker镜像旨在提供一站式的.NET应用运行环境，集成了Microsoft.AspNetCore.App（ASP.NET Core运行时）、Microsoft.NETCore.App（.NET Core运行时）、Microsoft.WindowsDesktop.App（Windows桌面应用运行时）及vc_redist.x64（Visual C++ redistributable），确保各类.NET应用在容器化环境中能够稳定运行，无需单独配置依赖。

核心功能与特性

1. 多运行时集成

• Microsoft.NETCore.App：提供.NET Core基础运行时，支持控制台应用、类库等.NET Core程序的执行。
• Microsoft.AspNetCore.App：包含ASP.NET Core运行时组件，支持Web应用、API服务等ASP.NET Core应用的部署。
• Microsoft.WindowsDesktop.App：集成Windows桌面应用运行时，支持WPF、Windows Forms等桌面应用在容器中运行。

2. 依赖完整性

• 内置vc_redist.x64（Visual C++ Redistributable for Visual Studio），解决.NET应用对C++运行时库的依赖，避免因缺失系统组件导致的运行错误。

3. 环境一致性

• 标准化运行环境配置，确保应用在开发、测试、生产等不同环境中表现一致，减少"环境不一致"问题。

使用场景

• 开发与测试环境：为开发人员提供本地一致的运行环境，简化应用调试流程。
• 持续集成/持续部署（CI/CD）：作为CI/CD流水线中的运行环境，验证应用在容器化部署下的兼容性。
• 生产环境：部署ASP.NET Core Web应用、.NET Core服务或Windows桌面应用（需容器平台支持Windows容器），提供稳定的运行载体。

使用方法与配置说明

基本使用示例

通过docker run命令启动容器，挂载应用目录并运行.NET应用：

bash
docker run -d --name dotnet-app-container \
  -v /path/to/your/app:/app \
  -p 8080:80 \
  [镜像名称]:[标签] \
  dotnet /app/YourApp.dll

参数说明

• -v /path/to/your/app:/app：将本地应用目录挂载到容器内/app路径，供容器访问应用程序集。
• -p 8080:80：端口映射，将容器内Web应用默认端口80映射到主机8080端口（适用于ASP.NET Core应用）。
• [镜像名称]:[标签]：替换为实际的Docker镜像名称及版本标签。
• dotnet /app/YourApp.dll：执行应用启动命令，根据应用类型调整（如桌面应用可直接运行可执行文件）。

环境变量配置

可通过环境变量调整运行时行为（具体变量取决于应用需求）：

• ASPNETCORE_URLS：设置ASP.NET Core应用监听地址，如http://*:5000。
• DOTNET_ENVIRONMENT：指定.NET环境（Development/Staging/Production），默认值为Production。

注意事项

• 若运行Windows桌面应用，需确保容器平台支持Windows容器（如Docker Desktop启用Windows容器模式）。
• 应用需提前编译为与镜像中.NET运行时版本兼容的程序集，避免版本不匹配导致启动失败。
• 生产环境中建议结合Docker Compose或Kubernetes进行编排，实现服务扩缩容与高可用。