# larapruna/despliegueargocd architecture

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

- Interactive diagram: https://gitdiagram.com/larapruna/despliegueargocd
- Repository: https://github.com/larapruna/despliegueargocd

## Overview

Para representar con precisión la arquitectura de este proyecto de Despliegue Continuo en Kubernetes con GitOps y ArgoCD, sigue estos pasos:

##### Identificación del tipo de proyecto y propósito
- Es un repositorio de **Infraestructura como Código** orientado a GitOps.
- Su objetivo principal es gestionar la instalación, configuración y sincronización de aplicaciones en un clúster de Kubernetes usando ArgoCD, Helm, Sealed Secrets y webhooks (ngrok).

##### Análisis de la estructura de archivos
- apps/ : manifiestos *Application* de ArgoCD para app1, app2, app3 y un chart de Joomla.
- config/ : configuraciones de ArgoCD (ConfigMap, Ingress, secretos de webhook, repositorio interno del servidor).
- images/ : binario de kubeseal (herramienta de Bitnami Sealed Secrets).
- README.md : documentación detallada de flujos GitOps, instalación y configuración.

##### Insights clave del README
- Flujo de instalación de ArgoCD (manifiestos, Autopilot, Helm).
- Gestión de secrets con Sealed Secrets y kubeseal.
- Uso de webhooks de GitHub + ngrok para disparar reconciliaciones en ArgoCD.
- Soporte de Helm y charts externos (Bitnami, repositorios Git).

##### Componentes principales para el diagrama
a. Repositorios Git
- Repositorio principal (apps/, config/, helm-joomla.yaml).
- Repositorios externos: GitHub del código de las apps, repositorios de charts de Helm.
b. ArgoCD en Kubernetes
- Módulos dentro del clúster:
- argocd-server (API + UI)
- repo-server (pull de manifiestos)
- application-controller (reconciliación)
- notifications-controller, Dex, Redis
- Sealed-Secrets-Controller (Bitnami) para desencriptar en cluster.
c. Clúster de Kubernetes de destino
- API Server, etcd, nodos worker.
- Recursos desplegados: Deployments/StatefulSets de app1, app2, app3, joomla.
- Ingress/Service para argocd-server y aplicaciones.
d. Servicios y flujos externos
- GitHub webhooks → ngrok → argocd-server/api/webhook
- Registro de contenedores (Docker Registry) para imágenes de las apps.
- Helm Repos (charts.bitnami.com) consultados por ArgoCD.

##### Relaciones e interacciones
- Flechas desde el **Desarrollador** al **GitHub Repo** (push de código y manifiestos).
- GitHub Webhook invoca a argocd-server (vía ngrok en dev).
- argocd-repo-server hace pull automático o programado de apps/ y config/.
- application-controller aplica/manifesta cambios contra el API Server de Kubernetes.
- Sealed-Secrets-Controller transforma SealedSecret → Secret dentro del clúster.
- Helm charts externos referenciados y renderizados por argocd-server.

##### Principales patrones de arquitectura
- **GitOps**: Git como fuente única de la verdad.
- **Control Loop**: reconciliation loop de ArgoCD cada X segundos + webhook trigger.
- **Declarative Config**: manifiestos en apps/ y config/.
- **Sealed Secrets**: unidireccionalidad cifrado fuera del cluster.
- **Extensibilidad con Helm**: chart repositories y overrides en manifests.

##### Guía para el diagrama
- Usa **rectángulos** para componentes lógicos (ArgoCD, Sealed-Secrets, Kubernetes).
- **Cilindros** para almacenes (Git, Docker Registry).
- **Nubes** o iconos externos para servicios (GitHub, ngrok, Helm Repo).
- **Flechas dirigidas** que muestren:
- Push → Webhook → ArgoCD
- ArgoCD Pull → Kubernetes API
- kubeseal → Sealed-Secrets-Controller
- **Colores**:
- Azul = repositorios Git
- Verde = componentes en el clúster
- Amarillo = servicios externos (ngrok, Helm)
- Rojo = flujo de secretos

##### Consideraciones específicas al proyecto
- Detalla los ficheros de apps/ como “Applications” en ArgoCD.
- Muestra config/argocd-cm.yaml y config/service_argo-repo-server.yaml como parte de la capa de configuración.
- Indica el binario kubeseal (images/) invocado por desarrollador para generar SealedSecret.
- Incluye helm-joomla.yaml como ejemplo de Application de Helm.

