如何在Bash脚本中使用SSH从Bitbucket下载Git预提交钩子文件？

原来你是用curl+HTTP认证的方式拉取钩子文件，现在要换成SSH的话，Bitbucket支持通过Git的SSH协议来访问仓库里的文件，不需要再用用户名密码，而是依赖SSH密钥认证。下面给你两种实用的方案，还有注意事项：

前提准备 #

首先得确保你已经完成了Bitbucket的SSH配置：

• 生成SSH密钥对（如果还没有的话）：ssh-keygen -t ed25519
• 将公钥添加到你的Bitbucket账户的SSH密钥列表中
• 本地ssh-agent已经加载了私钥（避免每次操作都输入密钥密码）

方案1：用git archive直接提取单个文件（推荐） #

这个方法不需要克隆整个仓库，只拉取你需要的钩子文件，效率很高。把原来的curl命令替换成下面的逻辑：

假设你的钩子文件存放在Bitbucket仓库your-team/build-support-repo的hooks/目录下，对应的SSH仓库地址是ssh://git@bitbucket.org/your-team/build-support-repo.git：

# 定义仓库SSH地址和文件路径（替换成你的实际信息）
BUILD_SUPPORT_REPO_SSH="ssh://git@bitbucket.org/your-team/build-support-repo.git"
PRE_COMMIT_FILE_PATH="hooks/pre-commit.pl"
TARGET_PATH="~/.git_template/hooks/pre-commit"

echo "Downloading pre-commit.pl hook"
# 从远程仓库提取文件并写入目标路径
if git archive --remote="$BUILD_SUPPORT_REPO_SSH" HEAD:"$(dirname "$PRE_COMMIT_FILE_PATH")" "$(basename "$PRE_COMMIT_FILE_PATH")" | tar -x -O > "$TARGET_PATH"; then
    echo "pre-commit.pl downloaded successfully"
else
    echo "Error: Failed to download pre-commit.pl" >&2
    exit 1
fi

# 同理处理prepare-commit-msg.py
PREPARE_COMMIT_MSG_PATH="hooks/prepare-commit-msg.py"
TARGET_MSG_PATH="~/.git_template/hooks/prepare-commit-msg"

echo "Downloading prepare-commit-msg.py..."
if git archive --remote="$BUILD_SUPPORT_REPO_SSH" HEAD:"$(dirname "$PREPARE_COMMIT_MSG_PATH")" "$(basename "$PREPARE_COMMIT_MSG_PATH")" | tar -x -O > "$TARGET_MSG_PATH"; then
    echo "prepare-commit-msg.py downloaded successfully"
else
    echo "Error: Failed to download prepare-commit-msg.py" >&2
    exit 1
fi

命令解释： #

• git archive --remote=...：指定远程SSH仓库，HEAD:hooks表示要提取仓库根目录下hooks文件夹的内容
• tar -x -O：将归档文件解压并输出到标准输出（不写入本地文件），然后通过重定向写入目标路径
• 加入了错误判断，和原来curl --fail的效果一致，下载失败会退出脚本

方案2：克隆仓库的特定分支后复制文件 #

如果你的钩子文件和其他资源放在一起，需要批量下载的话，可以克隆仓库到临时目录，复制文件后删除临时目录：

# 临时目录路径
TEMP_DIR=$(mktemp -d)
BUILD_SUPPORT_REPO_SSH="ssh://git@bitbucket.org/your-team/build-support-repo.git"

echo "Cloning build support repo to temporary directory..."
if git clone --depth 1 "$BUILD_SUPPORT_REPO_SSH" "$TEMP_DIR"; then
    # 复制钩子文件到目标路径
    cp "$TEMP_DIR/hooks/pre-commit.pl" ~/.git_template/hooks/pre-commit
    cp "$TEMP_DIR/hooks/prepare-commit-msg.py" ~/.git_template/hooks/prepare-commit-msg
    echo "Hook files copied successfully"
    # 删除临时目录
    rm -rf "$TEMP_DIR"
else
    echo "Error: Failed to clone repository" >&2
    rm -rf "$TEMP_DIR"
    exit 1
fi

注意： #

• --depth 1表示只克隆最新的提交，减少下载量
• 适合需要下载多个文件的场景

关键注意事项 #

• SSH地址格式：如果是Bitbucket Server（企业版），SSH地址格式是ssh://username@your-bitbucket-server:7999/project-key/repo-slug.git，注意端口号是7999
• 权限设置：下载完成后记得给钩子文件加执行权限，比如chmod +x ~/.git_template/hooks/pre-commit
• 错误处理：可以根据实际需求调整错误提示和退出逻辑，确保脚本健壮性

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