# terraform-aws-modules/terraform-aws-rds-aurora architecture

> Architecture diagram of the GitHub repository terraform-aws-modules/terraform-aws-rds-aurora, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/terraform-aws-modules/terraform-aws-rds-aurora
- Repository: https://github.com/terraform-aws-modules/terraform-aws-rds-aurora

## Overview

##### Project type and purpose
- This is an open-source Terraform module whose sole purpose is to provision and manage AWS RDS Aurora clusters and related AWS resources (security groups, IAM roles, CloudWatch, autoscaling, global clusters, serverless, DSQL, etc.).
- The README confirms it supports features like autoscaling of read replicas, global clusters, serverless v1/v2, S3 imports, enhanced monitoring, DSQL peering, and Aurora Limitless.

##### File structure
- Top-level files: main.tf, variables.tf, outputs.tf define the root module’s resources, inputs, and outputs.
- `modules/dsql/` contains a nested module for DSQL multi-region peered clusters (its own main.tf, variables.tf, outputs.tf).
- `examples/…` directories show consumer usage patterns for each feature (autoscaling, global-cluster, multi-az, mysql, postgresql, s3-import, serverless, limitless, dsql).
- CI/CD and project metadata: .github/workflows, .pre-commit-config.yaml, CHANGELOG.md, UPGRADE-*.md, LICENSE.

