microsoft/dotnet-samples

特色标签

• dotnetapp https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/Dockerfile
  • docker pull ***-mcr.xuanyuan.run/dotnet/samples:dotnetapp
  • docker pull ***-mcr.xuanyuan.run/dotnet/samples:dotnetapp-chiseled
• aspnetapp https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/Dockerfile
  • docker pull ***-mcr.xuanyuan.run/dotnet/samples:aspnetapp
  • docker pull ***-mcr.xuanyuan.run/dotnet/samples:aspnetapp-chiseled

关于

这些镜像包含示例.NET和ASP.NET Core应用程序。

关注https://github.com/dotnet/dotnet-docker/discussions/categories/announcements%E4%BB%A5%E8%8E%B7%E5%8F%96Docker%E7%9B%B8%E5%85%B3%E7%9A%84.NET%E5%85%AC%E5%91%8A%E3%80%82

使用方法

https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md%E5%B1%95%E7%A4%BA%E4%BA%86%E5%B0%86.NET%E5%92%8CDocker%E7%BB%93%E5%90%88%E4%BD%BF%E7%94%A8%E7%9A%84%E5%90%84%E7%A7%8D%E6%96%B9%E5%BC%8F%E3%80%82%E6%9C%89%E5%85%B3%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85.NET%E5%92%8CDocker%E7%AE%80%E4%BB%8B%E3%80%82

容器示例：运行简单应用程序

您可以基于https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/README.md%EF%BC%8C%E4%BD%BF%E7%94%A8%E9%A2%84%E6%9E%84%E5%BB%BA%E7%9A%84https://hub.docker.com/r/microsoft/dotnet-samples/%E5%BF%AB%E9%80%9F%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E3%80%82

输入以下命令运行示例控制台应用程序：

console
docker run --rm ***-mcr.xuanyuan.run/dotnet/samples

容器示例：运行Web应用程序

您可以基于https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md%EF%BC%8C%E4%BD%BF%E7%94%A8%E9%A2%84%E6%9E%84%E5%BB%BA%E7%9A%84https://hub.docker.com/r/microsoft/dotnet-samples/%E5%BF%AB%E9%80%9F%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E3%80%82

输入以下命令运行示例Web应用程序：

console
docker run -it --rm -p 8000:8080 --name aspnetcore_sample ***-mcr.xuanyuan.run/dotnet/samples:aspnetapp

应用程序启动后，在Web浏览器中导航至http://localhost:8000。您也可以从另一台机器通过本地IP地址（如http://192.168.1.18:8000）访问容器中运行的ASP.NET Core站点。

注意：从.NET 8开始，ASP.NET Core应用（在官方镜像中）默认监听https://github.com/dotnet/dotnet-docker/blob/6da64f31944bb16ecde5495b6a53fc170fbe100d/src/runtime-deps/8.0/bookworm-slim/amd64/Dockerfile#L7%E3%80%82%E8%BF%99%E4%BA%9B%E7%A4%BA%E4%BE%8B%E4%B8%AD%E7%9A%84https://docs.docker.com/engine/reference/commandline/run/#publish%E5%B0%86%E4%B8%BB%E6%9C%BA%E7%AB%AF%E5%8F%A3%608000%60%E6%98%A0%E5%B0%84%E5%88%B0%E5%AE%B9%E5%99%A8%E7%AB%AF%E5%8F%A3%608080%60%EF%BC%88%60%E4%B8%BB%E6%9C%BA:%E5%AE%B9%E5%99%A8%60%E6%98%A0%E5%B0%84%EF%BC%89%E3%80%82%E6%B2%A1%E6%9C%89%E6%AD%A4%E6%98%A0%E5%B0%84%EF%BC%8C%E5%AE%B9%E5%99%A8%E5%B0%86%E6%97%A0%E6%B3%95%E8%AE%BF%E9%97%AE%E3%80%82%E5%8F%AF%E4%BB%A5%E9%85%8D%E7%BD%AEASP.NET Core监听其他或额外端口。

有关如何将HTTPS与该镜像一起使用，请参阅https://github.com/dotnet/dotnet-docker/blob/main/samples/host-aspnetcore-https.md%E3%80%82

镜像变体

.NET容器镜像有多种变体，提供不同的灵活性和部署大小组合。https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md%E5%8C%85%E5%90%AB%E9%95%9C%E5%83%8F%E5%8F%98%E4%BD%93%E5%8F%8A%E5%85%B6%E7%94%A8%E4%BE%8B%E7%9A%84%E6%91%98%E8%A6%81%E3%80%82

精简镜像（Distroless images）

