MAPROOM

MAPROOM is the canonical unit testing framework for Bicep and other Infrastructure as Code (IaC) templates across the HCS Platform.

It provides an isolated, offline validation layer that asserts templates compile correctly, enforce naming conventions, and adhere to security baselines without deploying resources to Azure.

Core Capabilities

• Fast Feedback Loop: Executes purely offline validation for Azure Bicep templates.
• Contract Enforcement: Validates that all output contracts and required inputs match expected types.
• Convention Scanning: Scans generated ARM for HCS-specific naming prefixes and tag enforcement.

Location

The MAPROOM runner is located in the platform repository at: testing/maproom/

Usage in CI/CD

MAPROOM is invoked automatically on Pull Requests via the ADO Reusable Pipelines. No manual invocation is required for standard pipeline validation.

Adding a test

1. Within your product repository, navigate to your /tests or /tests/unit folder.
2. Create a standard JSON or Bicep test definition that maps to your template.
3. The pipeline will automatically pick up any test defined under /tests and run MAPROOM against it.