Terraform module for Iris cost governance across four operational areas:
SpotInstanceUsage: cost-optimized EKS node group + interruption events.RightSizing: utilization alarms + Compute Optimizer enrollment.ResourceScheduling: recurring ASG scale-down/scale-up schedules.CostAlerting: monthly budget, anomaly detection, and billing alarms.
What It Creates#
- Spot-backed managed node group for burst/flexible workloads.
- EventBridge rule to capture EC2 spot interruption and rebalance events.
- Under/over-utilization alarms for configured Auto Scaling groups.
- Recurring scaling schedules for off-hours and business-hours capacity.
- Budget threshold notifications, anomaly subscription, and estimated-charge alarm.
- SSM profiles for right-sizing and schedule policy observability.
Example Usage#
hcl
module "iris_cost" {
source = "./infra/terraform/iris/cost"
project_name = "iris"
environment = "prod"
aws_region = "us-east-1"
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", "iris-prod-workers"]
scheduled_scaling_groups = ["iris-prod-general", "iris-prod-workers"]
monthly_budget_amount_usd = 20000
budget_actual_threshold_pct = 90
budget_forecast_threshold_pct = 80
cost_anomaly_threshold_usd = 150
budget_notification_emails = ["finops@example.com", "platform-oncall@example.com"]
}
Operational Notes#
- Use spot capacity only for interruption-tolerant workloads.
- Keep at least one on-demand baseline node group for critical services.
- Start with conservative off-hours schedules, then tighten as usage stabilizes.
- Right-sizing alarms are signals for review; validate with workload SLOs before changing capacity.
- AWS billing metrics are emitted in
us-east-1; the estimated-charges alarm is gated to that region.
Validation#
bash
terraform -chdir=infra/terraform/iris/cost init
terraform -chdir=infra/terraform/iris/cost validate
terraform -chdir=infra/terraform/iris/cost plan