Azure DevOps编辑流水线点击查看模板时出现Endpoint参数缺失错误

问题描述 #

编辑Azure DevOps流水线时，点击编辑器中的"View Template"链接触发以下错误：

An error occurred while fetching the pipeline. Repository requires an endpoint Parameter name: endpoint

主流水线引用了GitHub仓库中的模板，仅保留模板内的checkout: self时流水线可正常运行，但添加checkout: mydevops后就会触发上述错误，需求是同时检出源仓库和模板所在仓库。

主流水线YAML配置 #

resources:
  repositories:
    - repository: my-devops
      type: github
      endpoint: my-ops
      name: my-ops/my-devops
      ref: main
  pipelines:
    - pipeline: build-my-test
      source: build-my-test
      trigger:
        branches:
          include:
            - main

stages:
  - template: applications/deploy.yaml@my-devops
    parameters:
      TARGET_ENV: dev

模板deploy.yaml配置 #

stages:
  - stage: Deploy
    displayName: Deploy stage

    jobs:
      - deployment: Deploy
        environment: $(ADO_ENVIRONMENT_NAME)
        displayName: Deploy
        pool:
          name: self-hosted
        strategy:
          runOnce:
            deploy:
              steps:
                - checkout: self # 仅保留此行时正常运行
                - checkout: mydevops # 添加此行后触发报错

                - task: Bash@3
                  inputs:
                    targetType: 'inline'
                    script: |
                      # Write your commands here
                       
                      echo 'Hello world'

解决方法 #

1. 修正仓库别名拼写：主流水线resources.repositories中定义的仓库别名是my-devops，但模板中checkout引用的是mydevops（缺少横杠），两者必须完全匹配。将模板中的checkout: mydevops修改为：

   - checkout: my-devops
   

2. 验证服务连接有效性：确认GitHub服务连接my-ops状态正常，且拥有访问my-ops/my-devops仓库的权限。
3. 重新保存流水线：修改完成后保存主流水线，再次尝试点击"View Template"即可正常加载。

说明 #

Azure DevOps中引用资源仓库时，别名是系统识别仓库配置（包括endpoint）的关键，必须严格匹配主流水线中定义的名称，否则无法找到对应的端点配置，从而触发"Repository requires an endpoint"错误。

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