terraform-aws-lambda-auto-start-stop-rds-instances

A terraform module to start or stop RDS instances on a periodic basis.

In order to save some AWS costs, it is usual to stop Non-Production assets out of business hours. This module enables to stop or start RDS clusters and RDS instances at the time you need.

See related modules:

• julb/terraform-aws-lambda-auto-start-stop-ec2-instances
• julb/terraform-aws-lambda-auto-start-stop-ec2-autoscalinggroups
• julb/terraform-aws-lambda-auto-start-stop-rds-instances
• julb/terraform-aws-lambda-auto-start-stop-cloudwatch-alarms

Usage

• Stop RDS instances

module "stop_rds_instances" {
  source              = "github.com/julb/terraform-aws-lambda-auto-start-stop-rds-instances"
  name                = "StopRDSInstances"
  schedule_expression = "cron(0 0 ? * FRI *)"
  action              = "stop"
  tags                = { "custom:tag" : "someValue" }
  lookup_resource_tag = {
    key   = "ops:env"
    value = "non-prod"
  }
}

• Start RDS instances

module "start_rds_instances" {
  source              = "github.com/julb/terraform-aws-lambda-auto-start-stop-rds-instances"
  name                = "StartRDSInstances"
  schedule_expression = "cron(0 8 ? * MON *)"
  action              = "start"
  tags                = { "custom:tag" : "someValue" }
  lookup_resource_tag = {
    key   = "ops:env"
    value = "non-prod"
  }
}

Module Input Variables

Name	Type	Default	Description
schedule_expression	string	Not Set	The CloudWatch Schedule Expression to trigger the Lambda. Can be a CRON expression for example. Required.
name	string	Not Set	The name of the lambda to create. Required.
tags	map(string)	{}	The tags to assign to the created resources.
custom_iam_role_arn	string	Not Set	The IAM role to assign to the Lambda. If not specified, a role with appropriate permissions will be created.
action	string	Not Set	The action to perform. Valid values are enable,disable. (start, stop are supported aliases as well). Required.
lookup_resource_tag	object{key=string, value=string}	Not Set	The tags to filter on to look for RDS resources within the regions. Required.
lookup_resource_regions	list(string)	Not Set	Look for resources in the specified regions. By default, it uses the region in which the lambda is deployed.

Outputs

Name	Type	Description
lambda_function_name	string	The Lambda function name.
lambda_arn	ARN	The Lambda Amazon Resource Identifier.
lambda_iam_role_arn	ARN	The IAM Role Amazon Resource Identifier assigned to the Lambda.
lambda_log_group_name	string	The CloudWatch Log Group name in which the Lambda push logs.
lambda_log_group_arn	ARN	The CloudWatch Log Group Amazon Resource Identifier assigned in which the Lambda push logs.

Contributing

This project is totally open source and contributors are welcome.

When you submit a PR, please ensure that the python code is well formatted and linted.

$ make format
$ make lint
$ make test