From 6463dc802d477257459de7340f14b5e1053a4032 Mon Sep 17 00:00:00 2001
From: Zelin Wang <zelinwang@microsoft.com>
Date: Fri, 26 Jun 2026 17:12:12 +1000
Subject: [PATCH] Switch docs reference trigger from branch to tag trigger

---
 .../trigger-reference-docs-ci.yml             | 24 ++++++++++++++-----
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/.azure-pipelines/trigger-reference-docs-ci.yml b/.azure-pipelines/trigger-reference-docs-ci.yml
index 3c3ca499721..110e4fb262d 100644
--- a/.azure-pipelines/trigger-reference-docs-ci.yml
+++ b/.azure-pipelines/trigger-reference-docs-ci.yml
@@ -2,10 +2,11 @@ name: Azure CLI Trigger Reference Docs CI
 
 trigger:
   branches:
+    exclude:
+    - '*'
+  tags:
     include:
-    - release
-    - release-lts-*
-    - test-release-*
+    - azure-cli-*
 
 pr: none
 
@@ -19,7 +20,6 @@ variables:
 jobs:
 - job: TriggerReferenceDocsCI
   displayName: 'Queue Microsoft Learn Docs Reference CI'
-  condition: or(eq(variables['Build.SourceBranchName'], 'release'), startsWith(variables['Build.SourceBranchName'], 'release-lts-'), startsWith(variables['Build.SourceBranchName'], 'test-release-'))
   pool:
     name: ${{ variables.ubuntu_pool }}
   steps:
@@ -35,7 +35,19 @@ jobs:
         $project = $env:AdoProject
         $thisRepoLink = $env:ThisRepoLink
         $thisRunLink = $env:ThisRunLink
-        $triggerBranch = $env:ReleaseBranch
+        $tagName = $env:TagName
+
+        # The release tag is created via the GitHub Releases API with target_commitish = 'release'
+        # (latest) or 'release-lts-<version>' (LTS). Look it up to pick the matching docs pipeline.
+        $triggerBranch = 'release'
+        try {
+            $release = Invoke-RestMethod -Uri "https://api.github.com/repos/Azure/azure-cli/releases/tags/$tagName" -Headers @{ 'User-Agent' = 'azure-cli-ado' }
+            $triggerBranch = $release.target_commitish
+        }
+        catch {
+            Write-Host "No GitHub Release found for tag '$tagName' (or lookup failed); defaulting to latest. $_"
+        }
+
         $definitionId = $triggerBranch -like 'release-lts-*' ? $env:AdoLtsPipelineId : $env:AdoLatestPipelineId
         $variables = @("triggerBranch=$triggerBranch", "triggerFromRepo=$thisRepoLink", "triggerByPipeline=$thisRunLink")
 
@@ -53,6 +65,6 @@ jobs:
       AdoProject: $(ADO_DocsReference_Project)
       AdoLatestPipelineId: $(ADO_DocsReference_Latest_Pipeline_ID)
       AdoLtsPipelineId: $(ADO_DocsReference_LTS_Pipeline_ID)
-      ReleaseBranch: $(Build.SourceBranchName)
+      TagName: $(Build.SourceBranchName)
       ThisRepoLink: $(Build.Repository.Uri)
       ThisRunLink: $(System.CollectionUri)$(System.TeamProject)/_build/results?buildId=$(Build.BuildId)