kerscher / ebs_bckup

tf_ebs_bckup

a Lambda-powered EBS Snapshot Terraform Module

A Terraform module for creating a Lambda Function that takes automatic snapshots of of all connected EBS volumes of correspondingly tagged instances. The function is triggered via a CloudWatch event that can be freely configured by a cronlike expression.

Input Variables:

• ec2_instance_tag - All instances with this tag will be backed up. Default is "BackupSchedule"
• ec2_instance_value - Value of ec_instance_tag that will trigger this backup schedule being executed
• retention_days - Number of day the created EBS Snapshots will be stored, defaults to 5
• unique_name - Just a marker for the Terraform stack. Default is "v1"`
• stack_prefix - Prefix for resource generation. Default is ebs_bckup
• cron_expression - Cron expression for CloudWatch events. Default is "22 1 * * ? *"
• regions - List of regions in which the Lambda function should run. Requires at least one entry (eg. ["eu-west-1", "us-west-1"])

Outputs

Default outputs are aws_iam_role_arn with the value of the created IAM role for the Lambda function and the lambda_function_name

Example usage

In your Terrafom main.tf call the module with the required variables.

module "ebs-backup-daily" {
  source             = "github.com/kgorskowski/ebs_bckup"
  ec2_instance_tag   = "BackupSchedule"
  ec2_instance_value = "MissionCritical"
  retention_days     = 7
  unique_name        = "${some_unique_value}"
  stack_prefix       = "${var.name_prefix}-ebs-backup-daily"
  cron_expression    = "45 1 * * ? *"
  regions            = ["eu-west-1", "eu-central-1"]
}