Infra

Architecture Decisions

Architecture Decision Records (ADRs) documenting key infrastructure decisions and their rationale.

Production

Architecture Decision Records (ADRs) capture significant infrastructure decisions, their context, and rationale.

ADRStatusSummary
ADR-001: Hybrid ECR ManagementAcceptedCentral OIDC roles + per-project ECR repositories
ADR-002: Terraform Provider v6 MigrationPendingOptions for migrating from AWS provider v5 to v6
ADR-003: GHA OIDC Trust Tier ModelAcceptedThree-tier trust model for GitHub Actions OIDC roles

ADR Convention

Each ADR follows this structure:

  • Status: Accepted, Pending, Superseded, or Deprecated
  • Context: Why the decision was needed
  • Decision: What was decided
  • Rationale: Why this option was chosen
  • Consequences: Positive and negative impacts

Backend Troubleshooting

How to resolve Terraform backend initialization failures with S3 and DynamoDB.

ADR-001: Hybrid ECR Management

Architecture decision for managing ECR with central OIDC roles and per-project repositories.