无需--build-arg，如何在Dockerfile中将git rev-parse输出设为ENV变量？

下面从CI/CD和生产实践角度，提供几种可行的解决方案，并解释你之前尝试的脚本方法失效的原因：

方案一：多阶段构建直接提取Git哈希 #

这种方法通过多阶段构建隔离Git环境，避免最终运行镜像包含不必要的工具：

• 第一阶段使用带Git的基础镜像，将本地代码及.git目录复制进去，执行命令生成版本文件
• 将版本文件传递到第二阶段的运行镜像，程序可直接读取文件或通过环境变量加载

示例Dockerfile：

# 版本提取阶段
FROM alpine/git:latest AS version-builder
WORKDIR /tmp/repo
COPY . .
RUN git rev-parse --short HEAD > /tmp/version.txt

# 运行环境阶段
FROM python:3.11-slim
WORKDIR /app
# 复制版本文件
COPY --from=version-builder /tmp/version.txt .
# 可选：将版本写入环境变量配置文件，容器启动时自动加载
RUN echo "export VERSION_NUM=$(cat version.txt)" > /etc/profile.d/app_version.sh
COPY main.py .
CMD ["python", "main.py"]

对应的Python代码可选择直接读取文件：

def get_app_version():
    try:
        with open('/app/version.txt', 'r') as f:
            return f.read().strip()
    except FileNotFoundError:
        return 'local_version'

VERSION_NUM = get_app_version()

方案二：CI/CD流水线预生成版本文件（推荐） #

这是工业界常用的实践，把版本提取逻辑放在CI/CD流程中，Docker构建仅负责复制文件，完全脱离Git依赖：

• 在CI/CD步骤（如GitHub Actions、GitLab CI）中，提前执行git rev-parse --short HEAD > version.txt生成版本文件
• Dockerfile只需复制该文件到镜像中，程序读取文件即可

示例GitHub Actions配置片段：

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Generate version file
        run: git rev-parse --short HEAD > version.txt
      - name: Build Docker image
        run: docker build -t my-app:${{ env.GITHUB_SHA }} .

Dockerfile简化为：

FROM python:3.11-slim
WORKDIR /app
COPY version.txt .
COPY main.py .
CMD ["python", "main.py"]

方案三：CI自动注入构建参数 #

如果仍偏好通过环境变量传递版本，可在CI/CD流水线中自动生成参数值，无需手动输入--build-arg：

示例GitLab CI配置：

build_image:
  stage: build
  script:
    - export VERSION_NUM=$(git rev-parse --short HEAD)
    - docker build --build-arg VERSION_NUM=$VERSION_NUM -t my-app:$VERSION_NUM .

Dockerfile保持你原来的ARG+ENV配置即可：

FROM python:3.11-slim
ARG VERSION_NUM
ENV VERSION_NUM=$VERSION_NUM
WORKDIR /app
COPY main.py .
CMD ["python", "main.py"]

你之前脚本方法失效的原因 #

1. set_version.sh导出变量无效：Docker中每个RUN命令都是独立的shell进程，导出的环境变量仅在当前进程生效，不会传递到后续构建步骤或容器运行时环境。必须将变量写入容器的环境配置文件（如/etc/profile.d/下的脚本），才能在容器启动时加载。
2. get_version.sh无法赋值给ENV：Docker的ENV指令只能接收静态字符串或ARG传递的值，无法直接执行脚本获取结果。若要通过脚本生成环境变量，需用RUN命令将脚本输出写入配置文件，而非直接赋值给ENV。

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