# camunda/camunda-tf-eks-module architecture

> Architecture diagram of the GitHub repository camunda/camunda-tf-eks-module, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/camunda/camunda-tf-eks-module
- Repository: https://github.com/camunda/camunda-tf-eks-module

## Overview

##### Main Components

a. Core Infrastructure Components:
- AWS EKS Cluster (Primary Component)
- Aurora PostgreSQL Database Cluster
- OpenSearch Domain
- VPC and Networking Infrastructure

b. Security and Authentication:
- IRSA (IAM Roles for Service Accounts)
- IAM Roles and Policies
- OIDC Provider

c. Supporting Components:
- Kubernetes Resources (ServiceAccounts, StorageClasses)
- GitHub Actions Automation

**┌─ AWS Cloud ──────────────────────────────────────────────┐**
- ┌─ VPC ───────────────────────────────────────────────┐  │
- ┌─ Private Subnets ─────┐  ┌─ Public Subnets ────┐  │  │

- ┌─ EKS Cluster ───┐  │  │                      │  │  │
- Node Groups   │  │  │                      │  │  │
- OIDC Provider │  │  │                      │  │  │
- ┘  │  │                      │  │  │

- ┌─ Aurora RDS ────┐  │  │                      │  │  │
- PostgreSQL    │  │  │                      │  │  │
- ┘  │  │                      │  │  │

- ┌─ OpenSearch ────┐  │  │                      │  │  │
- Domain        │  │  │                      │  │  │
- ┘  │  │                      │  │  │
- ┘  └──────────────────────┘  │  │
- ┘  │
- ┘

##### Important Details

a. Network Configuration:
- CIDR blocks (10.190.0.0/16 for service IPv4)
- VPC subnets configuration
- Security group relationships

b. IAM/Security:
- IRSA role connections
- Trust relationships between components
- Service account annotations

c. Component Specifications:
- Aurora configuration
- OpenSearch domain settings
- EKS cluster specifications

##### Additional Sections

- GitHub Actions workflow
- Terraform module relationships
- Security group rules and access patterns

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph AWS["AWS Cloud"]
        subgraph VPC["Virtual Private Cloud"]
            subgraph PrivateSubnets["Private Subnets"]
                EKSCluster["EKS Cluster"]:::eks
                Aurora["Aurora PostgreSQL"]:::db
                OpenSearch["OpenSearch Domain"]:::search
                NodeGroups["Node Groups"]:::eks
            end

            subgraph PublicSubnets["Public Subnets"]
                OIDC["OIDC Provider"]:::security
            end
        end

        subgraph IAM["IAM & Security"]
            IAMRoles["IAM Roles"]:::security
            IAMPolicies["IAM Policies"]:::security
            SecurityGroups["Security Groups"]:::security
            IRSA["IRSA"]:::security
        end
    end

    subgraph Testing["Testing Infrastructure"]
        EKSTest["EKS Tests"]:::test
        RDSTest["RDS Tests"]:::test
        OpenSearchTest["OpenSearch Tests"]:::test
    end

    subgraph CI["CI/CD"]
        GHActions["GitHub Actions"]:::cicd
        AuroraAction["Aurora Management"]:::cicd
        EKSAction["EKS Management"]:::cicd
        OpenSearchAction["OpenSearch Management"]:::cicd
    end

    subgraph Examples["Example Implementations"]
        Camunda87["Camunda 8.7 IRSA"]:::example
        Camunda86["Camunda 8.6 IRSA"]:::example
    end

    %% Relationships
    EKSCluster --> NodeGroups
    EKSCluster --> OIDC
    OIDC -.-> IRSA
    IRSA -.-> IAMRoles
    IAMRoles --> IAMPolicies
    SecurityGroups --> EKSCluster
    SecurityGroups --> Aurora
    SecurityGroups --> OpenSearch
    
    GHActions --> AuroraAction
    GHActions --> EKSAction
    GHActions --> OpenSearchAction
    
    EKSTest --> EKSCluster
    RDSTest --> Aurora
    OpenSearchTest --> OpenSearch

    %% Click Events
    click EKSCluster "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/eks-cluster/cluster.tf"
    click Aurora "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/aurora/main.tf"
    click OpenSearch "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/opensearch/main.tf"
    click VPC "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/eks-cluster/vpc.tf"
    click IAMRoles "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/eks-cluster/iam.tf"
    click IAMPolicies "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/eks-cluster/iam-policies.tf"
    click OIDC "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/eks-cluster/iam.tf"
    click SecurityGroups "https://github.com/camunda/camunda-tf-eks-module/blob/main/modules/eks-cluster/security.tf"
    click AuroraAction "https://github.com/camunda/camunda-tf-eks-module/tree/main/.github/actions/aurora-manage-cluster"
    click EKSAction "https://github.com/camunda/camunda-tf-eks-module/tree/main/.github/actions/eks-manage-cluster"
    click OpenSearchAction "https://github.com/camunda/camunda-tf-eks-module/tree/main/.github/actions/opensearch-manage-cluster"
    click EKSTest "https://github.com/camunda/camunda-tf-eks-module/blob/main/test/src/default_eks_test.go"
    click RDSTest "https://github.com/camunda/camunda-tf-eks-module/blob/main/test/src/custom_eks_rds_test.go"
    click OpenSearchTest "https://github.com/camunda/camunda-tf-eks-module/blob/main/test/src/custom_eks_opensearch_test.go"
    click Camunda87 "https://github.com/camunda/camunda-tf-eks-module/blob/main/examples/camunda-8.7-irsa"
    click Camunda86 "https://github.com/camunda/camunda-tf-eks-module/blob/main/examples/camunda-8.6-irsa"

    %% Styling
    classDef eks fill:#2496ED,color:white
    classDef db fill:#FF9900,color:white
    classDef search fill:#5B2F91,color:white
    classDef security fill:#FFD700,color:black
    classDef test fill:#87CEEB,color:black
    classDef cicd fill:#98FB98,color:black
    classDef example fill:#DDA0DD,color:black

    %% Legend
    subgraph Legend
        L1["EKS Components"]:::eks
        L2["Database"]:::db
        L3["Search Service"]:::search
        L4["Security"]:::security
        L5["Testing"]:::test
        L6["CI/CD"]:::cicd
        L7["Examples"]:::example
    end
```
