ASP.NET Core 的 Docker 映像Docker images for ASP.NET Core

本文内容

本教程演示如何在 Docker 容器中运行 ASP.NET Core 应用。

在本教程中，你将了解：

  • 了解 Microsoft.NET 核心 Docker 映像
  • 下载 ASP.NET Core 示例应用
  • 本地运行示例应用
  • 在 Linux 容器中运行示例应用
  • 在 Windows 容器中运行示例应用
  • 手动生成和部署

ASP.NET Core Docker 映像ASP.NET Core Docker images

在本教程中，你下载 ASP.NET Core 示例应用并在 Docker 容器中运行它。此示例适用于 Linux 和 Windows 容器。

示例 Dockerfile 使用 Docker 多阶段构建功能在不同的容器中生成和运行。生成和运行容器是由 Microsoft 从 Docker 中心提供的映像中创建的：

  • dotnet/core/sdk

此示例将此映像用于生成应用。此映像包含带有命令行工具 (CLI) 的 .NET Core SDK。此映像对本地开发、调试和单元测试进行了优化。为开发和编译而安装的工具使其成为一个相对较大的映像。

  • dotnet/core/aspnet

此示例将此映像用于运行应用。此映像包含 ASP.NET Core 运行时和库，并针对在生产中运行应用进行了优化。此映像专为部署和应用启动的速度而设计，相对较小，因此优化了从 Docker 注册表到 Docker 主机的网络性能。仅将运行应用所需的二进制文件和内容复制到容器。已准备运行内容，以此实现从 Docker run 到应用启动的最快时间。Docker 模型中不需要动态代码编译。

先决条件Prerequisites

下载示例应用Download the sample app

  1. git clone https://github.com/dotnet/dotnet-docker

本地运行应用Run the app locally

  • 导航到 dotnet-docker/samples/aspnetapp/aspnetapp 下的项目文件夹。

  • 运行以下命令以本地生成并运行应用：

  1. dotnet run

  • 在浏览器中转到 http://localhost:5000 以测试应用。

  • 在命令提示符处按 Ctrl+C 以停止应用。

在 Linux 容器中运行Run in a Linux container

  • 在 Docker 客户端中，切换到 Linux 容器。

  • 导航到 dotnet-docker/samples/aspnetapp 下的 Dockerfile 文件夹。

  • 运行以下命令以在 Docker 中生成并运行示例：

  1. docker build -t aspnetapp .
  2. docker run -it --rm -p 5000:80 --name aspnetcore_sample aspnetapp

build 命令参数：

  • 将映像命名为 aspnetapp。

  • 在当前文件夹（末尾的句点）中查找 Dockerfile。
    运行命令参数：

  • 分配伪 TTY，即使未附加也使其保持打开状态。（与 —interactive —tty 的效果相同。）

  • 容器在退出时自动删除。
  • 将本地计算机上的端口 5000 映射到容器中的端口 80。
  • 将容器命名为 aspnetcore_sample。
  • 指定 aspnetapp 映像。

在 Windows 容器中运行Run in a Windows container

  • 在 Docker 客户端中，切换到 Windows 容器。

导航到 dotnet-docker/samples/aspnetapp 下的 docker 文件文件夹。

  • 运行以下命令以在 Docker 中生成并运行示例：
  1. docker build -t aspnetapp .
  2. docker run -it --rm --name aspnetcore_sample aspnetapp

  • 对于 Windows 容器，你需要容器的 IP 地址（浏览到 http://localhost:5000 不起作用）：

    • 打开另一个命令提示符。

    • 运行 docker ps 以查看正在运行的容器。验证其中是否包含“aspnetcore_sample”容器。

    • 运行 docker exec aspnetcore_sample ipconfig 以显示容器的 IP 地址。该命令的输出如以下示例所示：

  1. Ethernet adapter Ethernet:
  3.    Connection-specific DNS Suffix  . : contoso.com
  4.    Link-local IPv6 Address . . . . . : fe80::1967:6598:124:cfa3%4
  5.    IPv4 Address. . . . . . . . . . . : 172.29.245.43
  6.    Subnet Mask . . . . . . . . . . . : 255.255.240.0
  7.    Default Gateway . . . . . . . . . : 172.29.240.1
  • 将容器 IPv4 地址（例如，172.29.245.43）复制并粘贴到浏览器地址栏以测试应用。

