创建一个自定义 ASP.NET Core Docker 镜像

创建一个自定义ASP.NET Core RazorPage Docker镜像

本节课，我们通过创建一个自定义 Dockerfile 文件,将示例YoYoMooc.Exampleapp应用程序制作为 Docker 镜像。

创建 Dockerfile 文件

Docker Hub 包含了很多的一系列的应用程序镜像，但是没有我们当前YoYoMooc.Exampleapp程序的镜像，所以我们会使用 Docker 的技术来创建一个自定义镜像。

Dockerfile 文件，它是 Docker 镜像的描述文件，其中会包含一系列的命令，而 Docker 则会遵循这些规则命令一一执行。

在YoYoMooc.Exampleapp根目录中，添加一个Dockerfile文件,添加内容如下：

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1
COPY dist /app
WORKDIR /app
EXPOSE 80/tcp
ENTRYPOINT ["dotnet", "YoYoMooc.ExampleApp.dll"]

这五行命令就是为示例应用程序创建 Docker 镜像所需的全部内容。每一条 的命令在后面的章节中详细介绍。

配置基础镜像

Docker 镜像最强大的特点之一就是可以基于现有镜像，这意味着命令中包含了基本镜像所包含的所有文件。FROM 命令是第一个命令，在 Docker 文件，它指定了要使用的基础镜像。

在本例中，基础镜像被称为mcr.microsoft.com/dotnet/core/aspnet，而我指定的版本是 3.1 的版本，这是一个 ASP.NET Core 镜像。

该镜像由微软制作，它包含了.NET Core 运行时和 ASP.NET Core,我们可以通过它运行我们的项目，它不包含.NET SDK，所以我们的 Razorpage 应用必须提前编译完成，等待制作为镜像。

当然微软还提供了其他镜像:

• SDK 地址：mcr.microsoft.com/dotnet/core/sdk:3.1
• runtime 地址: mcr.microsoft.com/dotnet/core/runtime:3.1

复制应用程序文件

当您将 ASP.NET Core 应用程序容器化时，所有已编译的类文件，NuGet 包，配置文件，并将 Razor 视图添加到镜像中。COPY 命令复制文件或文件夹放入容器。

COPY dist /app

此命令是将dist的文件夹中的文件复制到容器/app的文件夹中。目前 dist 文件夹不存在，我们会在后面准备它。

设置工作目录

WORKDIR命令便是设置容器的工作目录，这是在运行时非常有用命令，当你需要指定某个路径或者文件的时，不必指定完整路径。Dockerfile 文件中的命令会将 COPY 命令创建的/app文件夹的路径，包含到容器的应用程序中。

公开 HTTP 端口

容器中的进程无需任何特殊措施即可打开网络端口，但 Docker 不允许外部世界访问它们，除非 Dockerfile 包含一个指定端口的EXPOSE命令，如下所示：

EXPOSE 80/tcp

这个命令告诉 Docker，它可以使容器外的 TCP 请求可用端口 80。对我们的示例应用程序，也需要这样做，这样 ASP.NET Core Kestrel 服务器才能接收到 HTTP 请求。

提示:在容器中处理端口是一个两步走的过程。在后面 "使用容器的工作 "部分，了解更多关于 关于如何完成配置，使服务器能够接收请求的详细信息。

运行应用程序

Docker 文件的最后一步是 ENTRYPOINT 命令，它告诉 Docker 此为容器的起点。

ENTRYPOINT ["dotnet", "YoYoMooc.ExampleApp.dll"]

该命令告诉 Docker 运行 dotnet cli 命令行工具来执行YoYoMooc.ExampleApp文件，我将在下一节中创建。不必指定YoYoMooc.ExampleApp文件的路径,因为它假定位于 WORKDIR 命令指定的目录中，而目录将包含所有的应用程序文件。

预备的应用程序镜像

Dockerfile 文件中的一些行命令可能并不是立即就能理解的，特别是如果你习惯于使用Visual Studio或Visual Studio Code处理 ASP.NET Core MVC 项目。

在当前项目中的 Dockerfile 文件中的镜像不包括.NET Core SDK，如果你现在进行编译肯定会编译失败，并且由于我们指定了dist文件夹，所以也无法通过自动编译到指定文件夹。

输入以下命令：

dotnet restore ##还原包

dotnet publish --framework netcoreapp3.1 --configuration Release --output dist

dotnet restore命令是为了确保项目已经拥有所有需要的 Nuget 包。重要的命令是 dotnet publish，它可以编译应用程序，然后将其转换为转换成一个独立的文件集，其中包含了应用程序所需的所有内容。输出参数指定了编译后的项目应该被写到一个名为 dist 的文件夹中，这个文件夹对应 Dockerfile 中的 COPY 命令。

这里拆分成了两步，你可以直接使用dotnet publish 命令也是可以的，如果没有还原他会自动还原。

创建一个自定义镜像

要处理 Docker 文件并为示例应用程序生成镜像，请运行以下所示的命令

docker build . -t yoyomooc/exampleapp -f Dockerfile

docker build命令会创建一个新的镜像。build 关键字后面的句号提供了上下文，也就是 Docker 文件中的 COPY 等命令所使用的位置。

参数说明：

• -t参数 :用于标记新的镜像名称为yoyomooc/exampleapp。
• -f参数:指定了创建镜像的说明文件即 Dockerfile 的完整名称。
• 镜像取名规则的惯例是使用您的名字或您的组织名称，后面是应用的名称。

Docker 会下载它所需要的基本镜像，然后按照 Dockerfile 中的说明来进行生成新的镜像。当构建过程完成后，你可以通过运行docker images命令，查询生成的镜像列表。

小结

从 3.X 开始微软的镜像就不再由 hub.docker.com 托管，是由微软官方进行独立维护，所以我们指定了镜像域名地址mcr.microsoft.com。所以产生了一个问题，网速慢，可以采用我自制的镜像。

• aspnet 地址:registry.cn-hangzhou.aliyuncs.com/yoyosoft/dotnet/core/aspnet:3.1