要在容器中运行.net应用程序,你需要在容器镜像中安装.net Framework或.net Core 运行时。这不是你需要自己管理的东西,因为微软提供的Docker镜像已经安装了运行时,你可以使用它们作为基础镜像来打包你自己的应用程序。
. net镜像有几种变体,涵盖了不同的版本和不同的运行时。本文将指导你为应用程序选择正确的镜像。
使用基础镜像
你的应用需要运行一堆先决条件,比如操作系统和语言运行时。通常,平台所有者会打包一个安装了所有预请求的镜像,并将其发布到Docker Hub上——你会看到Go, Node.js, Java等都是官方镜像。
微软对.net应用程序也做了同样的事情,所以你可以使用它们的一个镜像作为基础镜像。它们定期更新,所以你可以通过使用最新的微软镜像重建它们来修补你的镜像。
.NET应用程序的Docker镜像托管在微软自己的容器注册表mcr.microsoft.com上,但它们仍然列在Docker Hub上,所以你可以在那里找到它们:
- .NET Core和.NET 5在Docker Hub上的镜像
- .NET Framework在Docker Hub上的镜像
这些页面列出了许多不同的.net镜像变体,并将它们划分为SDK镜像和运行时镜像。
你可以用一个简单的Dockerfile来打包.net应用:
FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8 SHELL ["powershell"] COPY app.msi / RUN Start-Process msiexec.exe -ArgumentList '/i', 'C:\app.msi', '/quiet', '/norestart' -NoNewWindow -Wait
这是一种进入Docker的简单方法,获取一个现有的部署包(在本例中是一个MSI安装程序),并使用在容器中运行的PowerShell命令安装它。
这个例子使用了ASP.NET 4.8的基本镜像,所以你从这个Dockerfile构建的镜像:
-
拥有IIS, . net Framework 4.8和ASP.NET已经配置。
-
从MSI部署你的应用程序,希望是一个ASP.NET应用程序。
-
需要有一个现有的进程来创建MSI。
这是一个简单的方法,但它有问题,因为Dockerfile是打包格式,它应该包含部署的所有细节,但所有的安装步骤都隐藏在MSI中。
相反,你可以使用Docker从源代码编译应用程序,这是SDK镜像的来源。这些SDK镜像有你的应用程序的所有构建工具:MSBuild和NuGet或dotnet CLI。你可以在一个多阶段Docker构建中使用它们,其中阶段1从源代码编译,阶段2从阶段1构建:
# the build stage uses the SDK image: FROM mcr.microsoft.com/dotnet/core/sdk:3.1 as builder COPY src /src RUN dotnet publish -c Release -o /out app.csproj # the final app uses the runtime image: FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 COPY --from=builder /out/ . ENTRYPOINT ["dotnet", "app.dll"]
这种方法更好,因为:
-
整个构建是可移植的,你只需要Docker和源代码来构建和运行应用程序,你不需要在你的机器上安装任何.net sdk或运行时。
-
你的Dockerfile是部署脚本,每一步都很清晰,并且它在没有额外的部署工作。
-
你的最终镜像有它需要的所有运行时要求。
仍然有很多.net Docker镜像的变体,所以下一个任务是找出哪些可以用于不同的应用程序。
.NET Framework应用程序的Docker镜像
. net Framework应用程序是最简单的,因为它们只运行在Windows上,而且它们需要完整的Windows Server核心功能集。
你可以在任何你想要容器化的. net Framework应用中使用它们——你可以在Docker、Docker Swarm和Kubernetes中使用Windows容器来运行它们。
目前所有的. net Framework Docker镜像都使用mcr.microsoft.com/windows/servercore:lts2019作为基础镜像——这是Windows Server Core 2019的最新长期支持版本。
然后.net镜像以层次结构的形式从基本的Windows镜像中扩展出来:
.NET Core应用的Docker镜像
. net Core有点复杂,因为它是一个跨平台框架,有不同的镜像可供Windows和Linux容器使用。你将优先使用Linux,因为它们更精简,而且不需要为主机支付操作系统许可证。
Linux的变体源自Debian,它们使用类似于.net Framework镜像的分层构建方法和相同的命名标准:
这些镜像的名字需要再次使用mcr.microsoft.com/前缀,现在aspnet: 3.1是aspnet别名:3.1.11,但下个月3.1相同的标签将被用于一个更新的版本。
- dotnet/core/runtime:3.1包含.net core runtime,所以你可以使用控制台应用;
- dotnet/core/sdk:3.1已经安装了sdk,所以你可以在构建阶段使用它来编译.net core应用程序;
- dotnet /core/ aspnet: 3.1 ASP.NET Core 3.1已安装,所以你可以使用它来运行web应用程序。
.NET Core 3.1将支持到2022年12月;2.1也是一个LTS版本,支持到2021年8月,并且有用于2.1运行时的镜像,使用相同的镜像名称和标签:2.1。你可以在dotnet/dotnet-docker中找到GitHub上的所有Dockerfiles和一些示例应用程序。
还有一些.net core镜像的Alpine Linux版本,它们更小更精简。如果你正在构建运行在Linux上的镜像,而你对跨平台运行在Windows上不感兴趣,这些是最好的-但有些依赖不能在Alpine正常工作(Sqlite是其中之一),所以你需要测试你的应用:
- dotnet /core/runtime:3.1-alpine
- dotnet /core/ sdk: 3.1-alpine
- dotnet /core/ aspnet: 3.1-alpine
如果你想用相同的源代码和dockerfile构建Linux和Windows的镜像,坚持使用通用的:3.1——这些是多架构的镜像,所以有针对Linux、Windows、Intel和Arm 64的版本。
Windows版本都是基于Nano服务器的:
注意,它们有相同的镜像名称-多架构的镜像Docker会拉出正确的版本来匹配你使用的操作系统和CPU。你可以通过查看清单来检查所有可用的版本:
docker manifest inspect mcr.microsoft.com/dotnet/core/runtime:3.1
你将在响应中看到JSON,其中包括所有版本的详细信息——以下是删减后的版本:
"manifests": [ { "digest": "sha256:6c67be...", "platform": { "architecture": "amd64", "os": "linux" } }, { "digest": "sha256:d50e61...", "platform": { "architecture": "arm64", "os": "linux", "variant": "v8" } }, { "digest": "sha256:3eb5f6...", "platform": { "architecture": "amd64", "os": "windows", "os.version": "10.0.17763.1697" } }, { "digest": "sha256:4d53d2d...", "platform": { "architecture": "amd64", "os": "windows", "os.version": "10.0.18363.1316" } } ]
你可以在这里看到镜像标签dotnet/core/runtime:3.1有用于Intel上的Linux、Arm上的Linux和Intel上的多个Windows版本的镜像版本。
只要你保持你的dockerfile是通用的——并且在运行指令中不包含特定于操作系统的命令——你就可以基于微软的镜像构建你自己的多架构 . net Core应用。
前进吧-.net 5的Docker镜像
.NET 5是.net Core的新版本,在MCR上有一些常见版本的Docker镜像:
- dotnet /runtime:5.0
- dotnet / sdk: 5.0
- dotnet / aspnet: 5.0
将.net Core应用迁移到.net 5应该是一个简单的改变,但是请记住5不是一个LTS版本——你需要等待.net 6,它是LTS的。
欢迎关注我的公众号,如果你有喜欢的外文技术文章,可以通过公众号留言推荐给我。
原文链接:https://blog.sixeyed.com/understanding-microsofts-docker-images-for-net-apps/