Dockerfile 是用于构建 Docker 镜像的文件，其中包含了创建 Docker 镜像的指令。本文将详细介绍 Dockerfile 中的常用指令及其用法，并通过一个 .NET 8 API 的示例展示如何使用这些指令来构建和部署应用程序。
一. Dockerfile 基础指令
1.1 FROM
FROM 指令用于指定基础镜像，即构建镜像时的起点。基础镜像通常包括操作系统、编程语言、库和其他工具。选择合适的基础镜像可以简化依赖项的安装。
FROM mcr.microsoft.com/dotnet/aspnet:8.0
-
mcr.microsoft.com/dotnet/aspnet:8.0是 .NET 8 的官方基础镜像。
1.2 CMD
CMD 指令定义容器启动时执行的默认命令。你可以通过 CMD 指令指定容器启动时运行的命令。
CMD ["dotnet", "myapp.dll"]
-
dotnet myapp.dll是容器启动时运行的命令。
1.3 EXPOSE
EXPOSE 指令用于声明容器将监听的端口。声明端口不会自动公开端口，但可以帮助其他开发者理解容器的网络接口。
EXPOSE 8080
-
8080是容器将监听的端口。
1.4 WORKDIR
WORKDIR 指令用于设置工作目录。所有后续的 COPY、RUN 和其他命令都将在此工作目录中执行。
WORKDIR /app
-
/app是容器中的工作目录。
1.5 ENV
ENV 指令用于设置环境变量，这些变量在容器运行时可以使用。
ENV ASPNETCORE_ENVIRONMENT=Production
-
ASPNETCORE_ENVIRONMENT环境变量设置为Production。
1.6 COPY
COPY 指令用于将文件从主机复制到容器内的指定位置。
COPY . /app
-
将当前目录下的所有文件复制到容器的 /app目录。
1.7 RUN
RUN 指令用于在镜像构建时执行命令。这些命令通常用于安装依赖项或设置环境。
RUN dotnet restore
RUN dotnet build -c Release
-
dotnet restore和dotnet build -c Release用于恢复依赖项和构建应用程序。
1.8 USER
USER 指令用于指定后续命令运行的用户。默认情况下，Docker 容器以 root 用户身份运行，但可以使用 USER 指令切换到其他用户。
USER app
-
切换到 app用户执行后续命令。
二. 示例：.NET 8 API 的 Dockerfile
以下是一个用于 .NET 8 API 的 Dockerfile 示例，展示了如何通过多个阶段来构建和部署应用程序。
2.1 Part 1: 基础镜像和工作目录设置
# 使用 .NET 8 的基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 8080
USER app
2.2 Part 2: 构建阶段
# 使用 .NET 8 的 SDK 镜像进行构建
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY . .
RUN dotnet restore
RUN dotnet build -c Release
2.3 Part 3: 发布阶段
# 从上一步构建阶段继续
FROM build AS publish
RUN dotnet publish -c Release -o /app/publish
2.4 Part 4: 最终镜像构建
# 使用基础镜像作为最终镜像
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "myapp.dll"]
三. 构建、推送和运行 Docker 容器
3.1 构建镜像
在 Dockerfile 所在的项目根目录中运行以下命令以构建 Docker 镜像：
docker build -t {ACCOUNT_NAME/REPOSITORY_NAME}:{TAG_NAME} .
# 示例
docker build -t myaccount/myapp:latest .
3.2 推送镜像到 Docker Hub
docker push {ACCOUNT_NAME/REPOSITORY_NAME}:{TAG_NAME}
# 示例
docker push myaccount/myapp:latest
3.3 运行容器
在不同的机器上部署容器：
docker run -d -p {LOCAL_PORT}:{EXPOSED_PORT} --name="{CONTAINER_NAME}" {ACCOUNT_NAME/REPOSITORY_NAME}:{TAG_NAME}
# 示例
docker run -d -p 8080:8080 --name="myapp_container" myaccount/myapp:latest
四. 总结
通过理解 Dockerfile 的各个指令及其用法，你可以构建出高效、可重用的 Docker 镜像。本文提供了 .NET 8 API 的具体示例，希望对你在开发和部署过程中有所帮助。