团队级分支溯源方案需求：通过Hook追踪分支来源关系

可以通过Git服务器端钩子实现团队级的分支溯源记录需求，具体步骤如下：

实现思路 #

利用Git的post-receive服务器端钩子，捕获所有推送到远程仓库的新分支创建事件，提取分支的父分支/父提交信息，写入指定的.txt文件中留存。

具体操作步骤 #

1. 创建记录文件
   在远程仓库的根目录下创建branch-origin-trace.txt，确保Git服务器进程拥有该文件的读写权限：

touch /path/to/your/repository/branch-origin-trace.txt
chown git:git /path/to/your/repository/branch-origin-trace.txt  # 根据服务器实际运行用户调整

2. 编写post-receive钩子脚本
   进入远程仓库的hooks目录，创建post-receive文件并写入以下内容：

#!/bin/bash

# 定义溯源记录文件的绝对路径
TRACE_FILE="/path/to/your/repository/branch-origin-trace.txt"

# 遍历推送的引用更新事件
while read old_sha new_sha ref; do
    # 判断是否为新创建的分支（旧提交SHA全为0）
    if [[ $old_sha == 0000000000000000000000000000000000000000 ]]; then
        branch_name=$(basename "$ref")
        # 获取当前分支的父提交SHA
        parent_sha=$(git rev-parse "$new_sha^" 2>/dev/null)
        
        # 尝试查找包含父提交的分支（排除当前分支）
        parent_branch=$(git branch --contains "$parent_sha" | grep -v "$branch_name" | head -n1 | sed 's/^\* //')
        
        # 整理父分支/父提交信息
        if [[ -n $parent_branch ]]; then
            parent_info="溯源至分支: $parent_branch"
        elif [[ -n $parent_sha ]]; then
            parent_info="溯源至提交: $parent_sha"
        else
            parent_info="无明确溯源目标（初始分支）"
        fi
        
        # 写入记录，包含时间戳、分支名和溯源信息
        echo "$(date '+%Y-%m-%d %H:%M:%S') | 创建分支: $branch_name | $parent_info" >> "$TRACE_FILE"
    fi
done

3. 设置脚本可执行权限
   给钩子脚本添加执行权限，确保Git服务器能正常触发它：

chmod +x /path/to/your/repository/hooks/post-receive

注意事项 #

• 该脚本仅捕获推送到远程服务器的新分支，若在服务器本地直接创建分支，需额外配置post-create钩子（部分Git服务器支持）。
• 针对GitLab/GitHub等托管平台，需在平台后台配置自定义服务器钩子，确保脚本能正常触发。
• 可定期对branch-origin-trace.txt进行日志轮转，避免文件体积过大。
• 分支溯源逻辑基于父提交匹配，若分支由多分支合并后创建，可能需要调整脚本逻辑以适配复杂场景。

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