convoy
Visualizador en tiempo real de pipelines GitHub Actions para organizaciones, auto-alojado. Utiliza webhooks y una GitHub App propia para mostrar despliegues y CI sin polling costoso.
Ficha actualizada 22 sept 2026, 17:14 · upstream 22 sept 2026, 15:30 · release sin release detectada
Qué es convoy
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Convoy es un visualizador auto-alojado diseñado para monitorizar los flujos de trabajo (workflows) de GitHub Actions a nivel de organización completa en una sola pantalla. A diferencia de las soluciones que dependen del polling, Convoy utiliza webhooks entregados directamente por GitHub, lo que permite escalar a cientos de repositorios sin saturar la API de GitHub.
La aplicación se basa en Next.js y Node.js, instalando una GitHub App con permisos de lectura para consumir datos de ejecución. Ofrece tres vistas principales: 'Deploys' (activadas por tags o releases), 'Pipelines' (todo el resto del tráfico CI) y 'Overview' (resumen gráfico de salud). Cada instancia es independiente, requiriendo su propia GitHub App y credenciales.
El despliegue puede realizarse mediante Docker en un VPS pequeño o localmente con Kubernetes. Se recomienda configurar un proxy inverso con TLS para producción y gestionar las claves privadas del App de forma segura fuera del entorno de ejecución.
- Monitorización en tiempo real de despliegues a producción (tags/releases) sin abrir múltiples pestañas.
- Auditoría visual de la actividad CI/CD de toda una organización o cuenta personal.
- Detección rápida de fallos en pipelines mediante el gráfico de estado 'Overview'.
- Visualización de métricas de ejecución de workflows sin necesidad de instalar agentes.
- Arquitectura basada en webhooks nativos de GitHub, evitando latencia y límites de API del polling.
- Instancias completamente independientes con credenciales propias por organización o usuario.
- Interfaz unificada que clasifica automáticamente despliegues vs. CI normal.
- Compatibilidad con Docker y Kubernetes para despliegue flexible en infraestructuras existentes.
- Requiere la creación y gestión manual de una GitHub App con permisos específicos (Read-only Actions).
- Configuración inicial compleja: generación de claves privadas y configuración de webhooks.
- En desarrollo local, depende por defecto de servicios externos como Smee.io para recibir webhooks.
- No incluye autenticación por defecto; requiere configurar CONVOY_API_KEY para acceso restringido.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para producción, utilice un VPS con Docker o Kubernetes. Configure un proxy inverso (ej. Caddy) con TLS y redirija los webhooks a la URL del servidor. No use Smee.io en entornos productivos permanentes. Asegure las variables de entorno APP_ID, WEBHOOK_SECRET y PRIVATE_KEY_PATH. Para acceso seguro, active CONVOY_API_KEY.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.