Integra los commits, ramas y solicitudes de fusión de GitLab con las tareas de ClickUp. Esto te permite: 

• Consulta toda la actividad de GitLab relacionada con una tarea en ClickUp. 
• Recibe opcionalmente notificaciones de ClickUp cuando se añadan elementos de actividad nuevos de GitLab a las tareas.
• Adjunta automática o manualmente la actividad de GitLab a las tareas de ClickUp. 
• Cambia automáticamente los estados con acciones de GitLab añadiendo el ID de la tarea de ClickUp a tus confirmaciones utilizando este formato: #{taskID}[estado].
  • Ejemplo: #1abc2de[cerrada]

Lo que necesitarás

• La integración de GitLab está disponible en cada plan de ClickUp.
• Solo los propietarios y administradores del entorno de trabajo pueden configurar integraciones.
• Invitados no pueden usar la integración de GitLab.
• La integración con GitLab funciona tanto con la versión local como con la versión autoalojada de GitLab.

Paso 1: Autorizar a GitLab

Conecta y autoriza GitLab desde ClickUp:

1. En la esquina superior derecha, haz clic en el menú de acciones rápidas.
2. Haz clic en Centro de aplicaciones.
3. Desde la barra lateral del Centro de aplicaciones, selecciona Desarrollo .
4. Haz clic en GitLab.
5. Selecciona Conectar.
6. Inicia sesión en tu cuenta de GitLab.

Autoriza con gitlab.com o GitLab autoalojado

Una vez que hayas conectado tu cuenta de GitLab, puedes elegir autorizar usando gitlab.com o GitLab autoalojado.

Usando gitlab.com:

1. En la página GitLab App Center, haz clic en Gestionar.
2. Haz clic en + Añadir Gitlab.
3. Selecciona No, uso gitlab.com.
4. Haz clic en Enlazar Gitlab.
5. Haz clic en Autorizar. Debes autorizar a ClickUp para asociar la actividad de GitLab con las tareas de ClickUp.

Usando GitLab autoalojado:

1. En la página GitLab App Center, haz clic en Gestionar.
2. Haz clic en + Añadir Gitlab.
3. Selecciona Sí, uso una versión alojada de Gitlab.
4. Pega tu URL de GitLab en el cuadro de texto Host url .
   • URL de ejemplo: https://gitlab.mydomain.com/
5. Sigue las instrucciones para encontrar, copiar y pegar tu token de acceso personal en el cuadro de texto Token de acceso.
   

   Si tu equipo está detrás de un cortafuegos, incluye tu dirección IP estática en la lista de permitidos del cortafuegos antes de integrar. Esta dirección IP estática se mostrará en este paso.

6. Haz clic en Enlazar Gitlab.
7. Haz clic en Autorizar. Debes autorizar a ClickUp para asociar la actividad de GitLab con las tareas de ClickUp.

Por razones de seguridad, requerimos que todas las integraciones de GitLab que usen una instancia de GitLab autoalojada tengan un Dominio de Nivel Superior (TLD). La URL no puede tener un número de puerto añadido. No permitimos direcciones IP o dominios que no sean reconocidos como un Dominio de Nivel Superior. Un ejemplo de una URL válida sería https://gitlab.clickup.com.

Paso 2: Añadir repositorios personales a ClickUp

Varias personas pueden autorizar GitLab dentro de tu entorno de trabajo. Puedes personalizar qué repositorios se comparten con tu entorno de trabajo, permitiéndote autorizar tu cuenta personal sin necesidad de vincular todos tus repositorios.

Adjuntar un repositorio no otorga acceso a los usuarios a la base de código de tu repositorio. Permite a los usuarios adjuntar elementos del historial de ese repositorio a los espacios que especifiques. 

Para añadir un repositorio en ClickUp:

1. Desde el Centro de aplicaciones, selecciona GitLab.
2. Haz clic en Gestionar.
3. Los repositorios están listados en la sección Mis repositorios de Gitlab.
4. A la derecha del repositorio que desea añadir, haga clic en + Añadir a ClickUp.

Paso 3: Selecciona qué espacios están vinculados a tus repositorios 

Los repositorios añadidos se enumeran en la sección repositorios de Gitlab añadidos a ClickUp en la parte inferior derecha.

