TemplatesUpdated July 3, 2026
Repository Index Template
templatedocumentationterraforminfrastructuretferepository-setuponboarding
{REPO_NAME}
{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
-
Navigate to target workspace:
cd {EXAMPLE_WORKSPACE_PATH} -
Review configuration:
# Check terraform.tfvars.json or .auto.tfvars files cat terraform.tfvars.json -
Authenticate to Terraform Enterprise:
terraform login -
Initialize Terraform:
terraform init -
Validate and plan changes (local validation only):
terraform validate terraform plan -
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 applylocally
-
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
- Architecture Details - Detailed architectural patterns
- Operations Guide - Day-to-day operational procedures
- Development Guide - Development workflows and standards
- Technical Reference - Auto-generated infrastructure documentation
Related Repositories
{RELATED_REPOS}
๐ Support & Contact
- Assignment Group: EPIC NATIONAL INSTANCE - SPT
- Primary Contact: Infrastructure Team
- Emergency Contact: Epic Infrastructure Emergency
Getting Help
- Documentation: Check this repository's docs folder first
- Issues: Create GitHub issue for bugs or feature requests
- Questions: Reach out to the Epic Infrastructure team
- 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.