Conectar GitHub o GitLab
Enlaza ramas, commits y pull o merge requests a los ítems de tus mesas ágiles, y mueve el ítem de estado al abrir el PR o al hacer merge.
En esta página
Con esta integración, cada rama, commit y pull request (GitHub) o merge request (GitLab) que menciona la clave de un ítem, por ejemplo APP-123, queda enlazado a ese ítem en tu mesa ágil. Opcionalmente, el ítem avanza solo de estado al abrir el PR o MR y al hacer merge.
Las tarjetas de GitHub y GitLab llevan la marca Propuesto: el diseño de esta integración todavía puede cambiar.
Antes de empezar
En Elion ITSM necesitas Administrar en el módulo Configuración (por ejemplo, el rol Administrador).
En GitHub o GitLab necesitas permiso para crear webhooks en el repositorio o proyecto.
Puedes crear una conexión por repositorio, o una sola y usar su URL en varios repositorios.
Paso 1: conectar en Elion ITSM
Entra a Configuración → Integraciones.
En la tarjeta GitHub o GitLab, presiona Conectar.
Completa:
Nombre: por ejemplo, el nombre del repositorio.
Mesas ágiles donde buscar los ítems (ninguna marcada = todas): marca las mesas cuyos ítems se pueden mencionar.
Reglas opcionales (solo avanzan el ítem):
Al abrir el PR, mover a (estado) (en GitLab, Al abrir el MR, mover a (estado)): viene
review.Al hacer merge, mover a (estado): viene
qa.
Escribe la clave del estado en minúsculas, como aparece en los ajustes de la mesa. Déjalo vacío para no mover el ítem.
Presiona Conectar.
Se abre una ventana que se muestra una sola vez, con la URL del webhook y el Secreto del webhook (en GitLab, Secret token). Usa Copiar URL y Copiar secreto. No la cierres hasta terminar el paso 2.
Paso 2: crear el webhook en el repositorio
En GitHub
En el repositorio, entra a Settings → Webhooks → Add webhook.
En Payload URL, pega la URL. En Content type, elige
application/json. En Secret, pega el secreto.En los eventos, marca Pushes y Pull requests.
Guarda el webhook.
En GitLab
En el proyecto, entra a Settings → Webhooks.
En URL, pega la URL. En Secret token, pega el secreto.
Marca Push events y Merge request events.
Guarda el webhook.
Vuelve a Elion ITSM y presiona Listo, ya lo copié.
Qué pasa después
Al hacer push o abrir un PR o MR que mencione
APP-123en el nombre de la rama, en un commit o en el título, el ítemAPP-123queda enlazado.Si definiste reglas, el ítem pasa al estado indicado al abrir el PR o MR y al hacer merge. Las reglas solo hacen avanzar el ítem.
La conexión muestra Último contacto con la fecha del último evento recibido.
Pide al equipo que nombre sus ramas con la clave del ítem, por ejemplo APP-123-login-con-google. Es la forma más simple de que todo quede enlazado.
Rotar la URL y el secreto
Si crees que la URL o el secreto se filtraron, presiona Rotar URL y secreto y confirma con Rotar. Los actuales dejan de funcionar al instante: pega los nuevos en el webhook del repositorio.