如何获取GitHub的Pull Request变量供Azure DevOps YAML管道使用

该需求可直接实现，依托Azure DevOps与GitHub的官方集成能力即可完成配置，无需开发自定义工具。

方案一：使用Azure DevOps原生GitHub PR触发（推荐，零额外配置） #

这是最简便的实现方式，配置完成后Azure DevOps会自动同步GitHub PR编号为管道内置变量，无需手动传参。

• 第一步：配置管道PR触发规则
  进入Azure DevOps目标管道的编辑页，先确认管道代码源已关联对应GitHub仓库，授权时选择通过Azure Pipelines官方GitHub应用完成授权（不要用旧版PAT授权模式）。在YAML文件顶层添加针对master分支的PR触发配置，示例：

  # 关闭普通分支推送触发（可根据自身需求调整）
  trigger: none
  # 仅当针对master分支发起Pull Request时触发管道
  pr:
    branches:
      include:
      - master
  

• 第二步：直接调用内置变量获取PR编号
  按上述配置完成后，所有符合规则的GitHub PR触发管道运行时，系统会自动将GitHub侧生成的PR编号注入预定义变量System.PullRequest.PullRequestNumber，你可以在YAML的任意步骤中直接通过$(System.PullRequest.PullRequestNumber)调用该值。
  简单的验证示例：

  steps:
  - bash: echo "当前触发管道的GitHub PR编号为 $(System.PullRequest.PullRequestNumber)"
    displayName: 输出PR编号校验
  

  注意：该变量仅在PR触发的管道运行实例中存在，手动触发、普通代码推送触发的管道运行中该变量为空；注意不要和System.PullRequest.PullRequestId混淆，后者是Azure DevOps内部生成的PR对象ID，不是GitHub侧对外展示的PR编号，做业务逻辑判断时需要做好区分和判空处理。

方案二：自定义GitHub Webhook触发场景的配置方法 #

如果你已经在使用GitHub自定义Webhook触发Azure DevOps管道，没有走原生PR触发逻辑，可以按以下步骤映射PR编号：

• 第一步：在GitHub仓库的Webhook配置页，设置监听事件为Pull request，确保事件Payload携带PR核心字段（GitHub默认PR事件Payload会固定在pull_request.number字段返回PR编号，无需额外配置）。
• 第二步：在Azure DevOps的YAML管道中定义用于接收PR编号的自定义变量，示例：

  variables:
    - name: Github_PR_Id
      value: ''
  

• 第三步：配置Webhook触发Azure DevOps管道运行的请求参数时，将GitHub Payload中的pull_request.number字段值映射给管道的Github_PR_Id变量，后续管道步骤中直接通过$(Github_PR_Id)即可拿到对应PR编号。

• 如果原生触发场景下拿不到System.PullRequest.PullRequestNumber值，优先检查GitHub与Azure DevOps的连接授权方式：旧版通过个人访问令牌（PAT）建立的服务连接不会自动注入该变量，删除旧服务连接后重新通过Azure Pipelines官方GitHub应用完成授权即可修复。
• 检查PR的目标分支是否匹配YAML中pr节点配置的包含规则，非目标分支的PR触发不会加载对应变量逻辑。

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