.NEThttps://github.com/dotnet/dotnet-docker/blob/main/documentation/distroless.md仅包含.NET所需的最小软件包集，其他所有内容均已移除。由于其有限的软件包集，与非精简容器相比，精简容器具有最小化的安全***面、更小的部署大小和更快的启动时间。它们包含以下特性：

• .NET应用程序所需的最小软件包集
• 默认使用非root用户
• 无包管理器
• 无shell

.NET为https://github.com/dotnet/dotnet-docker/blob/main/documentation/azurelinux.md%E5%92%8Chttps://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-***ed.md%E6%8F%90%E4%BE%9B%E7%B2%BE%E7%AE%80%E9%95%9C%E5%83%8F%E3%80%82

相关仓库

.NET：

• https://hub.docker.com/r/microsoft/dotnet/%EF%BC%9A.NET
• https://hub.docker.com/r/microsoft/dotnet-sdk/%EF%BC%9A.NET SDK
• https://hub.docker.com/r/microsoft/dotnet-aspnet/%EF%BC%9AASP.NET Core运行时
• https://hub.docker.com/r/microsoft/dotnet-runtime/%EF%BC%9A.NET%E8%BF%90%E8%A1%8C%E6%97%B6
• https://hub.docker.com/r/microsoft/dotnet-runtime-deps/%EF%BC%9A.NET%E8%BF%90%E8%A1%8C%E6%97%B6%E4%BE%9D%E8%B5%96%E9%A1%B9
• https://hub.docker.com/r/microsoft/dotnet-monitor/%EF%BC%9A.NET%E7%9B%91%E6%8E%A7%E5%B7%A5%E5%85%B7
• https://hub.docker.com/r/microsoft/dotnet-aspire-dashboard/%EF%BC%9A.NET Aspire仪表板

.NET Framework：

• https://hub.docker.com/r/microsoft/dotnet-framework/%EF%BC%9A.NET Framework、ASP.NET和WCF
• https://hub.docker.com/r/microsoft/dotnet-framework-samples/%EF%BC%9A.NET Framework、ASP.NET和WCF示例

完整标签列表

在Microsoft Artifact Registry门户或https://github.com/dotnet/dotnet-docker/blob/main/README.samples.md#full-tag-listing%E4%B8%8A%E6%9F%A5%E7%9C%8B%E5%BD%93%E5%89%8D%E6%A0%87%E7%AD%BE%E3%80%82

支持

这些示例镜像不用于生产环境，可能随时发生破坏性变更或被移除。它们作为开发人员在容器化环境中试验和了解.NET的起点提供。

生命周期

• https://github.com/dotnet/core/blob/main/support.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md

镜像更新策略

• 基础镜像更新：镜像会在其基础镜像（如debian:bookworm-slim、windows/nanoserver:ltsc2022等）有任何更新后的12小时内重新构建。
• .NET版本发布：镜像会在发布新的.NET版本时重新构建，包括新的主要版本、次要版本和服务版本。
• 严重CVE：镜像会重新构建以获取严重CVE修复，如以下CVE更新策略所述。
• 月度重新构建：镜像每月重新构建，通常在当月的第二个星期二，以获取低严重性CVE修复。
• 带外更新：有时可能需要重新构建镜像以解决关键问题。如果发生这种情况，新的修复版本标签将根据https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md#fixed-version-tags%E8%BF%9B%E8%A1%8C%E6%9B%B4%E6%96%B0%E3%80%82

CVE更新策略

.NET容器镜像会定期监控CVE的存在。当满足以下条件时，给定镜像将重新构建以获取CVE修复：

• 我们检测到镜像包含https://nvd.nist.gov/vuln-metrics/cvss%E8%AF%84%E5%88%86%E4%B8%BA%E2%80%9C%E4%B8%A5%E9%87%8D%E2%80%9D%E7%9A%84CVE
• 并且该CVE位于我们Dockerfile层中添加的软件包中（即该CVE位于我们显式安装的软件包或这些软件包的任何传递依赖项中）
• 并且受影响的基础镜像的软件包仓库中提供了该软件包的CVE修复。

有关在.NET镜像中遇到CVE时该怎么做的更多详细信息，请参阅https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md%E5%92%8Chttps://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md%E3%80%82

反馈

• https://github.com/dotnet/dotnet-docker/issues/new/choose
• 联系Microsoft支持

许可证

• ***声明：https://aka.ms/mcr/osslegalnotice
• https://github.com/dotnet/dotnet-docker/blob/main/LICENSE
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-artifact-details.md
• Windows基础镜像许可证（仅适用于Windows容器）
• Windows Server定价和许可