# iesgrancapitan-proyectos/202021asir-junio-clustermariadb architecture

> Architecture diagram of the GitHub repository iesgrancapitan-proyectos/202021asir-junio-clustermariadb, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb
- Repository: https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb

## Overview

##### Proyecto – Tipo y propósito
Este es un proyecto de infraestructura de contenedores para montar un clúster de MariaDB-Galera en Kubernetes, con cifrado de comunicaciones y cifrado a nivel de datos, y una instancia de WordPress como cliente de prueba.

##### Análisis de la estructura
- No hay código de aplicación ni carpetas de “frontend” o “backend”: todo gira en torno al despliegue con Kubernetes/Helm.
- Se usan charts de Bitnami para:
- mariadb-galera (3 nodos)
- wordpress + apache
- Se actualiza la configuración vía `helm upgrade` para añadir certificados (Secrets) y fichero YAML de configuración (file_key_management).

##### Componentes principales
a. Kubernetes Cluster
– Control Plane (API Server, Scheduler, Controller Manager)
– Worker Nodes (docker runtime, kubelet)
b. Helm
– Cliente CLI para desplegar/actualizar charts
c. Pods y Services
– 3× Pod MariaDB-Galera + Service ClusterIP
– 1× Pod WordPress-Apache + Service LoadBalancer/NodePort
d. Secrets & ConfigMaps
– Certificados TLS para cifrar tráfico intra-clúster
– YAML con plugin file_key_management
e. Clientes externos
– Navegador web (WordPress UI)
– mysql client (kubectl run / mariadb client remoto)

##### Relaciones e interacciones
- WordPress → Service MariaDB-Galera → Pods MariaDB
- Pods MariaDB ↔ Pods MariaDB (replicación Galera, cifrada TLS)
- Helm CLI → Kubernetes API (deploy & upgrade)
- Administrator (kubectl) → Kubernetes API → exec/run client

##### Patrón arquitectónico
– Microservicios lógicos: DB cluster + aplicación web.
– Alta disponibilidad y recuperación automática proporcionada por Kubernetes.
– Infraestructura inmutable (Declarative config con Helm + YAML).

##### Guía para trazar el diagrama
– Plano de control Kubernetes
– Capa de worker nodes (Pods + Services)
– Entorno externo (Browsers, CLI)
– Herramientas de despliegue (Helm)
b. Flechas direccionales:
– Flujo de despliegue (Helm → K8s API)
– Flujo de datos (WordPress → MariaDB → Galera peers)
– Accesos admin (kubectl → Pods / Secrets)
– Cilindros para bases de datos
– Rectángulos con esquinas redondeadas para pods
– Octágonos para control plane
d. Etiquetas claras:
– “mariadb-galera-0…2”, “wordpress-0”
– Services: “svc-mariadb-galera”, “svc-wordpress”
– Secrets: “tls-galera”, “file-key-config”

##### Recomendaciones finales
- Ajusta el nivel de detalle según audiencia (gestores vs. DevOps vs. Infra).
- Incluye notas sobre volúmenes persistentes (PVC) si aplica.
- Documenta nombres de charts y versiones de Bitnami.
- Utiliza leyenda para explicar colores y formas.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Kubernetes Control Plane
  subgraph "Kubernetes Control Plane"
    API(["API Server"]):::control
    Sched(["Scheduler"]):::control
    CtrlMgr(["Controller Manager"]):::control
  end

  %% Worker Nodes
  subgraph "Worker Nodes"
    direction TB
    subgraph Node1
      PodDB0(["mariadb-galera-0"]):::dbpod
    end
    subgraph Node2
      PodDB1(["mariadb-galera-1"]):::dbpod
    end
    subgraph Node3
      PodDB2(["mariadb-galera-2"]):::dbpod
    end
    subgraph Node4
      PodWP(["wordpress-0"]):::webpod
    end
  end

  %% Services
  subgraph "Services"
    SvcDB(["/svc-mariadb-galera/"]):::service
    SvcWP(["/svc-wordpress/"]):::service
  end

  %% External Clients & Tools
  subgraph "External Clients & Tools"
    Browser(["Web Browser"]):::client
    CLI(["mysql client / kubectl exec"]):::client
    HelmCLI(["Helm CLI"]):::tool
  end

  %% Documentation
  subgraph "Documentation"
    Doc1(["README.md"]):::doc
    Doc2(["Kubernetes en ubuntu 2004.md"]):::doc
    Doc3(["Anteproyecto_IESGranCapitan.odt"]):::doc
    Doc4([".github/"]):::doc
    Doc5(["presentacion.txt"]):::doc
    Doc6(["eventos.ods"]):::doc
  end

  %% Edges: Deployment and data flows
  HelmCLI -->|"helm install/upgrade"| API
  SvcDB --> PodDB0
  SvcDB --> PodDB1
  SvcDB --> PodDB2
  SvcWP --> PodWP
  PodDB0 <-->|"galera TLS"| PodDB1
  PodDB1 <-->|"galera TLS"| PodDB2
  PodDB2 <-->|"galera TLS"| PodDB0
  PodWP -->|"TCP:3306 TLS"| SvcDB
  Browser -->|"HTTP/HTTPS"| SvcWP
  CLI -->|"TCP:3306"| SvcDB
  CLI -->|"exec into pods"| API

  %% Click events for documentation
  click Doc1 "https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb/blob/main/README.md"
  click Doc2 "https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb/blob/main/Kubernetes en ubuntu 2004.md"
  click Doc3 "https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb/blob/main/Anteproyecto_IESGranCapitan.odt"
  click Doc4 "https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb/tree/main/.github/"
  click Doc5 "https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb/blob/main/presentacion.txt"
  click Doc6 "https://github.com/iesgrancapitan-proyectos/202021asir-junio-clustermariadb/blob/main/eventos.ods"

  %% Styles
  classDef control fill:#AED6F1,stroke:#2980B9;
  classDef dbpod fill:#D5F5E3,stroke:#27AE60;
  classDef webpod fill:#FAD7A0,stroke:#D68910;
  classDef service fill:#AED6F1,stroke:#2980B9;
  classDef client fill:#FAD7A0,stroke:#D68910;
  classDef tool fill:#AED6F1,stroke:#2980B9;
  classDef doc fill:#EAECEE,stroke:#2D3436;
```
