TRAILHEAD

TRAILHEAD is the end-to-end scenario testing framework for HCS Azure infrastructure projects.

While MAPROOM guarantees that templates are syntactically and logically correct, TRAILHEAD actually provisions the infrastructure in a sandbox Azure subscription and runs synthetic tests against it to assert real-world behavior and compliance.

Core Capabilities

• Sandbox Provisioning: Spins up infrastructure in a designated tppoc or tplabs Azure subscription.
• Scenario Validation: Executes synthetic data-plane operations to prove connectivity, RBAC, and policy compliance.
• Automated Teardown: Ensures test resources are completely purged after validation to avoid cost leakage.

Location

The TRAILHEAD runner is located in the platform repository at: testing/trailhead/

Usage in CI/CD

TRAILHEAD is invoked during the Deploy stages of the ADO Reusable Pipelines. It is typically gate-controlled so that it only runs on PRs or branches explicitly targeting integration environments.

Adding a test

1. Create your scenario tests in your repository under /tests/scenario.
2. Define Pester scripts that invoke data-plane operations against your expected resources.
3. The ADO pipeline will seamlessly invoke TRAILHEAD to stand up the environment, run the Pester scripts, and capture the outcomes.