# didactiklabs/fluxy architecture

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

- Interactive diagram: https://gitdiagram.com/didactiklabs/fluxy
- Repository: https://github.com/didactiklabs/fluxy

## Overview

##### Connection Flows

- GitOps deployment flows (FluxCD)
- Network traffic flows
- Authentication flows
- Monitoring/metrics collection
- Backup processes

##### Component Grouping

- Security Group: Vault, Authentik, cert-manager
- Monitoring Group: Prometheus, Grafana, AlertManager
- Storage Group: TopoLVM, CloudNativePG
- Application Group: Various applications

##### Metadata

A metadata section showing:
- Version information
- Environment context
- Dependencies
- Configuration management tools (Nix, Terraform)

##### Implementation Details

- Use standardized Kubernetes iconography
- Clear separation between namespaces
- High-availability configurations
- Stateful vs stateless components
- Security boundaries and network policies

Remember to emphasize the GitOps-centric nature of the platform, showing how FluxCD manages the deployment and reconciliation of all components from the gitops/ directory structure.

This system design should help viewers understand both the overall architecture and the specific interactions between components in this sophisticated Kubernetes platform.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Application Layer"
        Apps["Applications"]
        Immich["Immich"]:::app
        Plex["Plex"]:::app
        Vaultwarden["Vaultwarden"]:::app
        
        subgraph "Gateway & DNS"
            Contour["Contour Ingress"]:::network
            IstioGW["Istio Gateway"]:::network
            PowerDNS["PowerDNS"]:::network
            ExtDNS["External DNS"]:::network
        end
    end

    subgraph "Platform Services Layer"
        subgraph "Security Services"
            Vault["Vault"]:::security
            Authentik["Authentik"]:::security
            CertManager["Cert Manager"]:::security
        end

        subgraph "Monitoring Stack"
            Prometheus["Prometheus"]:::monitoring
            Grafana["Grafana"]:::monitoring
            AlertManager["AlertManager"]:::monitoring
        end

        subgraph "Data Services"
            CNPG["CloudNativePG"]:::database
            Velero["Velero Backup"]:::database
        end
    end

    subgraph "Core Infrastructure Layer"
        K8s["Kubernetes"]:::core
        Cilium["Cilium Network"]:::network
        TopoLVM["TopoLVM CSI"]:::storage
        ClusterAPI["Cluster API"]:::core
        Kamaji["Kamaji Control Plane"]:::core
        FluxCD["FluxCD GitOps"]:::core
    end

    %% Connections
    FluxCD --> Apps
    FluxCD --> Vault
    FluxCD --> Authentik
    FluxCD --> CertManager
    FluxCD --> Prometheus
    FluxCD --> CNPG
    FluxCD --> Velero
    
    Apps --> Immich
    Apps --> Plex
    Apps --> Vaultwarden
    
    Contour --> K8s
    IstioGW --> K8s
    PowerDNS --> ExtDNS
    ExtDNS --> K8s
    
    Prometheus --> AlertManager
    Prometheus --> Grafana
    
    K8s --> Cilium
    K8s --> TopoLVM
    K8s --> ClusterAPI
    Kamaji --> K8s

    %% Styles
    classDef core fill:#1E88E5,color:white
    classDef security fill:#4CAF50,color:white
    classDef monitoring fill:#FF9800,color:white
    classDef app fill:#9C27B0,color:white
    classDef database fill:#757575,color:white
    classDef storage fill:#757575,color:white
    classDef network fill:#00BCD4,color:white

    %% Click Events
    click Cilium "https://github.com/didactiklabs/fluxy/tree/main/bootstrap/cilium/"
    click TopoLVM "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/topolvm-csi/"
    click ClusterAPI "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/cluster-api/"
    click Vault "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/vault/"
    click Authentik "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/authentik/"
    click CertManager "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/cert-manager/"
    click Prometheus "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/monitoring/"
    click CNPG "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/cnpg/"
    click Velero "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/velero/"
    click Immich "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/immich/"
    click Plex "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/plex-route/"
    click Vaultwarden "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/vaultwarden/"
    click Contour "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/ingress-controller/"
    click IstioGW "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/istio-gateway-api/"
    click PowerDNS "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/powerdns/"
    click ExtDNS "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/external-dns/"
    click FluxCD "https://github.com/didactiklabs/fluxy/tree/main/bootstrap/fluxcd/"
    click Kamaji "https://github.com/didactiklabs/fluxy/tree/main/gitops/apps/kamaji/"
```
