Vincular código de GitHub o GitLab a las tareas

Los desarrolladores pueden vincular su código a las tareas sin salir de GitHub o GitLab. Cuando un mensaje de commit, un nombre de rama o una pull request (una merge request en GitLab) menciona el número de una tarea, como CBS-74-T357, aparece en la pestaña Código vinculado de esa tarea. Forma parte del paquete Business y solo los administradores pueden conectar.

Conectar un repositorio

1. Abra Ajustes y elija Integraciones.
2. En GitHub y GitLab, escriba un Nombre (por ejemplo Mobile app), elija GitHub o GitLab y pulse Conectar.
3. Kaam360 muestra una Dirección y un Secreto. Copie ambos ahora: el secreto se muestra una sola vez.
4. En GitHub, abra el repositorio (o su organización) y luego Settings, Webhooks, Add webhook. Pegue la dirección en Payload URL, elija application/json, pegue el secreto en Secret, elija Let me select individual events, marque Pushes y Pull requests, y pulse Add webhook.
5. En GitLab, abra el proyecto (o su grupo) y luego Settings, Webhooks, Add new webhook. Pegue la dirección en URL y el secreto en Secret token, marque Push events y Merge request events, y pulse Add webhook.

GitHub envía enseguida un mensaje de prueba. La conexión muestra entonces Activo y lo que hizo el último mensaje.

Mencionar una tarea

Copie el número de la tarea que aparece arriba en la tarea (por ejemplo CBS-74-T357) en:

• un mensaje de commit, como Fix the login button (CBS-74-T357);
• un nombre de rama, como feature/CBS-74-T357-login;
• el título o la descripción de una pull request.

El número debe incluir el código de su propio proyecto, así nunca se vincula por error un número de otro proyecto. Abra la tarea y elija la pestaña Código vinculado para ver cada commit, rama y pull request vinculados, con su repositorio y autor, y en una pull request si está abierta, fusionada o cerrada. Pulse una línea para abrirla en GitHub o GitLab. El historial de la tarea también muestra cuándo se vinculó código.

Terminar tareas cuando se fusiona una pull request

Marque Marcar como terminadas las tareas que menciona en una conexión. Cuando se fusiona una pull request que menciona una tarea, la tarea pasa a terminada, como si lo hubiera hecho el administrador que creó la conexión.

Mantenerlo seguro

• Kaam360 comprueba el secreto en cada mensaje y rechaza todo lo que no lo lleve.
• Si el secreto pudo filtrarse, pulse el botón de la llave (Nuevo secreto) y ponga el nuevo secreto en los ajustes del webhook. El anterior deja de funcionar al instante.
• Pulse Pausar para dejar de vincular durante un tiempo, o Quitar para eliminar la conexión y los vínculos que creó. Elimine también el webhook en GitHub o GitLab.

Si algo sale mal

• No se vincula nada: compruebe que el número incluye el código del proyecto y el número de tarea correcto, y que el webhook envía pushes y pull requests.
• GitHub muestra una marca roja en un envío: la dirección o el secreto son incorrectos. Pulse Nuevo secreto y péguelo de nuevo.