ADO Reusable Pipelines

As part of the enterprise consolidation into Azure DevOps, HCS Platform Engineering provides a suite of standardized, reusable ADO Pipeline templates. These templates completely replace bespoke .github/workflows and ensure all deployments across the estate adhere to corporate governance.

Key Benefits

• Zero-Boilerplate Deployments: Downstream product repos do not need to invent pipeline logic. They simply reference the reusable templates.
• Embedded Security & Governance: Static Code Analysis, credential scanning, and MAPROOM validations are automatically injected into every run.
• Cross-environment Consistency: Guarantees identical execution environments and steps for every deployment across the entire HCS estate.

Location

The reusable pipeline templates are hosted in the platform repository at: .ado/pipelines/reusable/

Available Templates

1. ci-validation.yml

Executed on Pull Requests. Triggers MAPROOM, Bicep linter, and static code analysis. Does not perform deployments.

2. cd-deployment.yml

Executed on merges to master/main. Orchestrates multi-stage deployments, optionally invoking TRAILHEAD if scenario tests are present in the repository.

3. docs-publish.yml

A specialized pipeline for publishing VitePress documentation updates. It automatically triggers when changes to the docs/ folder or mkdocs.yml (if legacy) are detected.

Usage Example

In your product repository, create .ado/pipelines/azure-pipelines.yml:

trigger:
  - master

resources:
  repositories:
    - repository: templates
      type: git
      name: Platform Engineering/Platform Engineering

extends:
  template: .ado/pipelines/reusable/cd-deployment.yml@templates
  parameters:
    environment: production
    serviceConnection: hcs-platform-automation-spn-prod