基于feature branch的Pipeline仅显示main分支，如何配置显示全部分支？

问题 #

我配置了一条允许用户通过复选框选择一个或多个服务的Pipeline，当前该Pipeline基于feature branch运行。整体运行正常，但存在一个问题：运行该Pipeline时，仅能看到仓库的main branch，无法看到release branch或其他feature branch。我已在resources节点中指定了分支名称（详见下方代码），不希望用户每次运行时手动输入release branch或feature branch的名称，想知道问题原因。

Pipeline代码如下：

trigger: none

pool:
  vmImage: 'ubuntu-latest'

parameters:
# hyphens not supported in the name
- name: external_portal
  type: boolean
  default: false
- name: internal_portal
  type: boolean
  default: false

resources:
  repositories:
    - repository: templates
      type: git
      name: deploy-templates/deploy-templates
      ref: refs/heads/feature-branch
    - repository: external-portal
      type: git
      name: aks-microservices/ExternalPortal
      ref: refs/heads/main
    - repository: internal-portal
      type: git
      name: aks-microservices/InternalPortal
      ref: refs/heads/main
      
stages:
- ${{ if eq(parameters.external_portal, true) }}:
    - template: pipelines/templates/deploy.yml@templates
      parameters:
        aksNameSpace: 'external'
        aksServiceName: 'external-portal'
- ${{ if eq(parameters.internal_portal, true) }}:
    - template: pipelines/templates/deploy.yml@templates
      parameters:
        aksNameSpace: 'internal'
        aksServiceName: 'internal-portal'

注：出于安全考虑，已修改代码并移除部分参数等内容。原本期望能看到仓库的全部分支。

问题原因及解决方案 #

核心原因 #

你在resources.repositories节点中给每个仓库都硬编码了固定的ref值（比如refs/heads/main、refs/heads/feature-branch），这会强制Pipeline只拉取指定分支的代码，运行时自然不会显示其他分支的选项。

解决办法 #

如果想让用户能选择任意分支且无需手动输入分支名，按以下步骤调整：

• 添加分支选择参数：在parameters区块新增分支选择参数，可手动指定可选分支，简单场景推荐这种方式。示例：

  parameters:
  # 保留原有复选框参数
  - name: external_portal
    type: boolean
    default: false
  - name: internal_portal
    type: boolean
    default: false
  # 新增分支选择参数
  - name: target_branch
    type: string
    default: main
    allowedValues:
      - main
      - release-v1.0
      - feature-new-function
  

• 替换硬编码ref为参数变量：将resources.repositories中的固定ref值替换为参数变量，让Pipeline根据用户选择拉取对应分支代码：

  resources:
    repositories:
      - repository: templates
        type: git
        name: deploy-templates/deploy-templates
        ref: refs/heads/${{ parameters.target_branch }}
      - repository: external-portal
        type: git
        name: aks-microservices/ExternalPortal
        ref: refs/heads/${{ parameters.target_branch }}
      - repository: internal-portal
        type: git
        name: aks-microservices/InternalPortal
        ref: refs/heads/${{ parameters.target_branch }}
  

• 多仓库独立选分支（可选）：如果不同服务仓库需要选择不同分支，可给每个仓库单独添加分支参数（比如external_portal_branch、internal_portal_branch），再分别替换对应仓库的ref值即可。

内容的提问来源于stack exchange，提问作者DevOps-AS