创建一个自定义ASP.NET Core RazorPage Docker镜像
本节课,我们通过创建一个自定义 Dockerfile 文件,将示例YoYoMooc.Exampleapp
应用程序制作为 Docker 镜像。
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 应用必须提前编译完成,等待制作为镜像。
当然微软还提供了其他镜像:
当您将 ASP.NET Core 应用程序容器化时,所有已编译的类文件,NuGet 包,配置文件,并将 Razor 视图添加到镜像中。COPY 命令复制文件或文件夹放入容器。
COPY dist /app
此命令是将dist
的文件夹中的文件复制到容器/app
的文件夹中。目前 dist 文件夹不存在,我们会在后面准备它。
WORKDIR
命令便是设置容器的工作目录,这是在运行时非常有用命令,当你需要指定某个路径或者文件的时,不必指定完整路径。Dockerfile 文件中的命令会将 COPY 命令创建的/app
文件夹的路径,包含到容器的应用程序中。
容器中的进程无需任何特殊措施即可打开网络端口,但 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 publis
h 命令也是可以的,如果没有还原他会自动还原。
要处理 Docker 文件并为示例应用程序生成镜像,请运行以下所示的命令
docker build . -t yoyomooc/exampleapp -f Dockerfile
docker build
命令会创建一个新的镜像。build 关键字后面的句号提供了上下文,也就是 Docker 文件中的 COPY 等命令所使用的位置。
参数说明:
-t
参数 :用于标记新的镜像名称为yoyomooc/exampleapp
。-f
参数:指定了创建镜像的说明文件即 Dockerfile 的完整名称。Docker 会下载它所需要的基本镜像,然后按照 Dockerfile 中的说明来进行生成新的镜像。当构建过程完成后,你可以通过运行docker images
命令,查询生成的镜像列表。
REPOSITORY | TAG | IMAGE | ID | CREATED | SIZE |
---|---|---|---|---|---|
hello-world | latest | bf756fb1ae65 | 4 months ago | 13.3kB | |
yoyomooc/exampleapp | latest | d79e42555679 | About an hour ago | 212MB | |
mcr.microsoft.com/dotnet/core/aspnet | 3.1 | 79e79777c3bf | 2 weeks ago | 207MB |
从 3.X 开始微软的镜像就不再由 hub.docker.com 托管,是由微软官方进行独立维护,所以我们指定了镜像域名地址
mcr.microsoft.com
。所以产生了一个问题,网速慢,可以采用我自制的镜像。
registry.cn-hangzhou.aliyuncs.com/yoyosoft/dotnet/core/aspnet:3.1