alb-ingress

cloudposse/alb-ingress/aws

Terraform Module HCL AWS

Terraform module to provision an HTTP style ingress rule based on hostname and path for an ALB using target groups

Install
module "alb-ingress" {
source = "cloudposse/alb-ingress/aws"
version = "0.31.0"
}
⭐ Source on GitHub 📦 Registry page
README

Terraform module to provision an HTTP style ALB ingress based on hostname and/or path. ALB ingress can be provisioned without authentication, or using Cognito or OIDC authentication. > [!TIP] > #### 👽 Use Atmos with Terraform > Cloud Posse uses atmos to easily orchestrate multiple environments using Terraform. > Works with Github Actions, Atlantis, or Spacelift. > > > Watch demo of using Atmos with Terraform > > Example of running atmos to manage infrastructure from our Quick Start tutorial. > Usage For a complete example, see examples/complete. For automated test of the complete example using bats and Terratest, see test. ```hcl provider "aws" { region = var.region } module "vpc" { source = "cloudposse/vpc/aws" # Cloud Posse recommends pinning every module to a specific version # version

Inputs (50)
NameTypeDescriptionDefault
vpc_idstringThe VPC ID where generated ALB target group will be provisioned (if `target_grou required
deregistration_delaynumberThe amount of time to wait in seconds while deregistering target15
authentication_cognito_user_pool_arnstringCognito User Pool ARN""
authentication_oidc_client_secretstringOIDC Client Secret""
health_check_pathstringThe destination for the health check request"/"
health_check_protocolstringThe protocol to use to connect with the target. Defaults to `HTTP`. Not applicab"HTTP"
enabledboolSet to false to prevent the module from creating any resourcesnull
tenantstringID element _(Rarely used, not included by default)_. A customer identifier, indinull
delimiterstringDelimiter to be used between ID elements. Defaults to `-` (hyphen). Set to `""` null
default_target_group_enabledboolEnable/disable creation of the default target grouptrue
authentication_oidc_user_info_endpointstringOIDC User Info Endpoint""
load_balancing_algorithm_typestringDetermines how the load balancer selects targets when routing requests. Only app"round_robin"
health_check_portstringThe port to use to connect with the target. Valid values are either ports 1-6553"traffic-port"
authentication_cognito_on_unauthenticated_requeststringCognito unauthenticated behavior, deny, allow, or authenticate"authenticate"
authentication_oidc_client_idstringOIDC Client ID""
label_value_casestringControls the letter case of ID elements (labels) as included in `id`, set as tagnull
health_check_healthy_thresholdnumberThe number of consecutive health checks successes required before healthy2
health_check_intervalnumberThe duration in seconds in between health checks15
protocol_versionstringOnly applicable when protocol is `HTTP` or `HTTPS`. The protocol version. Specif"HTTP1"
authentication_cognito_user_pool_client_idstringCognito User Pool Client ID""
authentication_oidc_authorization_endpointstringOIDC Authorization Endpoint""
… and 10 more inputs
Outputs (3)
target_group_name — ALB Target Group name
target_group_arn — ALB Target Group ARN
target_group_arn_suffix — ALB Target Group ARN suffix
Resources (2)
aws_lb_listener_ruleaws_lb_target_group
Details
FrameworkTerraform Module
LanguageHCL
Version0.31.0
Cloud AWS
★ Stars31
Forks54
Total downloads2.1M
Inputs50
Outputs3
Resources2
Examples1
LicenseApache-2.0
Namespacecloudposse
Updated