feat(examples): add timezone scheduler example with Lambda functions

Introduced a new example for scheduling AWS Lambda
functions to stop and start resources based on
specified timezones.

Author: diodonfrost

examples/timezone-scheduler/main.tf

@@ -0,0 +1,34 @@
+# Deploy two lambda for testing with awspec
+resource "random_pet" "suffix" {}
+
+module "aws-stop-friday" {
+  source                       = "../.."
+  name                         = "stop-aws-${random_pet.suffix.id}"
+  schedule_expression          = "cron(0 23 ? * FRI *)"
+  schedule_expression_timezone = "Europe/Paris"
+  schedule_action              = "stop"
+  autoscaling_schedule         = "true"
+  ec2_schedule                 = "true"
+  rds_schedule                 = "true"
+
+  scheduler_tag = {
+    key   = "tostop"
+    value = "true-${random_pet.suffix.id}"
+  }
+}
+
+module "aws-start-monday" {
+  source                       = "../.."
+  name                         = "start-aws-${random_pet.suffix.id}"
+  schedule_expression          = "cron(0 07 ? * MON *)"
+  schedule_expression_timezone = "Europe/Berlin"
+  schedule_action              = "start"
+  autoscaling_schedule         = "true"
+  ec2_schedule                 = "true"
+  rds_schedule                 = "true"
+
+  scheduler_tag = {
+    key   = "tostop"
+    value = "true-${random_pet.suffix.id}"
+  }
+}

examples/timezone-scheduler/terraform.tftest.hcl

@@ -0,0 +1,33 @@
+run "create_test_infrastructure" {
+  command = apply
+
+  assert {
+    condition     = module.aws-stop-friday.scheduler_lambda_name == "stop-aws-${random_pet.suffix.id}"
+    error_message = "Invalid Stop lambda name"
+  }
+
+  assert {
+    condition     = module.aws-start-monday.scheduler_lambda_name == "start-aws-${random_pet.suffix.id}"
+    error_message = "Invalid Start lambda name"
+  }
+
+  assert {
+    condition     = module.aws-stop-friday.scheduler_expression == "cron(0 23 ? * FRI *)"
+    error_message = "Invalid scheduler expression"
+  }
+
+  assert {
+    condition     = module.aws-start-monday.scheduler_expression == "cron(0 07 ? * MON *)"
+    error_message = "Invalid scheduler expression"
+  }
+
+  assert {
+    condition     = module.aws-stop-friday.scheduler_timezone == "Europe/Paris"
+    error_message = "Invalid scheduler timezone"
+  }
+
+  assert {
+    condition     = module.aws-start-monday.scheduler_timezone == "Europe/Berlin"
+    error_message = "Invalid scheduler timezone"
+  }
+}

examples/timezone-scheduler/versions.tf

@@ -0,0 +1,10 @@
+terraform {
+  required_version = ">= 1.0"
+
+  required_providers {
+    aws = {
+      source  = "hashicorp/aws"
+      version = ">= 5.94.1"
+    }
+  }
+}