README.yaml

name: terraform-aws-alb
license: APACHE2
github_repo: cloudposse/terraform-aws-alb
badges:
  - name: Latest Release
    image: https://img.shields.io/github/release/cloudposse/terraform-aws-alb.svg
    url: https://github.com/cloudposse/terraform-aws-alb/releases/latest
  - name: Slack Community
    image: https://slack.cloudposse.com/badge.svg
    url: https://slack.cloudposse.com
related:
  - name: terraform-aws-alb-ingress
    description:
      Terraform module to provision an HTTP style ingress rule based on hostname
      and path for an ALB
    url: https://github.com/cloudposse/terraform-aws-alb-ingress
description:
  Terraform module to create an ALB, default ALB listener(s), and a default
  ALB target and related security groups.
usage: |-
  For a complete example, see [examples/complete](examples/complete).

  For automated test of the complete example using `bats` and `Terratest`, see [test](test).

  ```hcl
    provider "aws" {
      region = var.region
    }

    module "vpc" {
      source     = "git::https://github.com/cloudposse/terraform-aws-vpc.git?ref=tags/0.8.1"
      namespace  = var.namespace
      stage      = var.stage
      name       = var.name
      delimiter  = var.delimiter
      attributes = var.attributes
      cidr_block = var.vpc_cidr_block
      tags       = var.tags
    }

    module "subnets" {
      source               = "git::https://github.com/cloudposse/terraform-aws-dynamic-subnets.git?ref=tags/0.16.1"
      availability_zones   = var.availability_zones
      namespace            = var.namespace
      stage                = var.stage
      name                 = var.name
      attributes           = var.attributes
      delimiter            = var.delimiter
      vpc_id               = module.vpc.vpc_id
      igw_id               = module.vpc.igw_id
      cidr_block           = module.vpc.vpc_cidr_block
      nat_gateway_enabled  = false
      nat_instance_enabled = false
      tags                 = var.tags
    }

    module "alb" {
      source                                  = "git::https://github.com/cloudposse/terraform-aws-alb.git?ref=master"
      namespace                               = var.namespace
      stage                                   = var.stage
      name                                    = var.name
      attributes                              = var.attributes
      delimiter                               = var.delimiter
      vpc_id                                  = module.vpc.vpc_id
      security_group_ids                      = [module.vpc.vpc_default_security_group_id]
      subnet_ids                              = module.subnets.public_subnet_ids
      internal                                = var.internal
      http_enabled                            = var.http_enabled
      http_redirect                           = var.http_redirect
      access_logs_enabled                     = var.access_logs_enabled
      alb_access_logs_s3_bucket_force_destroy = var.alb_access_logs_s3_bucket_force_destroy
      access_logs_region                      = var.access_logs_region
      cross_zone_load_balancing_enabled       = var.cross_zone_load_balancing_enabled
      http2_enabled                           = var.http2_enabled
      idle_timeout                            = var.idle_timeout
      ip_address_type                         = var.ip_address_type
      deletion_protection_enabled             = var.deletion_protection_enabled
      deregistration_delay                    = var.deregistration_delay
      health_check_path                       = var.health_check_path
      health_check_timeout                    = var.health_check_timeout
      health_check_healthy_threshold          = var.health_check_healthy_threshold
      health_check_unhealthy_threshold        = var.health_check_unhealthy_threshold
      health_check_interval                   = var.health_check_interval
      health_check_matcher                    = var.health_check_matcher
      target_group_port                       = var.target_group_port
      target_group_target_type                = var.target_group_target_type
      stickiness                              = var.stickiness
      tags                                    = var.tags
    }
  ```
include:
  - docs/targets.md
  - docs/terraform.md
contributors:
  - name: Erik Osterman
    github: osterman
  - name: Igor Rodionov
    github: goruha
  - name: Andriy Knysh
    github: aknysh
  - name: Sarkis Varozian
    github: sarkis
  - name: Adam Crews
    github: adamcrews