# oskarvid/terra-ble architecture

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

- Interactive diagram: https://gitdiagram.com/oskarvid/terra-ble
- Repository: https://github.com/oskarvid/terra-ble

## Overview

Key Components to Include:

##### Main System Components
- Terraform Infrastructure Layer
- Ansible Configuration Layer
- Target Infrastructure (Cloud/Local)

##### Component Organization

A. Terraform Section:
- Main Configuration (main.tf)
- Provider Configuration (providers.tf)

B. Ansible Section:
- Core Playbook (main.yml)
- Specialized Playbooks:
- Basic Configuration
- Disk Management
- Docker Setup
- Ansible Installation
- Cloud configuration integration (clouds.yml)

**[Infrastructure Definition Layer]**

- Terraform Components
- Provider Configuration
- Infrastructure Specs

- Ansible Components
- Main Playbook
- Specialized Playbooks
- Basic Config
- Disk Management
- Docker Setup
- Ansible Installation

##### Labels
- Clear component names
- File paths where relevant
- Brief descriptions of component purposes

##### Modular nature
- How main.yml imports other playbooks
- Optional/modular components

##### Infrastructure Flow
- Demonstrate the sequence:
1. Terraform provisioning
2. Ansible configuration
3. Target system state

##### Configuration Management
- How clouds.yml template integrates
- Local vs. remote execution paths

##### Modularity
- Use grouped containers to show related components
- Optional/required components

Level of Detail:

- Keep high-level architecture visible
- Major component relationships
- File names for key configuration files
- Execution flow and dependencies
- Abstract implementation details unless crucial

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Infrastructure_Definition_Layer
        subgraph Terraform_Management
            TM["Main Configuration"]:::terraform
            TP["Provider Configuration"]:::terraform
            TM --> TP
        end

        subgraph Ansible_Configuration
            AC["Core Playbook"]:::ansible
            
            subgraph Specialized_Playbooks
                BC["Basic Configuration"]:::ansible
                DM["Disk Management"]:::ansible
                DS["Docker Setup"]:::ansible
                AI["Ansible Installation"]:::ansible
            end
            
            CC[("Cloud Configuration")]:::config
            
            AC --> BC
            AC --> DM
            AC --> DS
            AC --> AI
            AC -.-> CC
        end
        
        Terraform_Management -- "Provisions" --> Target[("Target Infrastructure")]:::infra
        Ansible_Configuration -- "Configures" --> Target
    end
    
    %% Click events for component mapping
    click TM "https://github.com/oskarvid/terra-ble/blob/master/terraform/main.tf"
    click TP "https://github.com/oskarvid/terra-ble/blob/master/terraform/providers.tf"
    click AC "https://github.com/oskarvid/terra-ble/blob/master/ansible/main.yml"
    click BC "https://github.com/oskarvid/terra-ble/blob/master/ansible/basic/basic.yml"
    click DM "https://github.com/oskarvid/terra-ble/blob/master/ansible/disks/disks.yml"
    click DS "https://github.com/oskarvid/terra-ble/blob/master/ansible/docker/docker.yml"
    click AI "https://github.com/oskarvid/terra-ble/blob/master/ansible/install-ansible/install-ansible.yml"
    click CC "https://github.com/oskarvid/terra-ble/blob/master/ansible/clouds.ymltemplate"
    
    %% Styling
    classDef terraform fill:#1565C0,stroke:#0D47A1,color:white
    classDef ansible fill:#2E7D32,stroke:#1B5E20,color:white
    classDef config fill:#FF8F00,stroke:#EF6C00,color:white
    classDef infra fill:#757575,stroke:#616161,color:white
    
    %% Legend
    subgraph Legend
        L1["Terraform Component"]:::terraform
        L2["Ansible Component"]:::ansible
        L3[("Configuration File")]:::config
        L4[("Infrastructure")]:::infra
    end
```