##### README for additional insights
- The README enumerates supported features and provides HCL snippets for each use case.
- It lists all AWS resources created by the module (RDS cluster, cluster instances, endpoints, parameter groups, subnet groups, security groups, IAM roles, CloudWatch log groups, AppAutoScaling targets/policies, Secrets Manager rotation, shard groups, etc.).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Consumers
    subgraph "Consumers (Examples)" 
        direction TB
        GlobalExample["Global Cluster Example"]:::external
        Kinesis["Kinesis Data Stream Example"]:::external
        S3Import["S3 Import Example"]:::external
        Serverless["Serverless Example"]:::external
        Limitless["Limitless Example"]:::external
        DSQLExample["DSQL Multi-region Example"]:::external
    end

    %% Terraform Module
    subgraph "Terraform IaC Layer"
        direction TB
        RootModule["Terraform Root Module"]:::terraform
        AWSProvider["AWS Provider Configuration"]:::terraform
        subgraph "Nested Sub-module: DSQL" 
            direction TB
            DSQLModule["Terraform Sub-module \"dsql\""]:::module
        end
    end

    %% AWS Resources
    subgraph "AWS Resources" 
        direction TB
        subgraph "Networking" 
            direction TB
            DBSubnetGroup["aws_db_subnet_group.this"]:::aws_network
            SecurityGroup["aws_security_group.this"]:::aws_network
        end
        subgraph "Compute & Storage"
            direction TB
            RDSCluster["aws_rds_cluster.this"]:::aws_compute
            RDSInstances["aws_rds_cluster_instance.this"]:::aws_compute
        end
        subgraph "IAM"
            direction TB
            IAMRole["aws_iam_role.this"]:::aws_iam
        end
        subgraph "Monitoring"
            direction TB
            CloudWatch["CloudWatch Log Groups & Metrics"]:::aws_monitoring
        end
        subgraph "Autoscaling"
            direction TB
            AppAutoScaling["AppAutoScaling Targets & Policies"]:::aws_autoscaling
        end
        subgraph "Secrets Manager"
            direction TB
            SecretsManager["Secrets Manager Rotation"]:::aws_security
        end
    end

    %% External Services
    S3Bucket["AWS S3 Bucket"]:::aws_storage
    KinesisStream["AWS Kinesis Data Stream"]:::aws_stream

    %% CI/CD & Docs
    subgraph "CI/CD & Docs"
        direction TB
        CICD["CI/CD Workflows"]:::doc
        Precommit["Pre-commit Config"]:::doc
        Docs["Documentation & Metadata"]:::doc
    end

    %% Relationships
    GlobalExample -->|uses| RootModule
    Kinesis -->|uses| RootModule
    S3Import -->|uses| RootModule
    Serverless -->|uses| RootModule
    Limitless -->|uses| RootModule
    DSQLExample -->|uses| RootModule

    RootModule -->|configures| AWSProvider
    RootModule -->|provisions| DBSubnetGroup
    RootModule -->|provisions| SecurityGroup
    RootModule -->|provisions| RDSCluster
    RootModule -->|provisions| RDSInstances
    RootModule -->|provisions| IAMRole
    RootModule -->|provisions| CloudWatch
    RootModule -->|provisions| AppAutoScaling
    RootModule -->|provisions| SecretsManager
    RootModule -->|includes| DSQLModule

    AWSProvider --> DBSubnetGroup
    AWSProvider --> SecurityGroup
    AWSProvider --> RDSCluster
    AWSProvider --> RDSInstances
    AWSProvider --> IAMRole
    AWSProvider --> CloudWatch
    AWSProvider --> AppAutoScaling
    AWSProvider --> SecretsManager
    AWSProvider --> DSQLModule

    SecurityGroup -->|attached to| RDSCluster
    DBSubnetGroup -->|used by| RDSCluster
    RDSCluster -->|manages| RDSInstances
    RDSCluster -->|sends logs to| CloudWatch
    RDSInstances -->|monitored by| AppAutoScaling
    AppAutoScaling -->|scales| RDSInstances
    AppAutoScaling -->|reads metrics from| CloudWatch
    RDSInstances -->|uses| IAMRole
    SecretsManager -->|provides creds to| RDSCluster

    S3Bucket -->|import data to| RDSCluster
    KinesisStream -->|activity stream to| CloudWatch

    DSQLModule -->|peers cluster with| RDSCluster

    CICD -->|manages| RootModule
    Precommit -->|validates| RootModule
    Docs -->|describes| RootModule

    %% Click Events
    click RootModule "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click AWSProvider "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/versions.tf"
    click DSQLModule "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/modules/dsql/main.tf"
    click DBSubnetGroup "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click SecurityGroup "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click RDSCluster "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click RDSInstances "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click IAMRole "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click CloudWatch "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click AppAutoScaling "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click SecretsManager "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/main.tf"
    click GlobalExample "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/examples/global-cluster/main.tf"
    click Kinesis "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/examples/multi-az/main.tf"
    click S3Import "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/examples/s3-import/main.tf"
    click Serverless "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/examples/serverless/main.tf"
    click Limitless "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/examples/limitless/main.tf"
    click DSQLExample "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/examples/dsql/main.tf"
    click CICD "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/tree/master/.github/workflows/"
    click Precommit "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/.pre-commit-config.yaml"
    click Docs "https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/blob/master/README.md"

    %% Styles
    classDef terraform fill:#D6E9F8,stroke:#2B70C9,color:#073763;
    classDef module fill:#FADADD,stroke:#D46A6A,color:#8B0000;
    classDef aws_network fill:#CAF7E3,stroke:#2E8B57,color:#2E8B57;
    classDef aws_compute fill:#D5F5E3,stroke:#239B56,color:#239B56;
    classDef aws_iam fill:#E8DAEF,stroke:#7D3C98,color:#512E5F;
    classDef aws_monitoring fill:#FEF9E7,stroke:#B7950B,color:#7D6608;
    classDef aws_autoscaling fill:#E8F8F5,stroke:#1ABC9C,color:#117A65;
    classDef aws_security fill:#FDEDEC,stroke:#CB4335,color:#922B21;
    classDef aws_storage fill:#FCF3CF,stroke:#B9770E,color:#7D6608;
    classDef aws_stream fill:#EBDEF0,stroke:#8E44AD,color:#6C3483;
    classDef external fill:#F4F6F6,stroke:#ABB2B9,color:#424949,stroke-dasharray: 5 5;
    classDef doc fill:#F0F3F4,stroke:#566573,color:#2C3E50,stroke-dasharray: 2 2;
```