Con este guion, el diagrama reflejará fielmente cómo los manifiestos, charts y secretos viajan desde Git hasta el clúster, cómo ArgoCD y Sealed Secrets aseguran la sincronización declarativa y cómo los webhooks + ngrok aceleran la entrega continua.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Developer and Git
    subgraph "Developer & Git"
        Dev["Developer"]:::external
        GitHubRepo[(GitHub Repo)]:::gitRepo
        README["README.md"]:::gitRepo
    end

    Dev -->|"push manifests & code"| GitHubRepo
    GitHubRepo -->|"documents workflows"| README

    %% Webhook Flow
    subgraph "Webhook Trigger"
        GitHubWebhook["GitHub Webhook"]:::external
        Ngrok["ngrok"]:::external
    end

    GitHubRepo -->|"Webhook event"| GitHubWebhook
    GitHubWebhook -->|"tunnel"| Ngrok

    %% ArgoCD Components
    subgraph "ArgoCD (K8s Cluster)" 
        direction TB
        ArgocdServer["argocd-server (API & UI)"]:::clusterComp
        ArgocdCM["argocd-cm.yaml"]:::clusterComp
        Ingress["Ingress"]:::clusterComp
        RepoService["repo-server Service"]:::clusterComp
        RepoServer["repo-server"]:::clusterComp
        AppController["application-controller"]:::clusterComp
        Notifications["notifications-controller"]:::clusterComp
        Dex["Dex"]:::clusterComp
        Redis["Redis"]:::clusterComp
    end

    Ngrok -->|"POST /api/webhook"| ArgocdServer
    ArgocdServer --> RepoServer
    RepoServer -->|"pull apps/ & config/"| GitHubRepo
    ArgocdServer --> AppController
    AppController -->|"reconcile loop"| K8sAPI

    %% Config mappings
    click ArgocdCM "https://github.com/larapruna/despliegueargocd/blob/main/config/argocd-cm.yaml"
    click Ingress "https://github.com/larapruna/despliegueargocd/blob/main/config/ingress.yaml"
    click RepoService "https://github.com/larapruna/despliegueargocd/blob/main/config/service_argo-repo-server.yaml"
    click README "https://github.com/larapruna/despliegueargocd/blob/main/README.md"

    %% Sealed Secrets Flow
    subgraph "Sealed Secrets"
        direction TB
        KubesealCLI["kubeseal CLI"]:::external
        SealedController["Sealed-Secrets-Controller"]:::clusterComp
        Secret["Secret"]:::clusterComp
    end

    Dev -->|"generate SealedSecret"| KubesealCLI
    KubesealCLI -->|"push SealedSecret"| GitHubRepo
    RepoServer -->|"apply SealedSecret"| SealedController
    SealedController -->|"decrypt"| Secret

    click KubesealCLI "https://github.com/larapruna/despliegueargocd/blob/main/images/kubeseal-0.17.5-linux-amd64.tar.gz"

    %% Applications in ArgoCD
    subgraph "ArgoCD Applications"
        direction TB
        App1["app1 Application"]:::clusterComp
        App2["app2 Application"]:::clusterComp
        App3["app3 Application"]:::clusterComp
        Joomla["helm-joomla Application"]:::clusterComp
    end

    RepoServer --> App1
    RepoServer --> App2
    RepoServer --> App3
    RepoServer --> Joomla

    click App1 "https://github.com/larapruna/despliegueargocd/blob/main/apps/app1.yaml"
    click App2 "https://github.com/larapruna/despliegueargocd/blob/main/apps/app2.yaml"
    click App3 "https://github.com/larapruna/despliegueargocd/blob/main/apps/app3.yaml"
    click Joomla "https://github.com/larapruna/despliegueargocd/blob/main/apps/helm-joomla.yaml"

    %% External Services
    subgraph "External Services"
        direction TB
        DockerRegistry[(Docker Registry)]:::external
        HelmRepo[(Helm Repository)]:::external
    end

    DockerRegistry -->|"container images"| K8sNodes
    HelmRepo -->|"charts"| ArgocdServer

    %% Kubernetes Cluster
    subgraph "Kubernetes Cluster"
        direction TB
        K8sAPI["API Server"]:::clusterComp
        Etcd["etcd"]:::clusterComp
        subgraph "Nodes & Workloads"
            direction TB
            K8sNodes["Worker Nodes"]:::clusterComp
            Deployments["Deployments/StatefulSets"]:::clusterComp
            IngressApps["Ingress/Services"]:::clusterComp
        end
    end

    K8sAPI --> Etcd
    AppController --> K8sAPI
    Deployments --> IngressApps
    K8sNodes --> Deployments

    %% Styles
    classDef gitRepo fill:#cbeafe,stroke:#0366d6;
    classDef clusterComp fill:#d1fae5,stroke:#065f46;
    classDef external fill:#fef3c7,stroke:#92400e;
    classDef secret fill:#fee2e2,stroke:#991b1b;
```
