基于标签在Bitbucket Pipeline中实现NX Monorepo受影响项目部署

问题根源 #

Bitbucket Pipelines触发标签构建时，会把仓库重置到标签对应的提交，处于分离头指针状态，而且默认克隆行为不会拉取完整的远程分支历史，导致origin/master~1这类远程分支引用无法被Git识别。

解决方案步骤 #

1. 提前拉取远程master分支历史 #

在执行NX affected命令前，先显式拉取origin的master分支到本地远程引用，确保Git能解析相关路径：

git fetch origin master:refs/remotes/origin/master

执行这条命令后，即使当前处于分离头状态，Git也能找到origin/master及其衍生的origin/master~1引用。

2. 基于标签提交的父节点做基准（更稳妥） #

如果你的标签是直接基于master分支打的，可以跳过远程分支依赖，直接用当前标签提交的父节点作为基准：

# 获取当前提交的父节点哈希
BASE_COMMIT=$(git rev-parse HEAD~1)
# 用父节点作为基准执行affected构建
nx affected --target build --base=$BASE_COMMIT

这种方式完全不需要依赖远程分支状态，适配分离头场景更稳定。

3. 调整克隆深度为完整历史 #

如果上面两种方法仍有问题，可以修改bitbucket-pipelines.yml的克隆配置，拉取完整仓库历史（注意：大型仓库会增加克隆耗时）：

clone:
  depth: full

配置后Pipeline会克隆所有分支和提交历史，所有Git引用都能正常识别。

完整Pipeline示例片段 #

pipelines:
  tags:
    '*':
      - step:
          name: 构建受影响项目
          script:
            # 拉取master分支历史
            git fetch origin master:refs/remotes/origin/master
            # 执行affected构建
            nx affected --target build --base=origin/master~1

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