# grasslandnetwork/big_node_aws architecture

> Architecture diagram of the GitHub repository grasslandnetwork/big_node_aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/grasslandnetwork/big_node_aws
- Repository: https://github.com/grasslandnetwork/big_node_aws

## Overview

##### Main Components

a) Development Environment Layer:
- Docker Container (Primary Development Environment)
- Local File System Mounts (~/.aws)
- Developer's Host Machine

b) Authentication Layer:
- AWS SSO Integration
- AWS CLI Configuration
- Authentication Token Management

c) AWS Service Integration Layer:
- AWS Services (S3, Lambda, SQS, API Gateway)
- AWS Control Tower
- AWS Administrator Access Role

- Developer Workspace  |  (Top Layer)

- Authentication &     |  (Middle Layer)
- Security            |

- AWS Infrastructure  |  (Bottom Layer)

##### Component Relationships

- Double lines (⇒) for data/resource access

##### Specific Elements

a) Developer Workspace Layer:
- Docker Container (show installed tools: AWS CLI, kubectl)
- Local .aws directory
- Makefile automation
- Documentation resources

b) Authentication Layer:
- AWS SSO configuration
- Token management
- Role-based access control
- SSO URL endpoints

c) AWS Infrastructure Layer:
- Administrative access scope
- Supported AWS services
- Regional configurations (ca-central-1)

##### Important Flows to Highlight

- Developer login flow
- AWS SSO authentication process
- Container initialization process
- AWS service access patterns

##### Technical Details to Emphasize

- Docker container isolation
- AWS profile configuration
- SSO integration points
- Tool chain relationships

Key Annotations to Include:
- Token expiration windows
- Required environment variables
- Mount points for persistent storage
- Authentication flow sequence numbers

Remember to include references to the documentation directory structure, as it contains important information about Control Tower, SSO, and general setup procedures that support the overall system architecture.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef container fill:#2496ed,color:white
    classDef auth fill:#90EE90,color:black
    classDef aws fill:#FF9900,color:black
    classDef local fill:#CCCCCC,color:black
    classDef docs fill:#87CEEB,color:black

    %% Developer Workspace Layer
    subgraph DevWorkspace
        Docker["Docker Container"]:::container
        LocalFS["Local File System<br/>~/.aws"]:::local
        DevMachine["Developer Machine"]:::local
        Makefile["Build & Deploy<br/>Automation"]:::container
    end

    %% Authentication Layer
    subgraph AuthLayer
        AWSSSO["AWS SSO<br/>Integration"]:::auth
        TokenMgmt["Token<br/>Management"]:::auth
        AWSConfig["AWS CLI<br/>Configuration"]:::auth
    end

    %% AWS Infrastructure Layer
    subgraph AWSInfra
        ControlTower["AWS Control<br/>Tower"]:::aws
        AdminRole["Administrator<br/>Access Role"]:::aws
        AWSServices["AWS Services<br/>(S3, Lambda, SQS)"]:::aws
    end

    %% Documentation Components
    subgraph Docs
        GeneralDocs["General<br/>Documentation"]:::docs
        SSODocs["SSO<br/>Documentation"]:::docs
        ArchDocs["Architecture<br/>Documentation"]:::docs
    end

    %% Relationships
    DevMachine --> Docker
    Docker --> LocalFS
    Docker --> AWSSSO
    AWSSSO --> TokenMgmt
    TokenMgmt --> AWSConfig
    AWSConfig --> AdminRole
    AdminRole --> AWSServices
    ControlTower --> AdminRole
    Docker --> Makefile

    %% Documentation Relationships
    GeneralDocs -.-> Docker
    SSODocs -.-> AWSSSO
    ArchDocs -.-> AWSInfra

    %% Click Events
    click Docker "https://github.com/grasslandnetwork/big_node_aws/tree/main/Dockerfile"
    click Makefile "https://github.com/grasslandnetwork/big_node_aws/tree/main/Makefile"
    click AWSSSO "https://github.com/grasslandnetwork/big_node_aws/blob/main/documentation/SSO/grassland-AWS-Environment-Access.md"
    click SSODocs "https://github.com/grasslandnetwork/big_node_aws/blob/main/documentation/SSO/grassland-SSO-User-Administration.md"
    click ControlTower "https://github.com/grasslandnetwork/big_node_aws/blob/main/documentation/ControlTower/controltower.md"
    click GeneralDocs "https://github.com/grasslandnetwork/big_node_aws/blob/main/documentation/general/grassland-tools-setup.md"
    click ArchDocs "https://github.com/grasslandnetwork/big_node_aws/tree/main/documentation/architecture"
    click AWSServices "https://github.com/grasslandnetwork/big_node_aws/blob/main/documentation/general/grassland-ec2-access.md"

    %% Legend
    subgraph Legend
        L1["Docker Components"]:::container
        L2["Authentication"]:::auth
        L3["AWS Services"]:::aws
        L4["Local System"]:::local
        L5["Documentation"]:::docs
    end
```
