terraform-aws-alb-ingress

Terraform module to provision an HTTP style ingress based on hostname and/or path.

---

This project is part of our comprehensive "SweetOps" approach towards DevOps.

It's 100% Open Source and licensed under the APACHE2.

Usage

Include this module in your existing terraform code:

module "alb_ingress" {
  source              = "git::https://github.com/cloudposse/terraform-aws-alb-ingress.git?ref=tags/0.2.0"
  namespace          = "eg"
  name               = "app"
  stage              = "dev"

  vpc_id              = "xxxxxxxx"
  listener_arns       = ["xxxxxx", "yyyyyyy"]
  listener_arns_count = "2"
  health_check_path   = "/healthz"
  paths               = ["/*"]
}

Makefile Targets

Available targets:

  help                                This help screen
  help/all                            Display help for all targets
  lint                                Lint terraform code

Inputs

Name	Description	Type	Default	Required
attributes	Additional attributes, e.g. 1	list	<list>	no
delimiter	Delimiter to be used between namespace, name, stage and attributes	string	-	no
deregistration_delay	The amount of time to wait in seconds while deregistering target	string	15	no
health_check_healthy_threshold	The number of consecutive health checks successes required before healthy	string	2	no
health_check_interval	The duration in seconds in between health checks	string	15	no
health_check_matcher	The HTTP response codes to indicate a healthy check	string	200-399	no
health_check_path	The destination for the health check request	string	/	no
health_check_timeout	The amount of time to wait in seconds before failing a health check request	string	10	no
health_check_unhealthy_threshold	The number of consecutive health check failures required before unhealthy	string	2	no
hosts	Hosts to match in Hosts header, at least one of hosts or paths must be set	list	<list>	no
listener_arns	A list of ALB listener ARNs to attach ALB listener rule to	list	<list>	no
listener_arns_count	The number of ARNs in listener_arns, this is necessary to work around a limitation in Terraform where counts cannot be computed	string	0	no
name	Solution name, e.g. app	string	-	yes
namespace	Namespace, which could be your organization name, e.g. cp or cloudposse	string	-	yes
paths	Path pattern to match (a maximum of 1 can be defined), at least one of hosts or paths must be set	list	<list>	no
port	The port for generated ALB target group (if target_group_arn not set)	string	80	no
priority	The priority for the rule between 1 and 50000 (1 being highest priority)	string	100	no
protocol	The protocol for generated ALB target group (if target_group_arn not set)	string	HTTP	no
stage	Stage, e.g. prod, staging, dev, or test	string	-	yes
tags	Additional tags (e.g. map(BusinessUnit,XYZ`)	map	<map>	no
target_group_arn	ALB target group ARN, if this is an empty string a new one will be generated	string	``	no
target_type		string	ip	no
vpc_id	The VPC ID where generated ALB target group will be provisioned (if target_group_arn not set)	string	-	yes

Outputs

Name	Description
target_group_arn	ALB Target group ARN
target_group_arn_suffix	ALB Target group ARN suffix
target_group_name	ALB Target group name

Related Projects

Check out these related projects.

• terraform-aws-alb - Terraform module to create an ALB, default ALB listener(s), and a default ALB target and related security groups.

Help

Got a question?

File a GitHub issue, send us an email or join our Slack Community.

Commercial Support

Work directly with our team of DevOps experts via email, slack, and video conferencing.

We provide commercial support for all of our Open Source projects. As a Dedicated Support customer, you have access to our team of subject matter experts at a fraction of the cost of a full-time engineer.

• Questions. We'll use a Shared Slack channel between your team and ours.
• Troubleshooting. We'll help you triage why things aren't working.
• Code Reviews. We'll review your Pull Requests and provide constructive feedback.
• Bug Fixes. We'll rapidly work to fix any bugs in our projects.
• Build New Terraform Modules. We'll develop original modules to provision infrastructure.
• Cloud Architecture. We'll assist with your cloud strategy and design.
• Implementation. We'll provide hands-on support to implement our reference architectures.

Community Forum

Get access to our Open Source Community Forum on Slack. It's FREE to join for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build sweet infrastructure.

Contributing

Bug Reports & Feature Requests

Please use the issue tracker to report any bugs or file feature requests.

Developing

If you are interested in being a contributor and want to get involved in developing this project or help out with our other projects, we would love to hear from you! Shoot us an email.

In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull Request so that we can review your changes

NOTE: Be sure to merge the latest changes from "upstream" before making a pull request!

Copyright

Copyright © 2017-2018 Cloud Posse, LLC

License

See LICENSE for full details.

Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

  https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

Trademarks

All other trademarks referenced herein are the property of their respective owners.

About

This project is maintained and funded by Cloud Posse, LLC. Like it? Please let us know at [email protected]

We're a DevOps Professional Services company based in Los Angeles, CA. We love Open Source Software!

We offer paid support on all of our projects.

Check out our other projects, apply for a job, or hire us to help with your cloud strategy and implementation.

Contributors

Erik Osterman	Igor Rodionov	Andriy Knysh	Sarkis Varozian