如何在GitHub Actions中获取标签关联分支解决推送报错

错误原因 #

你当前报错的核心原因是：打标签触发流水线时，github.ref 的值为标签引用格式（如refs/tags/v0.3.8），你直接将该值传给 ad-m/github-push-action 的 branch 参数，相当于尝试向已经存在的远端标签提交新内容，自然会被远端仓库拒绝。你预期是将kustomize配置的修改推到该标签对应的源分支，而非标签本身。

修复步骤 #

1. 调整checkout配置，拉取完整仓库信息 #

默认actions/checkout是浅克隆，无法查询标签和分支的关联关系，需要修改为全量克隆：

- name: Checkout master
  uses: actions/checkout@main
  with:
    fetch-depth: 0 # 拉取所有历史和分支信息

2. 修正触发条件，仅在打标签时执行kustomize相关步骤 #

你当前的if条件写法不规范，且会同时匹配标签和PR事件，PR事件下无需执行提交推送操作，调整为仅匹配打标签的场景：把所有kustomize相关步骤（Setup Kustomize、Update Kubernetes resources、Commit files、Push changes）的if条件统一替换为：

if: startsWith(github.ref, 'refs/tags/v')

3. 新增步骤获取标签对应的源分支 #

在修改kustomize配置的步骤前，新增步骤查询当前标签所属的目标分支（假设你的标签仅打在main或staging分支上）：

- name: Get tag associated branch
  id: get-branch
  if: startsWith(github.ref, 'refs/tags/v')
  run: |
    # 查询当前提交所属的远端分支，过滤出main或staging
    BRANCH=$(git branch -r --contains ${{ github.sha }} | grep -E 'main|staging' | head -n 1 | sed 's/.*origin\///')
    echo "branch=$BRANCH" >> $GITHUB_OUTPUT

4. 调整kustomize修改、提交、推送逻辑 #

先切到目标分支拉取最新代码，再修改配置、提交、推送，避免冲突和游离HEAD问题：

- name: Update Kubernetes resources
  if: startsWith(github.ref, 'refs/tags/v')
  run: |
    # 先切到目标分支拉取最新代码
    git checkout ${{ steps.get-branch.outputs.branch }}
    git pull origin ${{ steps.get-branch.outputs.branch }}
    # 再修改kustomize配置
    cd k8s-deployment/feature-version
    kustomize edit set image robo-image=docker.pkg.github.com/${{ github.repository }}/$IMAGE_NAME:$GITHUB_SHA
    cat kustomization.yaml
- name: Commit files
  if: startsWith(github.ref, 'refs/tags/v')
  run: |
    git config --local user.email "action@github.com"
    git config --local user.name "GitHub Action" 
    git commit -am "Bump docker tag for release ${{ github.ref_name }}"
- name: Push changes
  if: startsWith(github.ref, 'refs/tags/v')
  uses: ad-m/github-push-action@master
  with:
    github_token: ${{ secrets.GITHUB_TOKEN }}
    branch: ${{ steps.get-branch.outputs.branch }}

可选优化 #

你当前两个镜像推送步骤的if判断写法不规范，建议调整为更清晰的格式：

• 标签触发的镜像推送步骤if改为：if: startsWith(github.ref, 'refs/tags/v')
• main/staging分支触发的镜像推送步骤if保持原有写法即可

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