Integración con GitLab

Integra GitLab confirmaciones, ramificaciones y solicitudes de fusión con las tareas de ClickUp. Esto te permite: 

  • Consulta toda la actividad de GitLab relacionada con una tarea en ClickUp. 
  • Opcionalmente, recibe notificaciones de ClickUp cuando se añadan nuevos elementos de actividad de GitLab a las tareas.
  • Adjunta automáticamente o manualmente la actividad de GitLab a tareas de ClickUp
  • Cambia automáticamente los estados con acciones de GitLab al añadir el ID de tarea de ClickUp a tus confirmaciones usando este formato: #{taskID}[estado].
    • Ejemplo: #1abc2de[cerrado]

Lo que necesitarás

  • La integración con GitLab está disponible en cada plan de ClickUp.
  • Solo los propietarios y administradores del entorno de trabajo pueden configurar integraciones.
  • Los invitados no pueden emplear la integración con GitLab.
  • La integración con GitLab funciona tanto para las versiones locales como autoalojadas de GitLab.

Paso 1: Autoriza a GitLab

Conecte y autorice GitLab desde ClickUp:

  1. En la esquina superior derecha, haz clic en el menú de Acción Rápida.
  2. Haz clic en Centro de apps.
  3. Desde la barra lateral del Centro de apps, 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 del GitLab App Center, haz clic en Gestionar.
  2. Haga clic en + Añadir Gitlab.
  3. Selecciona No, uso gitlab.com.
  4. Haz clic en Vincular Gitlab.
  5. Haz clic en Autorizar. Debes autorizar a ClickUp para que asocie la actividad de GitLab con las tareas de ClickUp.

Empleando GitLab autoalojado:

  1. En la página del 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 URL del host .
  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 de tu cortafuegos antes de integrar. Esta dirección IP estática se mostrará en este paso.

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

Por motivos de seguridad, exigimos 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: Agrega repositorios personales a ClickUp

Varias personas pueden autorizar GitLab dentro de su entorno de trabajo. Puedes personalizar qué repositorios se comparten con tu entorno de trabajo, lo que te permite autorizar tu cuenta personal sin necesidad de adjuntar todos tus repositorios.

Vincular un repositorio no otorga a los usuarios acceso 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 agregar un repositorio a ClickUp:

  1. Desde el Centro de apps, selecciona GitLab.
  2. Haz clic en Gestionar.
  3. Los repositorios se enumeran en la sección Mis repositorios de GitLab.
  4. A la derecha del repositorio que quieras agregar, haz clic en + Agregar a ClickUp.

Captura de pantalla de alguien añadiendo un repositorio 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, haga clic en el desplegable a la derecha del nombre del repositorio y seleccione uno o más espacios.

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

Captura de pantalla de alguien seleccionando espacios de ClickUp para un repositorio.

Asocia automáticamente la actividad de GitLab en ClickUp 

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

Para hacerlo, añade un ID de tarea de ClickUp ID de tarea 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

Lo siento, pero no proporcionaste el contenido que necesitas traducir. Por favor, envíame el texto y estaré encantado de ayudarte con la traducción y adaptación al español latinoamericano.

#prefix-1

Asociar 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 Commits.
  3. Usa el menú desplegable junto a Nueva solicitud de fusión para seleccionar un repositorio.
  4. Emplea el desplegable Seleccionar Rama para seleccionar una Rama.
  5. Adjunta tu confirmación.

Captura de pantalla de alguien asociando manualmente una confirmación de GitLab con una tarea de ClickUp.

Asocia manualmente ramificaciones de GitLab

Para asociar manualmente una ramificación de GitLab:

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

Captura de pantalla de alguien adjuntando una ramificación.

Cambia automáticamente los estados de las tareas desde GitLab 

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

  1. Añada el ID de tarea de ClickUp a cualquier parte del mensaje de confirmación e incluya el estado que desea entre corchetes.
    • Por ejemplo: #u7hu[staged]

      Todos los formatos listados en la sección Asociar automáticamente la actividad de GitLab en ClickUp de este artículo pueden utilizarse. Para asegurar el 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 ramificaciones desde ClickUp

Crea nuevas ramificaciones utilizando acciones rápidas en ClickUp:

  1. Abre una tarea y haz clic en el icono de GitLab.
  2. A la izquierda, hay varias opciones de copia rápida auto-generadas. Si prefieres crear una nueva ramificación directamente en GitLab, haz clic en Crear Ramificación en la esquina inferior izquierda del cuadro de diálogo modal.

Captura de pantalla de alguien creando una nueva ramificación desde ClickUp.

Personaliza los nombres de ramificación generados automáticamente

Puedes personalizar el formato de los nombres de ramificación generados automáticamente utilizados en acciones rápidas:

  1. Desde el Centro de apps, selecciona GitLab.
  2. Bajo el formato de nombres de ramas generadas automáticamente, realiza modificaciones.Captura de pantalla de alguien cambiando el formato de la rama generada automáticamente.
  3. En la parte inferior derecha, haga clic en Guardar.

Crear solicitudes de fusión desde ClickUp

Crea o vincula 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 predeterminado de solicitud de fusión o crea uno propio.
  4. Selecciona un repositorio, una rama de origen y una rama de destino.
  5. Ingresa 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, se añade automáticamente un enlace a la tarea de ClickUp asociada en la solicitud de fusión en GitLab.

Captura de pantalla de alguien creando una solicitud de fusión desde ClickUp.

Después de vincular 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 directamente desde la tarea de ClickUp vinculada.

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 apps, selecciona GitLab.
  2. En la parte inferior derecha, haz clic en Eliminar Gitlab.

Solucionar problemas de la integración

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

¿Fue útil este artículo?