DocumentaciónAyuda

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

  1. Entra a Configuración → Integraciones.

  2. En la tarjeta GitHub o GitLab, presiona Conectar.

  3. 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.

  4. 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

  1. En el repositorio, entra a Settings → Webhooks → Add webhook.

  2. En Payload URL, pega la URL. En Content type, elige application/json. En Secret, pega el secreto.

  3. En los eventos, marca Pushes y Pull requests.

  4. Guarda el webhook.

En GitLab

  1. En el proyecto, entra a Settings → Webhooks.

  2. En URL, pega la URL. En Secret token, pega el secreto.

  3. Marca Push events y Merge request events.

  4. 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-123 en el nombre de la rama, en un commit o en el título, el ítem APP-123 queda 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.

Relacionado

Buscar en Elion ITSM

Escribe al menos 2 letras para buscar en Elion ITSM.

↑↓ moverse · Enter abrir · Esc cerrar