编写拒绝无效子模块提交的 git update 挂钩的最佳方法是什么？

Question

我正在尝试为 git 编写一个 update 钩子，如果子模块被更新为子模块的上游存储库中不存在的提交 ID，则该钩子会反弹。换句话说，我想强制用户在将更改推送到子模块指针之前将更改推送到子模块存储库。

需要注意的是：

• 我只想测试其裸露的上游存储库与父存储库位于同一服务器上的子模块。否则我们就必须开始做一些疯狂的事情，比如从 git hook 中调用“git clone”或“git fetch”，这不会很有趣。

我一直在考虑一个想法，但感觉必须有更好的方法来做到这一点。以下是我计划在更新挂钩中执行的操作：

1. 检查传递到挂钩的引用名称，看看我们是否正在更新 refs/heads/ 下的某些内容。如果没有，请尽早退出。
2. 使用 git rev-list 获取正在推送的修订版本列表。
3. 对于每个修订版：
   1. 调用 git show 并使用正则表达式来查看子模块是否已更新（通过搜索“+Subproject commit [0-9a-f]+”）。< /里>
   2. 如果此提交确实更改了子模块，请获取该特定提交所看到的 .gitmodules 文件的内容 (git show:.gitmodules) .
   3. 使用 3.1 和 3.2 的结果获取子模块 URL 及其更新的提交 ID 的列表。
   4. 根据将子模块 URL 映射到文件系统上的本地裸 git 存储库的外部文件检查 3.3 中创建的列表。
   5. cd 到 3.4 中找到的路径并执行 git rev-parse --quiet --verify 以查看该存储库中是否存在该提交。如果没有，则以非零状态退出。

（注意：我相信只要 git rev-parse --quiet --verify:.gitmodules 的输出不会从 是的，这看起来相当复杂

，我不禁想知道是否有一些内部 git 命令可以让我的生活变得更轻松。或者也许有不同的方式来思考这个问题？

Answer 1

编辑，很久以后：从 Git 1.7.7 开始，git-push 现在有一个 --recurse-submodules=check 选项，该选项拒绝推送父项目（如果有）子模块提交尚未推送到其远程。似乎尚未添加相应的 push.recurseSubmodules 配置参数。这当然并不能完全解决问题 - 无知的用户仍然可以在没有检查的情况下推送 - 但它非常相关！

我认为最好的方法是查看所有推送的提交之间的差异，而不是检查每个单独的提交： git diff; <新>。不过，你确实不想查看整个差异；它可能是巨大的。不幸的是， git-submodule Ceramic 命令在裸存储库中不起作用，但您仍然应该能够快速检查 .gitmodules 以获取路径列表（也可能是 URL）。对于每一个，您都可以 git diff<新> --path，如果存在差异，则获取新的子模块提交。 （如果你担心 000000 旧提交的可能性，我相信你可以在新提交上使用 git show 。）

一旦你处理好了所有这些，你就减少了检查给定远程存储库中是否存在给定提交的问题。不幸的是，正如您所注意到的那样，这并不简单，至少 据我所知。保留本地的、最新的克隆可能是你最好的选择，而且听起来你在这方面做得很好。

顺便说一句，我认为缓存在这里无关紧要，因为更新挂钩每个引用一次。是的，您可以在预接收挂钩中执行此操作，该挂钩获取标准输入上的所有引用，但我不明白为什么您应该费心做更多工作。这不会是一项昂贵的操作，并且通过更新挂钩，您可以单独接受或拒绝正在推送的各个分支，而不是因为只有一个分支不好而阻止所有分支更新。

如果你想省点麻烦，我可能会避免解析 gitmodules 文件，并将列表硬编码到钩子中。我怀疑你的子模块列表经常变化，所以维护它可能比编写自动化的东西更便宜。

Answer 2

这是我对 git update hook 的一点尝试。在这里记录下来，以便对其他人有用。已知的警告是不处理“0000...”特殊情况。

#!/bin/bash

REF=$1
OLD=$2
NEW=$3

# This update hook is based on the following information:
# http://stackoverflow.com/questions/3418674/bash-shell-script-function-to-verify-git-tag-or-commit-exists-and-has-been-pushe

# Get a list of submodules
git config --file <(git show $NEW:.gitmodules) --get-regexp 'submodule..*.path' | while read key path
do
    url=$(git config --file <(git show $NEW:.gitmodules) --get "${key/.path/.url}")
    git diff "$OLD..$NEW" -- "$path" | grep -e '^+Subproject commit ' |
    cut -f3 -d ' ' | while read new_rev
    do
        LINES=$(GIT_DIR="$url" git branch --quiet --contains "$new_rev" 2>/dev/null | wc -l)
        if [ $LINES == 0 ]
        then
            echo "Commit $new_rev not found in submodule $path ($url)" >&2
            echo "Please push that submodule first" >&2
            exit 1
        fi
    done || exit 1
done || exit 1

exit 0