Para vincular un repositorio a un espacio de ClickUp, haz clic en el desplegable a la derecha del nombre del repositorio y selecciona uno o más espacios.

El repositorio debe estar vinculado a un espacio antes de que puedas adjuntar elementos de GitLab a las tareas.

Asocia automáticamente la actividad de GitLab en ClickUp 

ClickUp puede asociar automáticamente nueva actividad de GitLab con las tareas.

Para hacerlo, añade un ID de tarea de ClickUp en cualquier parte del título de la solicitud de fusión, nombre de la rama o mensaje de confirmación en uno de estos formatos:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

prefijo-1

#prefix-1

Asocia manualmente los commits de GitLab

Para asociar manualmente una confirmación de GitLab con una tarea de ClickUp:

1. Abre una tarea y haz clic en el icono de GitLab.
2. Haz clic en la pestaña Confirmaciones.
3. Usa el menú desplegable junto a Nueva solicitud de fusión para seleccionar un Repositorio.
4. Utiliza el desplegable Seleccionar Rama para elegir una Rama.
5. Adjunta tu confirmación.

Asociar manualmente las ramas de GitLab

Para asociar manualmente una rama de GitLab:

1. Abre una tarea y haz clic en el icono de GitLab.
2. Haz clic en la pestaña Sucursales.
3. Usa el menú desplegable junto a Nueva solicitud de fusión para seleccionar un Repositorio.
4. Utiliza el desplegable Seleccionar ramificación para adjuntar una ramificación.

Cambio automático de estados de tarea desde GitLab 

Puedes cambiar el estado de una tarea desde una confirmación, problema o solicitud de fusión:

1. Añade el ID de tarea de ClickUp a cualquier parte del mensaje de confirmación e incluye el estado que deseas entre corchetes.
   • Por ejemplo: #u7hu[fase]
     

     Se pueden utilizar todos los formatos de la lista de la sección Asociar automáticamente la actividad de GitLab en ClickUp de este artículo. Para asegurar un formato adecuado, no añadas un espacio entre el ID de tarea y la información de estado.

2. El estado de la tarea cambiará.

Crea nuevas ramas desde ClickUp

Crea nuevas ramas utilizando acciones rápidas en ClickUp:

1. Abre una tarea y haz clic en el icono de GitLab.
2. A la izquierda, encontrarás varias opciones de copia rápida generadas automáticamente. Si prefieres crear una nueva rama directamente en GitLab, haz clic en Crear rama en la esquina inferior izquierda del cuadro de diálogo.

Personaliza los nombres de las ramas generados automáticamente

Puedes personalizar el formato de los nombres de ramificación autogenerados que se utilizan en las acciones rápidas:

1. Desde el Centro de aplicaciones, selecciona GitLab.
2. Bajo el formato de nombres de ramas autogeneradas, realiza modificaciones.
3. En la parte inferior derecha, haz clic en Guardar.

Crea solicitudes de fusión desde ClickUp

Crea o enlaza solicitudes de fusión desde ClickUp.

Para crear una nueva solicitud de fusión:

1. Abre una tarea y haz clic en el icono de GitLab.
2. En la parte inferior izquierda del cuadro de diálogo, haz clic en Nueva solicitud de fusión.
3. Utiliza el título de solicitud de fusión preestablecido o crea uno propio.
4. Selecciona un repositorio, una rama de origen y una rama objetivo.
5. Introduce una descripción.
6. Crea la solicitud de fusión haciendo clic en Nueva Solicitud de Fusión.

Una vez que creas o fusionas una solicitud en ClickUp, un enlace a la tarea asociada de ClickUp se añade automáticamente a la solicitud de fusión en GitLab.

Una vez enlazada una solicitud de fusión, puedes ver quién la abrió, el revisor, el estado de CI/CD y el estado de la solicitud de fusión desde la tarea de ClickUp enlazada.

Eliminar la integración de GitLab

Solo los propietarios del entorno de trabajo y los administradores pueden eliminar la integración con GitLab.

Para eliminar la integración con GitLab:

1. Desde el Centro de aplicaciones, selecciona GitLab.
2. En la parte inferior derecha, haz clic en Eliminar Gitlab.

Solucionar problemas de integración

Lee nuestro artículo de solución de problemas de GitLab o conecta con el soporte al cliente de GitLab aquí.