如何为特定Git提交配置拉取完成后仅执行一次的迁移脚本？

针对你提到的场景——修改了无法提交的「meta-structures」，需要拉取特定提交的用户仅执行一次迁移脚本，以下是可行的实现方案，结合你想到的标记思路，同时适配GitLab环境：

核心思路 #

利用Git的post-merge钩子，结合本地标记文件，判断当前仓库是否包含目标提交，且仅在首次检测到该提交时执行迁移脚本，避免每次合并都触发。

具体实现步骤 #

1. 确定目标提交哈希 #

先获取需要触发迁移的那个提交的完整哈希值，在提交时执行：

git rev-parse HEAD

记录下输出的长哈希（例如abc123def4567890abcdef1234567890abcdef12）。

2. 编写post-merge钩子脚本 #

Git的钩子默认存放在.git/hooks/目录，但该目录不会被仓库追踪，所以我们先把钩子脚本放到仓库的可追踪目录（比如scripts/git-hooks/）：

脚本内容（scripts/git-hooks/post-merge）

#!/bin/bash

# 替换为你的目标提交完整哈希
TARGET_COMMIT="abc123def4567890abcdef1234567890abcdef12"
# 本地标记文件路径（放在项目目录下，不会被提交）
MARKER_FILE=".migrations/.did_${TARGET_COMMIT:0:7}_migration"

# 检查当前仓库是否已包含目标提交
if git rev-parse --verify --quiet "$TARGET_COMMIT" > /dev/null; then
    # 检查是否已执行过迁移
    if [ ! -f "$MARKER_FILE" ]; then
        echo "检测到首次拉取目标提交$TARGET_COMMIT，开始执行迁移..."
        # 替换为你的迁移脚本路径
        ./scripts/migration-script.sh
        
        # 创建标记文件目录（如果不存在）
        mkdir -p "$(dirname "$MARKER_FILE")"
        # 创建标记文件，标记迁移已完成
        touch "$MARKER_FILE"
        echo "迁移执行完成，已创建本地标记文件"
    fi
fi

3. 让所有用户同步钩子 #

因为.git/hooks/默认不被追踪，需要让用户将仓库的钩子目录设置为我们的脚本目录：

编写钩子安装脚本（install-hooks.sh）

#!/bin/bash
# 设置Git钩子目录为仓库内的scripts/git-hooks
git config core.hooksPath scripts/git-hooks
# 给钩子脚本添加执行权限
chmod +x scripts/git-hooks/post-merge
echo "Git钩子已成功安装，后续拉取合并时会自动触发迁移检查"

然后在项目的README或GitLab的项目说明中提示用户：克隆仓库后请先执行./install-hooks.sh来启用钩子。

4. 补充配置 #

• 将标记文件目录加入.gitignore，避免提交到仓库：

  .migrations/
  

• 确保迁移脚本（scripts/migration-script.sh）已提交到仓库，且具备执行权限（提交前执行chmod +x scripts/migration-script.sh）。

GitLab环境下的额外提示 #

• 在目标提交的备注、Merge Request描述中明确标注「此提交需执行迁移脚本」，给用户额外的人工提示，避免钩子未安装时出现构建问题。
• 可以在GitLab流水线中添加检查步骤：如果检测到用户仓库未执行迁移，则在构建时抛出警告或错误，强制用户完成迁移。

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