Skip to content

Creating an ADR

Example only

Review and validate before production use. All values below are placeholders.

Title

Adopt Terraform for baseline Azure infrastructure provisioning.

Status

Accepted

Date

2026-07-17

Context

The team needs repeatable infrastructure deployments with peer review and version control.

Decision

Use Terraform modules for shared infrastructure components and enforce pull request review before apply.

Options considered

  1. Terraform modules with GitHub Actions deployment workflow.
  2. Manual portal-based provisioning.
  3. Mixed tooling without module standards.

Consequences

  • Positive: repeatable deployments and auditable changes.
  • Trade-off: requires module lifecycle management and version governance.

Security impact

Improves traceability and reduces manual misconfiguration risk.

Operational impact

Requires CI/CD ownership for validation and deployment pipelines.

Follow-up actions

  • Define module versioning policy.
  • Add policy checks in CI.
  • Establish rollback runbook.