Navigation
TemplatesUpdated July 3, 2026

Repository Index Template

templatedocumentationterraforminfrastructuretferepository-setuponboarding

{REPO_NAME}

{ENVIRONMENT_BADGE} Terraform Azure

{REPO_DESCRIPTION}

๐Ÿ—๏ธ Architecture Overview

This repository follows the {ARCHITECTURE_PATTERN} pattern for {PURPOSE}:

{REPO_NAME}/
โ”œโ”€โ”€ {PRIMARY_FOLDER}/          # {PRIMARY_DESCRIPTION}
โ”œโ”€โ”€ {SECONDARY_FOLDER}/        # {SECONDARY_DESCRIPTION}
โ”œโ”€โ”€ terraform/                 # Shared configurations
โ”œโ”€โ”€ tools/                     # Automation and management tools
โ””โ”€โ”€ docs/                      # Documentation

๐Ÿš€ Quick Start

Prerequisites

  • Terraform >= 1.0
  • Terraform Enterprise (TFE) access with valid authentication credentials
  • Azure CLI configured
  • Access to OHEMR Azure subscriptions
  • HashiCorp Vault access for secrets
  • Repository write access for creating Pull Requests

Deployment Steps

  1. Navigate to target workspace:

    cd {EXAMPLE_WORKSPACE_PATH}
    
  2. Review configuration:

    # Check terraform.tfvars.json or .auto.tfvars files
    cat terraform.tfvars.json
    
  3. Authenticate to Terraform Enterprise:

    terraform login
    
  4. Initialize Terraform:

    terraform init
    
  5. Validate and plan changes (local validation only):

    terraform validate
    terraform plan
    
  6. Create Pull Request:

    • Commit your configuration changes to a feature branch
    • Create a Pull Request to the main branch
    • Request code review from the platform team
    • Note: Do NOT run terraform apply locally
  7. Deployment via TFE:

    • Once PR is approved and merged, Terraform Enterprise automatically applies changes
    • Monitor the TFE workspace run for deployment status
    • Verify resources in Azure portal after successful deployment

{ENVIRONMENT_SPECIFIC_WARNINGS}

๐Ÿ“Š Key Components

{COMPONENT_LIST}

๐Ÿ”— Related Resources

Documentation

Related Repositories

{RELATED_REPOS}

๐Ÿ†˜ Support & Contact

  • Assignment Group: EPIC NATIONAL INSTANCE - SPT
  • Primary Contact: Infrastructure Team
  • Emergency Contact: Epic Infrastructure Emergency

Getting Help

  1. Documentation: Check this repository's docs folder first
  2. Issues: Create GitHub issue for bugs or feature requests
  3. Questions: Reach out to the Epic Infrastructure team
  4. Emergencies: Follow emergency procedures

๐Ÿ“š Additional Information

  • Contributing: See CONTRIBUTING.md for contribution guidelines
  • Security: Follow security procedures for all deployments
  • Compliance: All infrastructure follows OHEMR compliance standards
  • Monitoring: {MONITORING_DETAILS}

This infrastructure is managed by the OHEMR Epic Infrastructure team and supports critical healthcare operations.