# cloudposse/terraform-aws-alb architecture

> Architecture diagram of the GitHub repository cloudposse/terraform-aws-alb, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cloudposse/terraform-aws-alb
- Repository: https://github.com/cloudposse/terraform-aws-alb

## Overview

This Terraform module provisions an AWS Application Load Balancer and supporting infrastructure. A caller supplies configuration, Terraform creates the load balancer, listeners, target group, security groups, and optionally access-log storage, then exposes outputs. The README documents these capabilities and resources; source excerpts were not provided, so the graph uses only documented relationships.

Main entry points: [`main.tf`](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf) (ALB Module), [`variables.tf`](https://github.com/cloudposse/terraform-aws-alb/blob/main/variables.tf) (Module Inputs), [`outputs.tf`](https://github.com/cloudposse/terraform-aws-alb/blob/main/outputs.tf) (Module Outputs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Module Configuration"]
  node_inputs["Module Inputs<br/>[variables.tf]"]
  node_module["ALB Module<br/>[main.tf]"]
end

subgraph group_load_balancing["Load Balancing"]
  node_load_balancer["Load Balancer<br/>[main.tf]"]
  node_listeners["HTTP and HTTPS Listeners<br/>[main.tf]"]
  node_target_group["Default Target Group<br/>[main.tf]"]
end

subgraph group_network_security["Network Security"]
  node_security_group["Security Group Rules<br/>[main.tf]"]
end

subgraph group_operations["Logging and Outputs"]
  node_access_logs["Access Log Storage<br/>[main.tf]"]
  node_outputs["Module Outputs<br/>[outputs.tf]"]
end

node_caller(("Terraform Caller"))
node_aws[("AWS")]

node_caller -->|"provides configuration"| node_inputs
node_inputs -->|"configures"| node_module
node_module -->|"creates"| node_load_balancer
node_module -->|"creates"| node_listeners
node_module -->|"creates"| node_target_group
node_module -->|"creates"| node_security_group
node_module -.->|"configures optionally"| node_access_logs
node_module -->|"exposes"| node_outputs
node_module -->|"provisions resources"| node_aws

click node_inputs "https://github.com/cloudposse/terraform-aws-alb/blob/main/variables.tf"
click node_module "https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf"
click node_load_balancer "https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf"
click node_listeners "https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf"
click node_target_group "https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf"
click node_security_group "https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf"
click node_access_logs "https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf"
click node_outputs "https://github.com/cloudposse/terraform-aws-alb/blob/main/outputs.tf"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_inputs,node_module toneBlue
class node_load_balancer,node_listeners,node_target_group,node_aws toneAmber
class node_security_group toneMint
class node_access_logs,node_outputs toneRose
class node_caller toneIndigo
```

## Components

### Module Configuration

- [Module Inputs](https://github.com/cloudposse/terraform-aws-alb/blob/main/variables.tf): `variables.tf`
- [ALB Module](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf): `main.tf`

### Load Balancing

- [Load Balancer](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf): `main.tf`
- [HTTP and HTTPS Listeners](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf): `main.tf`
- [Default Target Group](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf): `main.tf`

### Network Security

- [Security Group Rules](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf): `main.tf`

### Logging and Outputs

- [Access Log Storage](https://github.com/cloudposse/terraform-aws-alb/blob/main/main.tf): `main.tf`
- [Module Outputs](https://github.com/cloudposse/terraform-aws-alb/blob/main/outputs.tf): `outputs.tf`

### Other components

- **Terraform Caller**
- **AWS**

## Connections

- Terraform Caller → Module Inputs: provides configuration (evidence: `README.md`)
- Module Inputs → ALB Module: configures (evidence: `README.md`)
- ALB Module → Load Balancer: creates (evidence: `README.md`)
- ALB Module → HTTP and HTTPS Listeners: creates (evidence: `README.md`)
- ALB Module → Default Target Group: creates (evidence: `README.md`)
- ALB Module → Security Group Rules: creates (evidence: `README.md`)
- ALB Module → Access Log Storage: configures optionally (evidence: `README.md`)
- ALB Module → Module Outputs: exposes (evidence: `README.md`)
- ALB Module → AWS: provisions resources (evidence: `README.md`)
