How larapruna/despliegueargocd works
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.