手动生成和部署Build and deploy manually

在某些情况下，你可能希望通过将运行时所需的应用程序文件复制到容器来将应用部署到容器。本部分演示如何手动进行部署。

  • 导航到 dotnet-docker/samples/aspnetapp/aspnetapp 下的项目文件夹。

  • 运行 dotnet publish 命令：

  1. dotnet publish -c Release -o published

命令参数：

  • 在发布模式（默认为调试模式）下生成应用程序。

  • 在“已发布”文件夹中创建文件 。

    • 运行该应用程序。

  • Windows：

  1. dotnet published\aspnetapp.dll
  • Linux：
  1. dotnet published/aspnetapp.dll

要在 Docker 容器中使用手动发布的应用程序，请创建新的 Dockerfile，并使用 docker build . 命令构建容器。

  1. FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS runtime
  2. WORKDIR /app
  3. COPY published/aspnetapp.dll ./
  4. ENTRYPOINT ["dotnet", "aspnetapp.dll"]

DockerfileThe Dockerfile

下面是先前运行的 docker build 命令使用的 Dockerfile 。它以本部分中所用的方式使用 dotnet publish 进行生成和部署。

  1. FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS build
  2. WORKDIR /app
  4. # copy csproj and restore as distinct layers
  5. COPY *.sln .
  6. COPY aspnetapp/*.csproj ./aspnetapp/
  7. RUN dotnet restore
  9. # copy everything else and build app
  10. COPY aspnetapp/. ./aspnetapp/
  11. WORKDIR /app/aspnetapp
  12. RUN dotnet publish -c Release -o out
  15. FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS runtime
  16. WORKDIR /app
  17. COPY --from=build /app/aspnetapp/out ./
  18. ENTRYPOINT ["dotnet", "aspnetapp.dll"]
  1. FROM mcr.microsoft.com/dotnet/core/aspnet:3.0 AS runtime
  2. WORKDIR /app
  3. COPY published/aspnetapp.dll ./
  4. ENTRYPOINT ["dotnet", "aspnetapp.dll"]

DockerfileThe Dockerfile

下面是先前运行的 docker build 命令使用的 Dockerfile 。它以本部分中所用的方式使用 dotnet publish 进行生成和部署。

  1. FROM mcr.microsoft.com/dotnet/core/sdk:3.0 AS build
  2. WORKDIR /app
  4. # copy csproj and restore as distinct layers
  5. COPY *.sln .
  6. COPY aspnetapp/*.csproj ./aspnetapp/
  7. RUN dotnet restore
  9. # copy everything else and build app
  10. COPY aspnetapp/. ./aspnetapp/
  11. WORKDIR /app/aspnetapp
  12. RUN dotnet publish -c Release -o out
  15. FROM mcr.microsoft.com/dotnet/core/aspnet:3.0 AS runtime
  16. WORKDIR /app
  17. COPY --from=build /app/aspnetapp/out ./
  18. ENTRYPOINT ["dotnet", "aspnetapp.dll"]
  1. FROM mcr.microsoft.com/dotnet/core/aspnet:3.0 AS runtime
  2. WORKDIR /app
  3. COPY published/aspnetapp.dll ./
  4. ENTRYPOINT ["dotnet", "aspnetapp.dll"]

其他资源Additional resources

后续步骤Next steps

包含示例应用的 Git 存储库还包括文档。有关存储库中可用资源的概述，请参阅自述文件。特别是，了解如何实现 HTTPS：

使用 Docker over HTTPS 开发 ASP.NET Core 应用程序