Dockerfile本地与GitLab构建路径适配问题求助

现有如下Dockerfile：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev
WORKDIR /app
EXPOSE 80

RUN apt-get update
RUN apt-get install openssl -y

#local env
COPY ["MyProject/MyProject/src/MainController/SslCertificates/", "/var/www/certs/"]

#gitlab env
COPY ["src/MainController/SslCertificates/", "/var/www/certs/"]

本地通过Visual Studio构建时，#local env的COPY路径有效，但GitLab流水线构建时找不到该路径；#gitlab env的COPY路径在GitLab中正常工作，但本地构建时失效。

尝试用COPY ... || true && COPY ...的方式忽略错误，结果报错：

1>failed to compute cache key: "/src/MainController/SslCertificates" not found: not found

原因是COPY是Docker构建指令，不是Shell命令，无法使用Shell的逻辑运算符，Docker会在构建初期就校验所有COPY路径的存在性，不会执行后续的|| true逻辑。

本地构建命令：

docker build -f "C:\Users\user\source\repos\MyProject\MyProject\Dockerfile" --force-rm -t potato:dev --target base  --label "com.microsoft.created-by=visual-studio" --label "com.microsoft.visual-studio.project-name=MyProject" "C:\Users\user\source\repos"

GitLab构建命令：

docker buildx build --tag "${IMAGE_SHA}" --tag "${IMAGE_REF}" ${PUSH} .

方案1：使用构建参数（ARG）动态指定证书路径 #

在Dockerfile中定义可动态传入的构建参数，根据不同环境传入对应路径：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev
WORKDIR /app
EXPOSE 80

RUN apt-get update
RUN apt-get install openssl -y

# 定义构建参数，默认使用GitLab环境的路径
ARG CERT_SOURCE_PATH=src/MainController/SslCertificates/
COPY ["${CERT_SOURCE_PATH}", "/var/www/certs/"]

• 本地构建时，通过--build-arg传入本地路径：

  docker build -f "C:\Users\user\source\repos\MyProject\MyProject\Dockerfile" --force-rm -t potato:dev --target base  --label "com.microsoft.created-by=visual-studio" --label "com.microsoft.visual-studio.project-name=MyProject" --build-arg CERT_SOURCE_PATH=MyProject/MyProject/src/MainController/SslCertificates/ "C:\Users\user\source\repos"
  

• GitLab构建时无需修改，直接使用默认路径即可。

方案2：统一构建上下文路径 #

本地构建时将构建上下文改为和GitLab一致（项目根目录），这样Dockerfile中只需保留GitLab的COPY路径：

1. 修改Dockerfile，只保留GitLab环境的COPY指令：

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
   RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev
   WORKDIR /app
   EXPOSE 80
   
   RUN apt-get update
   RUN apt-get install openssl -y
   
   COPY ["src/MainController/SslCertificates/", "/var/www/certs/"]
   

2. 本地构建命令修改为以项目根目录作为上下文：

   docker build -f "C:\Users\user\source\repos\MyProject\MyProject\Dockerfile" --force-rm -t potato:dev --target base  --label "com.microsoft.created-by=visual-studio" --label "com.microsoft.visual-studio.project-name=MyProject" "C:\Users\user\source\repos\MyProject\MyProject"
   

GitLab构建命令保持不变，即可适配两种环境。

方案3：使用Docker 23.0+的--if-exists参数（推荐高版本Docker） #

如果你的Docker版本在23.0及以上，可以使用COPY指令的--if-exists参数，忽略不存在的路径：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev
WORKDIR /app
EXPOSE 80

RUN apt-get update
RUN apt-get install openssl -y

COPY --if-exists ["MyProject/MyProject/src/MainController/SslCertificates/", "/var/www/certs/"]
COPY --if-exists ["src/MainController/SslCertificates/", "/var/www/certs/"]

该参数会自动跳过不存在的源路径，无需修改构建命令，即可同时适配本地和GitLab环境。

内容的提问来源于stack exchange，提问作者Nick Farsi