在 Docker 镜像构建中注入 GitCommit 信息需通过 --build-arg 传入 git rev-parse 结果，在 Dockerfile 中用 ARG 声明、ENV 或 RUN 写入文件（如 /app/COMMIT_ID）或 LABEL，再通过 docker run 或 inspect 验证。
在 Docker 镜像构建过程中注入 GitCommit 信息，是实现镜像版本可追溯的关键实践。核心思路是在构建时读取当前 Git 仓库的提交哈希（如 git rev-parse HEAD），并通过构建参数（--build-arg）传入 Dockerfile，并最终写入镜像的元数据或运行时可读文件中。
在 Dockerfile 中接收并固化 GitCommit
Dockerfile 需声明构建参数，并将其写入镜像层（如环境变量、标签或文件）：
- 使用
ARG声明参数（仅构建期可见），再用ENV或RUN echo ... > /app/commit持久化 - 推荐写入文件（如
/app/VERSION或/app/COMMIT_ID），避免环境变量被容器启动时覆盖 - 示例片段：
ARG GIT_COMMIT ENV GIT_COMMIT=$GIT_COMMIT RUN echo "$GIT_COMMIT" > /app/COMMIT_ID
通过构建脚本自动获取并传递 GitCommit
Shell 脚本负责安全获取当前 commit 并调用 docker build：
- 先校验是否在 Git 仓库内：
git rev-parse --git-dir >/dev/null 2>&1 || { echo "Not in git repo"; exit 1; } - 用
git rev-parse --short=8 HEAD获取短哈希（更简洁），或--verify HEAD确保工作区干净（可选） - 构建命令示例：
docker build --build-arg GIT_COMMIT=$(git rev-parse --short=8 HEAD) -t myapp:latest .
验证与运行时读取 Commit 信息
构建完成后，可通过多种方式确认信息已注入：
- 运行容器并检查文件：
docker run --rm myapp:latest cat /app/COMMIT_ID - 查看镜像历史或元数据：
docker inspect myapp:latest | jq '.[0].Config.Env'（若存为 ENV） - 在应用启动脚本中读取
/app/COMMIT_ID并打印日志，便于生产环境识别版本
进阶：结合多阶段构建与 LABEL 提升可观测性
利用 LABEL 将 Git 信息写入镜像元数据，兼容 docker images --format 和 CI/CD 工具解析：
- 在 Dockerfile 中添加：
LABEL org.opencontainers.image.revision="$GIT_COMMIT" - 构建时仍需传参：
--build-arg GIT_COMMIT=... - 查询方式：
docker inspect --format='{{.Config.Labels."org.opencontainers.image.revision"}}' myapp:latest
