This directory provides Iris-focused IaC orchestration with four capabilities:
TerraformModules: composable Terraform orchestration over Iris cost and DR submodules.PulumiAlternative: equivalent Pulumi stack structure for teams preferring typed IaC in TypeScript.InfrastructureTests: Terraform-native test harness and a CI-friendly test runner.DriftDetection: scheduled EventBridge + SNS governance resources and an operational drift detection script/workflow.
Terraform Module Layout#
text
infra/terraform/iris/modules/
├── main.tf
├── variables.tf
├── locals.tf
├── outputs.tf
├── versions.tf
├── tests/
│ ├── modules.tftest.hcl
│ └── run-infrastructure-tests.sh
├── drift/
│ └── detect-drift.sh
└── pulumi/
├── Pulumi.yaml
├── package.json
├── tsconfig.json
├── README.md
└── src/index.ts
Terraform Usage#
hcl
module "iris_iac_modules" {
source = "./infra/terraform/iris/modules"
project_name = "iris"
environment = "prod"
aws_region = "us-east-1"
enable_cost_optimization = true
enable_disaster_recovery = true
enable_drift_detection = true
cluster_name = "iris-prod"
node_role_arn = "arn:aws:iam::123456789012:role/iris-prod-node-role"
private_subnet_ids = ["subnet-aaa", "subnet-bbb", "subnet-ccc"]
rightsizing_asg_names = ["iris-prod-general"]
scheduled_scaling_groups = ["iris-prod-general"]
source_s3_buckets = ["iris-prod-conversations-123456789012"]
hosted_zone_id = "Z123456ABCDEFG"
}
Infrastructure Tests#
bash
bash infra/terraform/iris/modules/tests/run-infrastructure-tests.sh
This runs:
terraform fmt -check -recursiveterraform init -backend=falseterraform validateterraform test
Drift Detection Operations#
Run drift checks manually:
bash
bash infra/terraform/iris/modules/drift/detect-drift.sh
Optional overrides:
DRIFT_TARGETS: comma-separated directoriesFAIL_ON_DRIFT:trueorfalse
Pulumi Alternative#
Pulumi stack lives under infra/terraform/iris/modules/pulumi/ and mirrors the
same governance primitives (cost/DR profile exports + drift detection scheduling
and notifications).