如何在网站上显示GitLab的CI_COMMIT_SHA变量值？

核心原因 #

GitLab CI的预定义变量CI_COMMIT_SHA不会自动传递到Docker构建环境中。Docker build过程运行在隔离的上下文里，默认无法直接访问GitLab Runner环境中的CI变量，所以你在Dockerfile的RUN命令里直接引用${CI_COMMIT_SHA}时，这个变量值是空的。而自定义ARG能生效，是因为你在构建时主动通过--build-arg把变量传递给了Docker，CI_COMMIT_SHA没做这个步骤，自然无法被识别。

解决办法 #

方法1：通过--build-arg传递CI变量到Docker构建 #

1. 在你的.gitlab-ci.yml构建镜像的步骤中，添加--build-arg参数传递CI_COMMIT_SHA：

   docker build --build-arg CI_COMMIT_SHA=$CI_COMMIT_SHA -t your-image-name .
   

2. 在Dockerfile中先声明这个ARG，再执行替换操作：

   # 先声明要接收的ARG变量
   ARG CI_COMMIT_SHA
   # 执行替换
   RUN sed -i "s/current_hash_code2/${CI_COMMIT_SHA}/g" ./src/components/WelcomeMessage.vue
   

方法2：在CI阶段先完成文件替换，再构建镜像 #

直接在GitLab CI的脚本步骤中先替换文件内容，再执行Docker build，这样不需要在Dockerfile里处理变量传递：

sed -i "s/current_hash_code2/${CI_COMMIT_SHA}/g" ./src/components/WelcomeMessage.vue
docker build -t your-image-name .

额外注意点 #

如果你的基础镜像是Alpine Linux，它使用的是BusyBox版本的sed，sed -i命令需要额外加一个空参数，否则会报错：

RUN sed -i "" "s/current_hash_code2/${CI_COMMIT_SHA}/g" ./src/components/WelcomeMessage.vue

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