咨询Jenkins构建后清理Bitbucket Server指定目录/分支的可行方案

嘿，针对你在Jenkins构建后清理Bitbucket Server 4.14仓库的需求，我整理了可行的方案，顺便解答下Jenkins连接Bitbucket的可用选项～

当然有多种方式可以让Jenkins和Bitbucket Server 4.14打通，主要有这几个常用选择：

• Bitbucket Server官方插件：这是最省心的方式，专门适配Bitbucket Server，支持4.14版本。你可以在Jenkins插件市场安装它，然后配置Bitbucket Server的地址和凭证（用户名密码/SSH密钥），不仅能实现代码拉取、触发构建，还能在构建后操作里直接调用插件提供的功能或者配合API使用。
• SSH凭证+原生Git命令：如果不想依赖插件，你可以在Jenkins服务器上配置SSH密钥对，将公钥添加到Bitbucket用户的SSH密钥列表里，这样Jenkins就能免密访问仓库，直接用Git命令完成分支删除、代码推送等操作。
• 直接调用Bitbucket REST API：Bitbucket Server 4.14提供了完整的REST API，你可以在Jenkins的构建后步骤里用curl、Python脚本或者其他工具调用API，完成各种仓库操作。

根据你要清理的对象（分支/仓库目录），分两种场景来操作：

场景1：清理指定分支 #

如果是要删除整个无用分支，有两种实现方式：

方式一：用Git命令 #

在Jenkins的构建后操作里添加「Execute shell」（Linux/macOS）或「Execute Windows batch command」（Windows）步骤，执行以下命令（记得替换占位内容）：

# 拉取最新的分支信息
git fetch --all
# 删除远程分支（替换成你的分支名）
git push origin --delete feature/old-unused-branch

方式二：用Bitbucket REST API #

如果不想操作Git仓库，也可以直接调用API删除分支：

# 替换成你的Bitbucket地址、项目键、仓库名、分支名和凭证
curl -u your-username:your-password -X DELETE "http://your-bitbucket-server/rest/api/1.0/projects/PROJECT_KEY/repos/REPO_NAME/refs/heads/feature/old-unused-branch"

场景2：清理仓库内指定目录（保留分支） #

如果是要删除某个分支下的指定目录内容（而非整个分支），可以用Git命令完成：

1. 在构建后步骤里克隆仓库（如果构建过程中已经克隆过，可跳过此步）：

git clone git@your-bitbucket-server:PROJECT_KEY/REPO_NAME.git
cd REPO_NAME

2. 切换到目标分支：

git checkout main # 替换成需要清理的分支名

3. 删除指定目录并推送变更：

# 删除目录下所有内容（如果要删除目录本身，把/*去掉即可）
rm -rf target-directory/*
# 提交变更
git add .
git commit -m "Clean up target directory via Jenkins post-build operation"
# 推送到远程仓库
git push origin main

• 权限检查：Jenkins使用的凭证必须拥有Bitbucket仓库的写入权限（删除分支、推送代码的权限），否则操作会失败。
• 兼容性：如果用Bitbucket Server插件，要选择适配4.14版本的插件版本，避免出现兼容性问题。
• 容错处理：建议在脚本里加入判断逻辑，比如先检查分支/目录是否存在再执行操作，避免因对象不存在导致构建失败。示例：

# 检查分支是否存在
if git ls-remote --heads origin feature/old-unused-branch | grep -q feature/old-unused-branch; then
  git push origin --delete feature/old-unused-branch
  echo "Branch deleted successfully"
else
  echo "Branch does not exist, skipping deletion"
fi

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