# Iris Infrastructure as Code Modules

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