1. 概述
在本文中，我们将探讨如何从正在运行的 Docker 容器中获取 Git 提交哈希（commit hash）。这在调试或验证容器中运行的确切代码版本时非常有用。
2. 提交哈希的意义
Git 提交哈希是代码库某个特定状态的唯一标识符。拥有这个信息，有助于我们追踪变更、排查问题，以及确保不同环境之间的一致性。典型的提交哈希如下所示：
ce85e2ebe299cf9a8237556c86dbcaaa2d571a3e
3. 使用提交哈希为 Docker 镜像打标签
在构建 Docker 镜像时，使用提交哈希作为标签是一种常见的最佳实践。这可以清晰地将镜像与它所构建的源代码状态关联起来。
3.1 构建并打标签
我们可以使用如下命令，在构建镜像时传入当前提交哈希，并将其作为标签：
$ docker build --build-arg GIT_COMMIT=$(git rev-parse HEAD) -t my_image:$(git rev-parse HEAD)
其中：
--build-arg GIT_COMMIT=$(git rev-parse HEAD)：将当前提交哈希作为构建参数传入 Docker；-t my_image:$(git rev-parse HEAD)：将镜像标签设置为提交哈希。
3.2 Dockerfile 配置
你也可以在 Dockerfile 中接收该构建参数，并将其设置为环境变量：
FROM alpine
ARG GIT_COMMIT
ENV GIT_COMMIT=$GIT_COMMIT
这样构建出的镜像在运行时就可以通过环境变量获取提交哈希。
4. 从运行中的容器获取提交哈希
容器运行后，有多种方式可以获取其中的提交哈希。以下是最常见的几种方法。
4.1 使用 docker inspect
docker inspect 命令可以查看容器的详细信息，包括环境变量。无需进入容器即可获取哈希值：
$ docker inspect --format='{{.Config.Env}}' my_container
输出示例：
[PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin GIT_COMMIT=ce85e2ebe299cf9a8237556c86dbcaaa2d571a3e]
4.2 直接访问环境变量
如果提交哈希被设置为环境变量，可以直接在容器内通过命令获取：
$ docker exec my_container printenv GIT_COMMIT
输出示例：
ce85e2ebe299cf9a8237556c86dbcaaa2d571a3e
✅ 这种方法适合用于脚本中动态获取版本信息。
5. 自动化流程集成
为了简化操作，建议将提交哈希的记录与获取流程集成到 CI/CD 流水线中。
例如在 GitHub Actions 中，可以这样配置：
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Build Docker image
run: docker build --build-arg GIT_COMMIT=${{ github.sha }} -t my_image:${{ github.sha }} .
⚠️ 注意：github.sha 表示当前提交的哈希值，确保每次构建都能准确记录源码状态。
6. 错误处理
尝试访问不存在或未运行的容器时，可能会出现错误。比如：
Error: No such object: <container_id>
建议在脚本中加入错误处理逻辑：
if ! docker inspect my_container > /dev/null 2>&1; then
echo "容器不存在或未运行"
exit 1
fi
这样可以避免脚本因容器状态异常而崩溃。
7. 总结
本文介绍了几种从运行中的 Docker 容器中获取提交哈希的方法：
- ✅ 在构建镜像时使用提交哈希作为标签；
- ✅ 将提交哈希设置为环境变量，便于容器运行时获取；
- ✅ 通过
docker inspect或printenv命令直接获取； - ✅ 在 CI/CD 中自动化构建和记录流程；
- ✅ 添加错误处理，增强脚本健壮性。
将这些实践应用到实际项目中，有助于提升调试效率和部署透明度。