AWS Application and Network Load Balancer Terraform module

Terraform module which creates Application and/or Network Load Balancer resources in AWS.

These types of resources are supported:

• Load Balancer
• Security Group

Terraform versions

Terraform 0.12. Pin module version to ~> v2.1. Submit pull-requests to master branch.

Usage

Application Load Balancer

module "alb" {
  source = "umotif-public/alb/aws"
  version = "~> 2.1.0"

  name_prefix = "complete-alb"

  load_balancer_type = "application"

  internal = false
  vpc_id             = "vpc-abasdasd132"
  subnets            = ["subnet-abasdasd132123", "subnet-abasdasd132123132"]

  access_logs = {
    bucket = "alb-logs"
  }

  tags = {
    Project = "Test"
  }
}

Network Load Balancer

module "nlb" {
  source = "umotif-public/alb/aws"
  version = "~> 2.1.0"

  name_prefix = "complete-nlb"

  load_balancer_type = "network"

  vpc_id             = "vpc-abasdasd132"
  subnets            = ["subnet-abasdasd132123", "subnet-abasdasd132123132"]

  access_logs = {
    bucket = "nlb-logs"
  }

  tags = {
    Project = "Test"
  }
}

Examples

• Application Load Balancer ALB
• Application Load Balancer ALB with S3 access logs
• Application Load Balancer NLB

Authors

Authors

Module managed by uMotif.

Requirements

Name	Version
terraform	~> 1.0.11
aws	>= 3.40.0

Providers

Name	Version
aws	>= 3.40.0

Modules

No modules.

Resources

Name	Type
aws_lb.main	resource
aws_lb_listener.frontend_http_to_https_redirect	resource
aws_security_group.main	resource
aws_security_group_rule.allow_port_443_ingress_for_http_to_https_redirect	resource
aws_security_group_rule.allow_port_80_ingress_for_http_to_https_redirect	resource
aws_security_group_rule.egress	resource

Inputs

Name	Description	Type	Default	Required
access_logs	An Access Logs block.	map(string)	{}	no
cidr_blocks_redirect	List of CIDR ranges to allow at security group level. Defaults to 0.0.0.0/0	list(string)	[ "0.0.0.0/0" ]	no
description	The description of the all resources.	string	"Managed by Terraform"	no
enable_cross_zone_load_balancing	If true, cross-zone load balancing of the load balancer will be enabled. This is a network load balancer feature.	bool	false	no
enable_deletion_protection	If true, deletion of the load balancer will be disabled via the AWS API. This will prevent Terraform from deleting the load balancer.	bool	false	no
enable_http2	Indicates whether HTTP/2 is enabled in application load balancers.	bool	true	no
enable_http_to_https_redirect	Enable default redirect rule from port 80 to 443.	bool	false	no
idle_timeout	(Optional) The time in seconds that the connection is allowed to be idle. Only valid for Load Balancers of type application.	number	60	no
internal	Provision an internal load balancer. Defaults to false.	bool	false	no
ip_address_type	The type of IP addresses used by the subnets for your load balancer. The possible values are ipv4 and dualstack.	string	"ipv4"	no
load_balancer_create_timeout	Timeout value when creating the ALB.	string	"15m"	no
load_balancer_delete_timeout	Timeout value when deleting the ALB.	string	"15m"	no
load_balancer_type	Type of load balancer to provision (network or application).	string	"application"	no
load_balancer_update_timeout	Timeout value when updating the ALB.	string	"15m"	no
name_prefix	A prefix used for naming resources.	string	n/a	yes
subnet_mapping	A list of subnet mapping blocks describing subnets to attach to network load balancer	list(map(string))	[]	no
subnets	A list of subnet IDs to attach to the LB.	list(string)	n/a	yes
tags	A map of tags (key-value pairs) passed to resources.	map(string)	{}	no
vpc_id	The VPC ID.	string	n/a	yes

Outputs

Name	Description
arn	The ARN of the load balancer.
arn_suffix	The ARN suffix for use with CloudWatch Metrics.
dns_name	The DNS name of the load balancer.
name	The name of the load balancer.
origin_id	First part of the DNS name of the load balancer.
security_group_id	The ID of the security group.
zone_id	The canonical hosted zone ID of the load balancer (to be used in a Route 53 Alias record).

License

See LICENSE for full details.

Pre-commit hooks

Install dependencies

• pre-commit
• terraform-docs required for terraform_docs hooks.
• TFLint required for terraform_tflint hook.

MacOS

brew install pre-commit terraform-docs tflint

brew tap git-chglog/git-chglog
brew install git-chglog