Eve library

Iris Infrastructure as Code Modules

Other

Revision 1

On this page

This directory provides Iris-focused IaC orchestration with four capabilities:

  1. TerraformModules: composable Terraform orchestration over Iris cost and DR submodules.
  2. PulumiAlternative: equivalent Pulumi stack structure for teams preferring typed IaC in TypeScript.
  3. InfrastructureTests: Terraform-native test harness and a CI-friendly test runner.
  4. 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 -recursive
  • terraform init -backend=false
  • terraform validate
  • terraform test

Drift Detection Operations#

Run drift checks manually:

bash
bash infra/terraform/iris/modules/drift/detect-drift.sh

Optional overrides:

  • DRIFT_TARGETS: comma-separated directories
  • FAIL_ON_DRIFT: true or false

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).