如何将GitLab CI文件类型变量正确传递至Docker容器？

你遇到的核心问题是：GitLab的文件类型变量并不是直接存储文件内容，而是在CI运行环境中生成一个临时文件，变量的值其实是这个临时文件的路径——这就是为什么你看到写入的是/builds/xxx/xxx/project_name.tmp/PIPCONFIG而不是配置内容。下面给你两种可靠的解决方法：

方法一：复制临时文件到构建上下文（推荐，适合复杂配置） #

这种方法最直接，避免处理内容转义的问题：

1. 在.gitlab-ci.yml中复制临时文件到构建目录
   因为Docker构建只能访问构建上下文（这里是src/目录）内的文件，所以先把GitLab生成的临时配置文件复制到src/里：

   script:
     - cp $PIP_CONFIG src/pip.conf  # 把临时文件复制到构建上下文
     - docker build -t $IMAGE src/.
   

2. 在Dockerfile中复制配置文件到目标路径
   直接从构建上下文复制文件到容器内的pip配置目录：

   FROM python:3
   RUN mkdir -p ~/.pip  # 确保目录存在
   COPY pip.conf ~/.pip/pip.conf
   RUN pip install -r requirements.txt
   

方法二：通过构建参数传递文件内容（适合简单配置） #

如果不想在构建上下文生成临时文件，可以把文件内容读取出来作为构建参数传递，注意要保留换行符：

1. 在.gitlab-ci.yml中传递文件内容
   用cat读取临时文件的内容，并用引号包裹确保换行符被保留：

   script:
     - docker build -t $IMAGE --build-arg PIP_CONFIG_CONTENT="$(cat $PIP_CONFIG)" src/.
   

2. 在Dockerfile中写入配置内容
   接收构建参数，并用带双引号的echo写入文件（保留换行）：

   FROM python:3
   ARG PIP_CONFIG_CONTENT
   RUN mkdir -p ~/.pip
   RUN echo "$PIP_CONFIG_CONTENT" > ~/.pip/pip.conf
   RUN pip install -r requirements.txt
   

为什么之前的方法失败？ #

• 直接用--build-arg PIP_CONFIG=$PIP_CONFIG传递的是临时文件的路径字符串，Docker构建容器内没有这个路径，所以echo $PIP_CONFIG写入的是路径文本，不是配置内容。
• 使用COPY $PIP_CONFIG ~/.pip/pip.conf时，Docker只能访问src/构建上下文内的文件，而GitLab的临时文件不在这个目录下，所以提示路径不存在。

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