Docker 多阶段构建不会将参数传递给第二阶段

Question

我有 dockerbuild 文件，其中包含 2 个阶段

ARG DOTNET_VERSION=net48
ARG CONFIGURATION=Release
FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 AS build-env
ARG DOTNET_VERSION
ARG CONFIGURATION

RUN echo .Net version: $env:DOTNET_VERSION

FROM mcr.microsoft.com/windows/nanoserver:1809
ARG DOTNET_VERSION

RUN echo .Net version: $env:DOTNET_VERSION

我使用下一个命令启动它： docker build -t test . --build-arg DOTNET_VERSION=net471 --no-cache

输出为：

Step 1/9 : ARG DOTNET_VERSION=net48
Step 2/9 : ARG CONFIGURATION=Release
Step 3/9 : FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 AS build-env
 ---> c1e2ba0a9132
Step 4/9 : ARG DOTNET_VERSION
 ---> Running in 35ac4620bae3
Removing intermediate container 35ac4620bae3
 ---> 2000301c9b49
Step 5/9 : ARG CONFIGURATION
 ---> Running in 06b7c39a01b2
Removing intermediate container 06b7c39a01b2
 ---> 1591528894c8
Step 6/9 : RUN echo .Net version: $env:DOTNET_VERSION
 ---> Running in 6692bbe08eae
.Net
version:
net471
Removing intermediate container 6692bbe08eae
 ---> 7c4fa49a7732
Step 7/9 : FROM mcr.microsoft.com/windows/nanoserver:1809
 ---> 8572826a0d1a
Step 8/9 : ARG DOTNET_VERSION
 ---> Running in 3a1d9f759aaa
Removing intermediate container 3a1d9f759aaa
 ---> 74a6ccf7960f
Step 9/9 : RUN echo .Net version: $env:DOTNET_VERSION
 ---> Running in 13122b910b39
.Net version: $env:DOTNET_VERSION
Removing intermediate container 13122b910b39
 ---> 1c5b754b0b56
Successfully built 1c5b754b0b56

为什么第 6 步和第 9 步的结果不同？

Answer 1

这看起来可能是一个错误。

当您有一个与现有环境变量同名的构建参数时，Docker 将使用已经设置的环境变量而不是构建参数。

您使用的框架映像已经有一个名为 DOTNET_VERSION 的环境变量，因此您无法访问构建 arg 值。

解决方案是将构建参数命名为其他名称。我在这里添加了一个后缀_ARG

ARG DOTNET_VERSION_ARG=net48
ARG CONFIGURATION=Release
FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 AS build-env
ARG DOTNET_VERSION_ARG
ARG CONFIGURATION

RUN echo .Net version: $env:DOTNET_VERSION_ARG

FROM mcr.microsoft.com/windows/nanoserver:1809
ARG DOTNET_VERSION_ARG

RUN echo .Net version: $env:DOTNET_VERSION_ARG

我的实验是在 Linux 上使用这个 Docker 文件

FROM mcr.microsoft.com/dotnet/aspnet:6.0
ARG DOTNET_VERSION=no-arg
ARG DOTNET_VERSION_ARG=arg
RUN echo DOTNET_VERSION=$DOTNET_VERSION - DOTNET_VERSION_ARG=$DOTNET_VERSION_ARG
ENV DOTNET_VERSION=$DOTNET_VERSION_ARG
RUN echo DOTNET_VERSION=$DOTNET_VERSION

得到这个输出

DOTNET_VERSION=6.0.1 - DOTNET_VERSION_ARG=arg
DOTNET_VERSION=arg

因此，如果您有 ENV 语句，则可以将环境变量设置为构建参数中的值。

Answer 2

我找到问题了

如果使用 mcr.microsoft.com/windows/nanoserver:1809 图片，则应使用 %arg% 格式的参数。

如果使用 mcr.microsoft.com/dotnet/framework/sdk:4.8 图片，则参数应以 $env:arg 格式使用。

它很混乱，我还没有找到它的记录。

Docker 多阶段构建不会将参数传递给第二阶段

Docker multistage build doesn't pass arguments to second stage

environment-variables

docker

dockerfile

docker-for-windows