带有 ASP.NET Core 的 Visual Studio 容器工具
注意
此版本不是本文的最新版本。 有关当前版本，请参阅本文的 .NET 9 版本。
警告
此版本的 ASP.NET Core 不再受支持。 有关详细信息，请参阅 .NET 和 .NET Core 支持策略。 对于当前版本，请参阅此文的 .NET 8 版本。
Visual Studio 2017 及更高版本支持构建、调试和运行面向 .NET Core 且已容器化的 ASP.NET Core 应用。 Windows 和 Linux 容器均受支持。
先决条件
- Docker for Windows
- 带有 .NET Core 跨平台开发工作负载的 Visual Studio 2019
安装和设置
如需安装 Docker，请先通过用于 Windows 的 Docker：安装须知了解相关信息。 然后安装用于 Windows 的 Docker。
Docker for Windows 中的共享驱动器必须配置为支持卷映射和调试。 右键单击系统托盘中的 Docker 图标，单击“设置”，然后选择“共享驱动器”。 选择 Docker 存储文件的驱动器。 单击“应用”。
提示
未配置共享驱动器时，Visual Studio 2017 15.6 及更高版本会发出提示。
向 Docker 容器添加项目
若要容器化 ASP.NET Core 项目，项目必须面向 .NET Core。 同时支持 Linux 和 Windows 容器。
向项目添加 Docker 支持后，可选择 Windows 或 Linux 容器。 Docker 主机必须运行类型相同的容器。 要更改正在运行的 Docker 实例中的容器类型，请右键单击系统托盘中的 Docker 图标，再选择“切换到 Windows 容器...”或“切换到 Linux 容器...” 。
新应用
使用 ASP.NET Core Web 应用程序项目模板创建新应用时，请选中“启用 Docker 支持”复选框：
如果目标框架是 .NET Core，可通过 OS 下拉列表选择容器类型。
现有应用
对于面向 .NET Core 的 ASP.NET Core 项目，可通过两个选项使用工具添加 Docker 支持。 在 Visual Studio 中打开项目，然后选择以下选项之一：
- 从“项目”菜单中选择“Docker 支持” 。
- 右键单击“解决方案资源管理器”中的项目，然后选择“添加”>“Docker 支持” 。
Visual Studio 容器工具不支持向面向 .NET Framework 的现有 ASP.NET Core 项目添加 Docker。
Dockerfile 概述
Dockerfile，用作创建最终 Docker 映像的方案，添加到项目根目录。 请参阅 Dockerfile 引用，了解其中的命令。 此特定 Dockerfile 使用多阶段生成，该生成包含四个不同的命名生成阶段：
FROM mcr.microsoft.com/dotnet/core/aspnet:2.1 AS base
WORKDIR /app
EXPOSE 59518
EXPOSE 44364
FROM mcr.microsoft.com/dotnet/core/sdk:2.1 AS build
WORKDIR /src
COPY HelloDockerTools/HelloDockerTools.csproj HelloDockerTools/
RUN dotnet restore HelloDockerTools/HelloDockerTools.csproj
COPY . .
WORKDIR /src/HelloDockerTools
RUN dotnet build HelloDockerTools.csproj -c Release -o /app
FROM build AS publish
RUN dotnet publish HelloDockerTools.csproj -c Release -o /app
FROM base AS final
WORKDIR /app
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "HelloDockerTools.dll"]
前面的 Dockerfile 映像包括 ASP.NET Core 运行时和 NuGet 包。 对该包进行了实时 (JIT) 编译，以提高启动性能。
如果选中了新建项目对话框的“为 HTTPS 配置”复选框，则 Dockerfile 公开两个端口。 一个端口用于 HTTP 流量；另一个端口用于 HTTPS。 如果未选中该复选框，则为 HTTP 流量公开单个端口 (80)。
FROM microsoft/aspnetcore:2.0 AS base
WORKDIR /app
EXPOSE 80
FROM microsoft/aspnetcore-build:2.0 AS build
WORKDIR /src
COPY HelloDockerTools/HelloDockerTools.csproj HelloDockerTools/
RUN dotnet restore HelloDockerTools/HelloDockerTools.csproj
COPY . .
WORKDIR /src/HelloDockerTools
RUN dotnet build HelloDockerTools.csproj -c Release -o /app
FROM build AS publish
RUN dotnet publish HelloDockerTools.csproj -c Release -o /app
FROM base AS final
WORKDIR /app
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "HelloDockerTools.dll"]
前面的 Dockerfile 映像包括 ASP.NET Core NuGet 包，对该包进行了实时编译 (JIT)，以提高启动性能。
向应用添加容器业务流程协调程序支持
Visual Studio 2017 版本 15.7 或更早版本支持 Docker Compose 作为唯一的容器业务流程解决方案。 可通过“添加”>“Docker 支持”添加 Docker Compose 。
Visual Studio 2017 版本 15.8 或更高版本仅在获得指示时添加业务流程解决方案。 右键单击“解决方案资源管理器”中的项目，然后选择“添加”>“容器业务流程协调程序支持” 。 可用选项如下：
Docker Compose
Visual Studio 容器工具通过以下文件向解决方案添加 docker-compose 项目：
- docker-compose.dcproj：表示项目的文件。 包括
<DockerTargetOS>元素，用于指定要使用的操作系统。 - .dockerignore：列出在生成生成上下文时要排除的文件和目录模式。
- docker-compose.yml：基本 Docker Compose 文件，用于定义要分别通过
docker-compose build和docker-compose run生成和运行的映像集合。 - docker-compose.override.yml：一个可选文件，通过 Docker Compose 读取，包含服务的配置替代。 Visual Studio 执行
docker-compose -f "docker-compose.yml" -f "docker-compose.override.yml"以合并这些文件。
docker-compose.yml 文件引用在项目运行时创建的映像的名称：
version: '3.4'
services:
hellodockertools:
image: ${DOCKER_REGISTRY}hellodockertools
build:
context: .
dockerfile: HelloDockerTools/Dockerfile
在前面的示例中，应用在“调试”模式下运行时，image: hellodockertools 生成映像 hellodockertools:dev。 应用在“发布”模式下运行时，生成 hellodockertools:latest 映像。
如果将映像推送到注册表，则需要添加 Docker Hub 用户名（如 dockerhubusername/hellodockertools）作为映像名称的前缀名。 或者，更改映像名称，使其包含专用注册表 URL（如 privateregistry.domain.com/hellodockertools），具体取决于所用配置。
如果根据生成配置需要不同行为（例如，调试或发布），请添加特定于配置的 docker-compose 文件。 这些文件应根据生成配置进行命名（例如，docker-compose.vs.debug.yml 和 docker compose.vs.release.yml）并放置在与 docker-compose-override.yml 文件相同的位置。
使用特定于配置的替代文件，可以为调试和发布生成配置指定不同的配置设置（如环境变量或入口点）。
docker 项目必须是启动项目，Docker Compose 才会显示要在 Visual Studio 中显示的选项。
Service Fabric
除了基础必备组件外，Service Fabric 业务流程解决方案还需要以下必备组件：
- Microsoft Azure Service Fabric SDK 版本 2.6 或更高版本
- Visual Studio 的 Azure 开发工作负载
Service Fabric 不支持在 Windows 上的本地开发群集中运行 Linux 容器。 如果项目已在使用 Linux 容器，Visual Studio 会提示切换到 Windows 容器。
Visual Studio 容器工具执行以下任务：
向解决方案添加 <project_name>Application Service Fabric 应用程序项目。
向 ASP.NET Core 项目添加 Dockerfile 和 .dockerignore 文件 。 如果 ASP.NET Core 项目中已存在 Dockerfile，则其重命名为 Dockerfile.original 。 创建类似于以下形式的新 Dockerfile：
# See https://aka.ms/containerimagehelp for information on how to use Windows Server 1709 containers with Service Fabric. # FROM microsoft/aspnetcore:2.0-nanoserver-1709 FROM microsoft/aspnetcore:2.0-nanoserver-sac2016 ARG source WORKDIR /app COPY ${source:-obj/Docker/publish} . ENTRYPOINT ["dotnet", "HelloDockerTools.dll"]将
<IsServiceFabricServiceProject>元素添加到 ASP.NET Core 项目的.csproj文件：<IsServiceFabricServiceProject>True</IsServiceFabricServiceProject>向 ASP.NET Core 项目添加 PackageRoot 文件夹。 该文件夹包含服务清单和新服务的设置。
有关详细信息，请参阅将 Windows 容器中的 .NET 应用部署到 Azure Service Fabric。
调试
在工具栏的调试下拉列表中选择“Docker”，然后开始调试应用。 “输出”窗口的“Docker”视图显示发生的以下操作 ：
- 已获取 microsoft/dotnet 运行时映像的 2.1-aspnetcore-runtime 标记（如果缓存中尚不存在） 。 该映像可安装 ASP.NET Core 和.NET Core 运行时及其关联的库。 在生产环境中针对运行 ASP.NET Core 应用对其进行了优化。
ASPNETCORE_ENVIRONMENT环境变量设置为容器内的Development。- 公开了两个动态分配的端口：分别用于 HTTP 和 HTTPS。 可以使用
docker ps命令查询分配给本地主机的端口。 - 应用已复制到容器。
- 默认浏览器使用动态分配端口启动，带有附加到容器的调试程序。
最终得到的应用的 Docker 映像标记为“开发”。 该映像基于 microsoft/dotnet 基础映像的 2.1-aspnetcore-runtime 标记 。 在“包管理器控制台”(PMC) 窗口中运行 docker images 命令。 显示了计算机上的映像：
REPOSITORY TAG IMAGE ID CREATED SIZE
hellodockertools dev d72ce0f1dfe7 30 seconds ago 255MB
microsoft/dotnet 2.1-aspnetcore-runtime fcc3887985bb 6 days ago 255MB
- 已获取 microsoft/aspnetcore 运行时映像（如果缓存中尚不存在）。
ASPNETCORE_ENVIRONMENT环境变量设置为容器内的Development。- 端口 80 公开，并映射到 localhost 的动态分配端口。 该端口由 Docker 主机确定，并且可以使用
docker ps进行查询。 - 应用已复制到容器。
- 默认浏览器使用动态分配端口启动，带有附加到容器的调试程序。
最终得到的应用的 Docker 映像标记为“开发”。 该映像基于 microsoft/aspnetcore 基础映像。 在“包管理器控制台”(PMC) 窗口中运行 docker images 命令。 显示了计算机上的映像：
REPOSITORY TAG IMAGE ID CREATED SIZE
hellodockertools dev 5fafe5d1ad5b 4 minutes ago 347MB
microsoft/aspnetcore 2.0 c69d39472da9 13 days ago 347MB
注意
因为“调试”配置使用卷装载提供迭代体验，因此，开发映像中缺少应用内容。 要推送映像，请使用“发布”配置。
在 PMC 中运行 docker ps 命令。 请注意，应用使用容器运行：
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
baf9a678c88d hellodockertools:dev "C:\\remote_debugge..." 21 seconds ago Up 19 seconds 0.0.0.0:37630->80/tcp dockercompose4642749010770307127_hellodockertools_1
编辑并继续
对静态文件和 Razor 视图的更改会自动更新，无需执行编译步骤。 进行更改，保存并在浏览器中刷新，以查看更新。
必须在容器内编译和重启 Kestrel，才能修改代码文件。 更改后，按 CTRL+F5 执行过程，并在容器内启动应用。 未重新生成或停止 Docker 容器。 在 PMC 中运行 docker ps 命令。 请注意，截至 10 分钟前，原始容器仍在运行：
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
baf9a678c88d hellodockertools:dev "C:\\remote_debugge..." 10 minutes ago Up 10 minutes 0.0.0.0:37630->80/tcp dockercompose4642749010770307127_hellodockertools_1
发布 Docker 映像
完成应用的开发和调试循环后，Visual Studio 容器工具可帮助创建应用的生产映像。 将配置下拉列表更改为“发布”，然后生成应用。 该工具从 Docker Hub 中获取 compile/publish 映像（如果缓存中尚不存在）。 生成了具有“latest”标签的映像，可以将其推送到专用注册表或 Docker Hub。
在 PMC 中运行 docker images 命令，查看映像列表。 显示了类似下面的输出：
REPOSITORY TAG IMAGE ID CREATED SIZE
hellodockertools latest e3984a64230c About a minute ago 258MB
hellodockertools dev d72ce0f1dfe7 4 minutes ago 255MB
microsoft/dotnet 2.1-sdk 9e243db15f91 6 days ago 1.7GB
microsoft/dotnet 2.1-aspnetcore-runtime fcc3887985bb 6 days ago 255MB
REPOSITORY TAG IMAGE ID CREATED SIZE
hellodockertools latest cd28f0d4abbd 12 seconds ago 349MB
hellodockertools dev 5fafe5d1ad5b 23 minutes ago 347MB
microsoft/aspnetcore-build 2.0 7fed40fbb647 13 days ago 2.02GB
microsoft/aspnetcore 2.0 c69d39472da9 13 days ago 347MB
自 .NET Core 2.1 起，前面的输出中列出的 microsoft/aspnetcore-build 和 microsoft/aspnetcore 映像替换为 microsoft/dotnet 映像。 有关详细信息，请参阅 Docker 存储库迁移公告。
注意
docker images 命令返回存储库名称和标记标识为 <none>（上面未列出）的中间映像。 这些未命名映像由多阶段生成 Dockerfile 生成。 它们可提高生成最终映像的效率 — 发生更改时，仅重新生成必要的层。 不再需要中间映像时，请使用 docker rmi 命令将其删除。
可能希望生产或发布映像的大小比开发映像小。 由于卷映射，调试程序和应用从本地计算机运行，而不在容器内运行。 最新映像已打包必要的应用代码，以在主机上运行应用。 因此，增量是应用代码的大小。
