Skip to content

{CI} Add Azure Pipeline to trigger reference docs CI#33643

Merged
wangzelin007 merged 2 commits into
Azure:devfrom
wangzelin007:migrate-trigger-reference-docs-ci-to-ado
Jun 25, 2026
Merged

{CI} Add Azure Pipeline to trigger reference docs CI#33643
wangzelin007 merged 2 commits into
Azure:devfrom
wangzelin007:migrate-trigger-reference-docs-ci-to-ado

Conversation

@wangzelin007

@wangzelin007 wangzelin007 commented Jun 24, 2026

Copy link
Copy Markdown
Member

What

Adds .azure-pipelines/trigger-reference-docs-ci.yml, an internal Azure Pipeline that queues the Microsoft Learn docs reference CI pipeline when Azure CLI releases — the same job the existing GitHub Action .github/workflows/TriggerReferenceDocsCI.yml does today, but authenticating with an Azure DevOps service connection (Workload Identity Federation) instead of a federated GitHub login.

Why

The federated credential the GitHub Action relies on is being retired, so the trigger logic is moving into an internal Azure Pipeline.

How it works

  • Triggers on pushes to release, release-lts-*, and test-release-* (the last is for the team to test in isolation). A job condition further restricts execution to those branches, so a stray manual run on any other branch is skipped.
  • The released branch is read automatically from Build.SourceBranchName — no manual parameter to fill.
  • Routing: release-lts-* → the LTS docs pipeline; everything else (release, test-release-*) → the normal (latest) docs pipeline.
  • Authenticates via the ADO service connection and queues the target pipeline with az pipelines build queue, passing the branch through to the downstream pipeline.

The GitHub Action is intentionally kept

TriggerReferenceDocsCI.yml stays in place as a safety net and will be disabled once the new pipeline is validated. The trigger: here only takes effect once the pipeline is registered in ADO, so merging this file is inert until then.

Follow-ups before it goes live

  • Create the WIF service connection, authorize it for this pipeline, and provide its name as ADO_DocsReference_ServiceConnection.
  • Provide ADO_DocsReference_Organization, ADO_DocsReference_Project, ADO_DocsReference_Latest_Pipeline_ID, ADO_DocsReference_LTS_Pipeline_ID via a variable group (uncomment the - group: line) or pipeline variables.
  • Register the pipeline in ADO and confirm the azure-devops CLI extension is available on the agent pool.
  • Validate via a test-release-* branch, then disable the GitHub Action.

@azure-client-tools-bot-prd

azure-client-tools-bot-prd Bot commented Jun 24, 2026

Copy link
Copy Markdown
️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.14
️✔️acs
️✔️latest
️✔️3.12
️✔️3.14
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.14
️✔️ams
️✔️latest
️✔️3.12
️✔️3.14
️✔️apim
️✔️latest
️✔️3.12
️✔️3.14
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.14
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.14
️✔️aro
️✔️latest
️✔️3.12
️✔️3.14
️✔️backup
️✔️latest
️✔️3.12
️✔️3.14
️✔️batch
️✔️latest
️✔️3.12
️✔️3.14
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.14
️✔️billing
️✔️latest
️✔️3.12
️✔️3.14
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.14
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.14
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.14
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.14
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.14
️✔️config
️✔️latest
️✔️3.12
️✔️3.14
️✔️configure
️✔️latest
️✔️3.12
️✔️3.14
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.14
️✔️container
️✔️latest
️✔️3.12
️✔️3.14
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.14
️✔️core
️✔️latest
️✔️3.12
️✔️3.14
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.14
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.14
️✔️dls
️✔️latest
️✔️3.12
️✔️3.14
️✔️dms
️✔️latest
️✔️3.12
️✔️3.14
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.14
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.14
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.14
️✔️find
️✔️latest
️✔️3.12
️✔️3.14
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.14
️✔️identity
️✔️latest
️✔️3.12
️✔️3.14
️✔️iot
️✔️latest
️✔️3.12
️✔️3.14
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.14
️✔️lab
️✔️latest
️✔️3.12
️✔️3.14
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.14
️✔️maps
️✔️latest
️✔️3.12
️✔️3.14
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.14
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.14
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.14
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.14
️✔️network
️✔️latest
️✔️3.12
️✔️3.14
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.14
️✔️postgresql
️✔️latest
️✔️3.12
️✔️3.14
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.14
️✔️profile
️✔️latest
️✔️3.12
️✔️3.14
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.14
️✔️redis
️✔️latest
️✔️3.12
️✔️3.14
️✔️relay
️✔️latest
️✔️3.12
️✔️3.14
️✔️resource
️✔️latest
️✔️3.12
️✔️3.14
️✔️role
️✔️latest
️✔️3.12
️✔️3.14
️✔️search
️✔️latest
️✔️3.12
️✔️3.14
️✔️security
️✔️latest
️✔️3.12
️✔️3.14
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.14
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.14
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.14
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.14
️✔️sql
️✔️latest
️✔️3.12
️✔️3.14
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.14
️✔️storage
️✔️latest
️✔️3.12
️✔️3.14
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.14
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.14
️✔️util
️✔️latest
️✔️3.12
️✔️3.14
️✔️vm
️✔️latest
️✔️3.12
️✔️3.14

@azure-client-tools-bot-prd

Copy link
Copy Markdown

Hi @wangzelin007,
Since the current milestone time is less than 7 days, this pr will be reviewed in the next milestone.

@azure-client-tools-bot-prd

azure-client-tools-bot-prd Bot commented Jun 24, 2026

Copy link
Copy Markdown
️✔️AzureCLI-BreakingChangeTest
️✔️Non Breaking Changes

@yonzhan

yonzhan commented Jun 24, 2026

Copy link
Copy Markdown
Collaborator

CI

@yonzhan yonzhan requested a review from naga-nandyala June 24, 2026 22:44
@wangzelin007 wangzelin007 force-pushed the migrate-trigger-reference-docs-ci-to-ado branch 4 times, most recently from 2561d2c to fb69a2d Compare June 25, 2026 02:15
Add .azure-pipelines/trigger-reference-docs-ci.yml, an internal Azure Pipeline that queues the docs reference CI pipeline on release, replacing the GitHub Action's FIC-based login with an Azure DevOps service connection. The existing GitHub Action is kept for now as a safety net.
@wangzelin007 wangzelin007 force-pushed the migrate-trigger-reference-docs-ci-to-ado branch from fb69a2d to e232d8e Compare June 25, 2026 02:18
Comment thread .azure-pipelines/trigger-reference-docs-ci.yml Outdated
@wangzelin007 wangzelin007 marked this pull request as ready for review June 25, 2026 05:26
Copilot AI review requested due to automatic review settings June 25, 2026 05:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an internal Azure Pipelines definition to trigger the Microsoft Learn reference docs CI pipeline on Azure CLI release branch updates, replacing the retiring GitHub Action–based federated auth with an Azure DevOps service connection (WIF) approach.

Changes:

  • Introduces .azure-pipelines/trigger-reference-docs-ci.yml that triggers on release, release-lts-*, and test-release-*.
  • Queues the appropriate downstream docs reference pipeline (LTS vs latest) via az pipelines build queue, passing branch and provenance variables.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .azure-pipelines/trigger-reference-docs-ci.yml
@wangzelin007 wangzelin007 merged commit fda67c9 into Azure:dev Jun 25, 2026
50 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants