De qué trata esta publicación

  • Construyendo un pipeline de implementación de Zammad totalmente automatizado
  • La arquitectura detrás de la configuración
  • Beneficios en el mundo real: consistencia y fiabilidad
  • Replicando la configuración en tu propia infraestructura

El caso a favor de un pipeline de CI/CD

En los entornos de TI modernos, la velocidad y la fiabilidad van de la mano. Ya sea un equipo pequeño gestionando herramientas internas o una gran operación de soporte manejando miles de tickets, una cosa es constante: los sistemas deben mantenerse en línea, seguros y actualizados. Sin embargo, las implementaciones manuales a menudo se interponen en el camino. Cada actualización requiere iniciar sesión, descargar cambios, reiniciar contenedores y esperar un arranque limpio. Es un proceso que no solo consume mucho tiempo, sino que también es propenso a errores y difícil de escalar.

Ahí es donde entra la automatización. Un pipeline de CI/CD bien diseñado elimina los pasos repetitivos, reduce el error humano y ofrece actualizaciones consistentes. Combinado con la monitorización en vivo, proporciona una visibilidad completa de tu infraestructura, para que puedas detectar y resolver problemas antes de que afecten a los usuarios.

Para los equipos que usan Zammad, este enfoque significa menos sobrecarga de mantenimiento y mayor confianza en cada lanzamiento. Para ver cómo se ve esto en la práctica, creé una configuración completa de CI/CD y monitorización en torno a Zammad.

Cómo la arquitectura de Zammad hace esto posible

La arquitectura moderna y abierta de Zammad, con soporte nativo para implementaciones de Docker y servicios modulares como PostgreSQL, Redis, Elasticsearch y NGINX, combinada con una robusta REST API, crea una base natural para los flujos de trabajo de DevOps.


Los mismos principios que hacen que Zammad sea fácil de extender también hacen que sea fácil de automatizar. Desde el momento en que comencé a construir el pipeline de CI/CD, sentí que Zammad estaba diseñado para este tipo de integración.

La arquitectura de dos capas

La configuración se construye en torno a dos pilas complementarias que trabajan de la mano: una que ejecuta la propia aplicación y otra que proporciona una visibilidad operativa completa.

Automatización del esquema de despliegue de Zammad

1. Pila de Zammad (La capa de aplicación)

Esta pila contiene todos los servicios críticos para el funcionamiento diario de Zammad. Todo aquí trabaja en conjunto para procesar tickets, gestionar la comunicación y administrar datos.

Zammad (WebApp + Scheduler + WebSocket): La aplicación central, que maneja la interfaz de usuario, los trabajos en segundo plano y la comunicación en tiempo real.

PostgreSQL (Base de datos): La única fuente de verdad para todos los datos de tickets, usuarios y configuración.

Redis (Caché)
: Proporciona almacenamiento en caché de alta velocidad y es esencial para gestionar los datos de sesión y las colas de trabajos transitorios.

Elasticsearch (Indexación): Impulsa las capacidades de búsqueda de texto completo rápidas y exhaustivas de Zammad.

NGINX (Proxy inverso): Gestiona el tráfico público seguro y enruta las solicitudes a los servicios web correctos de Zammad.

2. Pila de monitorización (La capa de operaciones)

Esta pila está dedicada por completo a la observabilidad. Recopila, procesa y visualiza continuamente métricas del servidor host, el entorno de Docker y la capa de aplicación de Zammad.

Prometheus (Recopilación de métricas): Extrae continuamente métricas del sistema y de los contenedores.

Grafana (Paneles visuales): Transforma los datos en bruto de Prometheus en paneles de control procesables en tiempo real, brindando visibilidad instantánea del estado del sistema.

node_exporter (Métricas del host): Recopila métricas a nivel del host desde el propio servidor (uso de disco, carga del sistema, actividad de red).

cAdvisor (Métricas de contenedores Docker): Captura métricas específicas de contenedores, proporcionando una visibilidad granular de cómo cada servicio consume recursos.

Ambas pilas están definidas en archivos Docker Compose, lo que facilita la replicación o migración del entorno entre configuraciones locales, entornos de preproducción (staging) y producción. Esta consistencia elimina el clásico problema de "funciona en mi máquina".

El ciclo de automatización: Así es como funciona

La magia ocurre con unas pocas líneas en un flujo de trabajo de GitHub Actions:

Flujo de despliegue CI/CD mediante Github Actions

1. Un push a GitHub activa un flujo de trabajo de GitHub Actions.
2. El flujo de trabajo se conecta de forma segura al VPS utilizando claves SSH almacenadas como secretos.
3. Una vez conectado, ejecuta un conjunto de comandos simples y limpios:

git pull origin main
docker compose -f docker-compose.yml -f monitoring/docker-compose.monitoring.yml pull
docker compose -f docker-compose.yml -f monitoring/docker-compose.monitoring.yml up -d

4. Inmediatamente, Prometheus comienza a recopilar métricas de los contenedores en ejecución.
5. Grafana proporciona una visualización instantánea de todo, desde el estado de los contenedores hasta el uso de CPU, memoria y red.

Resultados: Fiabilidad y tranquilidad

En los entornos de producción, la automatización se trata de consistencia y fiabilidad. Al reemplazar los pasos manuales con un pipeline de CI/CD, eliminamos el error humano y aprovechamos la arquitectura de Zammad para obtener ventajas operativas significativas:

  • Actualizaciones casi sin tiempo de inactividad: Al aprovechar Docker Compose, el sistema puede descargar e iniciar nuevos contenedores antes de detener los antiguos, lo que permite que las actualizaciones se implementen de manera segura y rápida, minimizando drásticamente la interrupción para los agentes.

  • Implementaciones 100% repetibles: El proceso de implementación se define completamente en código (Docker Compose y GitHub Actions), garantizando que Zammad se configure e implemente exactamente de la misma manera, en todo momento, en los entornos de desarrollo, preproducción y producción.

  • Tiempo de valorización acelerado: Las pequeñas actualizaciones o correcciones de errores urgentes pueden implementarse en cuestión de minutos después de realizar un push a GitHub. Esta alta velocidad asegura que los usuarios reciban funciones más rápido y los problemas críticos se parcheen de inmediato.

  • Observabilidad completa del sistema: La integración de Prometheus y Grafana transforma el mantenimiento de una tarea reactiva a una proactiva.

  • Tiempo de resolución de problemas reducido: Cuando ocurre un problema, Grafana proporciona el contexto histórico completo de las métricas del sistema, lo que permite correlacionar una caída repentina en el rendimiento con una implementación específica o un aumento en la carga de usuarios.

Posibles próximos pasos para subir de nivel

¡La belleza de una arquitectura abierta y moderna es que el viaje hacia la optimización nunca termina! Ahora que tenemos un entorno totalmente automatizado y observable, aquí están los próximos pasos estratégicos para llevar la operación de Zammad al siguiente nivel:

-> Añadir alertas: Integra Prometheus o Grafana con un canal de Slack para recibir notificaciones instantáneas sobre incidentes críticos del sistema.

-> Expandir las métricas de Zammad: Ve más allá de la salud del sistema. Usa la API de Zammad para rastrear datos comerciales específicos como la tasa de creación de tickets, los tiempos de respuesta promedio y la carga de usuarios simultáneos para obtener información más profunda.

-> Habilitar reversiones automatizadas (Rollbacks): Añade lógica de reversión al flujo de trabajo de GitHub Actions para volver automáticamente a la imagen de contenedor estable anterior si una nueva implementación no supera sus verificaciones de estado.

-> Escalar horizontalmente: El objetivo final. Mueve la configuración de un único VPS a un clúster de Kubernetes para lograr una verdadera alta disponibilidad.

¡Vale la pena intentarlo!

Puedes explorar el repositorio completo del proyecto y configurar este pipeline en tu propio servidor. Incluye los archivos Docker Compose, la configuración de Prometheus y el flujo de trabajo de GitHub Actions que necesitas para empezar.

Echa un vistazo aquí al proyecto completo sobre cómo autodesplegar Zammad

Sobre el autor

Michael Amponsah es Ingeniero de Sistemas y Cloud con experiencia práctica en infraestructura de TI, automatización y monitorización. Apasionado por las tecnologías de código abierto, disfruta construyendo soluciones del mundo real que integran rendimiento, seguridad y escalabilidad. Michael explora constantemente nuevas formas de simplificar operaciones complejas a través del aprendizaje y la colaboración.

Si deseas conectar o seguir su trabajo, visita su perfil de LinkedIn en: https://www.linkedin.com/in/michael-a-4b98329a