Eventos de GitLab

Todos los eventos de GitLab se publican en un tópico de Pub/Sub:

projects/sp-te-engplat-prod-cce9/topics/andes-gitlab-events

Eventos disponibles

Los siguientes eventos de GitLab están disponibles en el tópico Pub/Sub:

Eventos de código y repositorio

• Push events - Cuando se hace push de código al repositorio (todas las ramas)
• Tag push events - Cuando se crea una nueva etiqueta
• Wiki page events - Cuando se crea o actualiza una página de wiki

Eventos de desarrollo

• Issue events - Cuando se crea, actualiza, cierra o reabre un issue
• Confidential issue events - Eventos de issues confidenciales
• Merge request events - Cuando se crea, actualiza o hace merge de un MR
• Comments - Comentarios en issues o merge requests
• Confidential comments - Comentarios en issues confidenciales

Eventos de CI/CD

• Pipeline events - Cuando cambia el estado de un pipeline
• Job events - Cuando cambia el estado de un job
• Deployment events - Cuando inicia, termina, falla o se cancela un deployment

Eventos de gestión

• Project events - Cuando se crea o elimina un proyecto
• Subgroup events - Cuando se crea o elimina un subgrupo
• Member events - Cuando se crea, actualiza o elimina un miembro del grupo
• Milestone events - Cuando se crea, cierra, reabre o elimina un milestone

Eventos de seguridad y calidad

• Vulnerability events - Cuando se crea o actualiza una vulnerabilidad
• Project or group access token events - Eventos de tokens de acceso
• Feature flag events - Cuando se activa o desactiva una feature flag

Eventos adicionales

• Releases events - Cuando se crea, actualiza o elimina un release
• Emoji events - Cuando se otorga o revoca un emoji

Estructura de los eventos

Los eventos de GitLab siguen una estructura específica que contiene información detallada sobre cada tipo de evento. Para conocer la estructura completa y los campos disponibles para cada tipo de evento, consulta la documentación oficial de GitLab:

📖 Webhook Events - GitLab Documentation

Cómo consumir los eventos

Para que los equipos necesiten consumir los eventos de GitLab desde el tópico Pub/Sub, deben seguir el siguiente proceso:

Proceso de solicitud

1. Crear un ticket utilizando el ANDES Bot opción 8.0

2. Información requerida en el ticket:

   • Cuenta de servicio del suscriptor: Proporcionar la cuenta de servicio para asignarle los roles necesarios.
   • Dominio: Dominio al que pertenece el solicitante.
   • Dueño de la integración: Nombre y Correo Electrónico.
   • Equipo mantenedor de la integración: Nombre y Correo Electrónico.
   • Motivo de la solicitud: Razón o circunstancia por la que requiere acceso a los eventos.
   • Tipos de eventos específicos (opcional): Si solo necesitan consumir ciertos tipos de eventos, especificar cuáles de la lista anterior.
   • Nombre de la suscripción: Nombre de la nueva suscripción a crear, para ello debe cumplir con las siguientes reglas:
     • Tener entre 1 y 63 caracteres - Nomenclarura: <tipo-de-recurso>-<ambiente>-<producto/aplicación>-[función]-<correlativo>
       • Ej. sub-prod-gitlab-reporter-01