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]
- Ejemplo:
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.
Repositorios personales y de equipo
La siguiente tabla explica las diferencias entre los repositorios personales y de equipo.
Tipo de repositorio | Nombre en ClickUp | Descripción |
Personal | Mis repositorios de GitLab |
Los repositorios a los que tienes acceso personal en GitLab se muestran en la sección Mis repositorios de GitLab. El primer paso para configurar nuestra integración de GitLab es autorizar el acceso de ClickUp a estos repositorios para que puedas incorporarlos a los repos de tu entorno de trabajo en ClickUp. Se requiere HTTP o HTTPS para acceder a tus servidores alojados. Asegúrate de usar la URL base de tu servidor de GitLab. Por ejemplo: https://gitlab.miempresa.com Por motivos de seguridad, requerimos que todas las integraciones de GitLab que usen una instancia de GitLab autoalojada tengan un Dominio de Nivel Superior (TLD). No permitimos direcciones IP ni dominios que no sean reconocidos como un Dominio de Nivel Superior. |
Equipo | Repositorios de GitLab añadidos a ClickUp |
Los repositorios a los que tu entorno de trabajo tiene acceso se muestran bajo Repositorios de GitLab añadidos a ClickUp. Aquí, los repos indican que los miembros de tu entorno de trabajo los han autorizado para ser accedidos por todo tu entorno de trabajo en ClickUp. Para usar los repos de GitLab en ClickUp, deben ser añadidos a los repos de tu entorno de trabajo en ClickUp. |
Paso 1: Autoriza a GitLab
Puedes autorizar GitLab con gitlab.com o con GitLab autoalojado.
Autoriza con gitlab.com
Para autorizar con gitlab.com:
- Abre el Centro de apps.
- Busca y selecciona GitLab.
- Selecciona Gestionar.
- Haz clic en Activar Gitlab para el equipo.
- Haga clic en + Añadir Gitlab.
- Selecciona No, uso gitlab.com.
- Haz clic en Vincular Gitlab.
- Haz clic en Autorizar. Debes autorizar a ClickUp para que asocie la actividad de GitLab con las tareas de ClickUp.
Autoriza con GitLab autoalojado
Para autorizar con GitLab autoalojado:
- Abre el Centro de apps.
- Busca y selecciona GitLab.
- Selecciona Gestionar.
- Haz clic en Activar Gitlab para el equipo.
- Haz clic en + Añadir Gitlab.
- Selecciona Sí, uso una versión alojada de Gitlab.
- Pega tu URL de GitLab en el cuadro de texto URL del host .
- Ejemplo de URL: https://gitlab.mydomain.com/
- 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.
- Haz clic en Vincular Gitlab.
- 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:
- En el Centro de apps, busca y selecciona GitLab.
- Haz clic en Gestionar.
- Los repositorios se enumeran en la sección Mis repositorios de GitLab.
- A la derecha del repositorio que quieras agregar, haz clic en + Agregar 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.
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:
- Abre una tarea y haz clic en el icono de GitLab.
- Haz clic en la pestaña Commits.
- Usa el menú desplegable junto a Nueva solicitud de fusión para seleccionar un repositorio.
- Emplea el desplegable Seleccionar Rama para seleccionar una Rama.
- Adjunta tu confirmación.
Asocia manualmente ramificaciones de GitLab
Para asociar manualmente una ramificación de GitLab:
- Abre una tarea y haz clic en el icono de GitLab.
- Haz clic en la pestaña Ramificaciones.
- Usa el menú desplegable junto a Nueva solicitud de fusión para seleccionar un repositorio.
- Usa el desplegable Seleccionar Ramificación para adjuntar 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:
- 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.
- Por ejemplo:
- El estado de la tarea cambiará.
Crea nuevas ramificaciones desde ClickUp
Crea nuevas ramificaciones utilizando acciones rápidas en ClickUp:
- Abre una tarea y haz clic en el icono de GitLab.
- 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.
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:
- Desde el Centro de apps, selecciona GitLab.
- Bajo el formato de nombres de ramas generadas automáticamente, realiza modificaciones.
- 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:
- Abre una tarea y haz clic en el icono de GitLab.
- En la parte inferior izquierda del cuadro de diálogo, haz clic en Nueva solicitud de fusión.
- Utiliza el título predeterminado de solicitud de fusión o crea uno propio.
- Selecciona un repositorio, una rama de origen y una rama de destino.
- Ingresa una descripción.
- 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.
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.
Problemas de conexión
Si conectaste accidentalmente la cuenta incorrecta de GitLab o si hay un problema con la conexión, puedes desconectar y reconectar tus repos o toda tu cuenta.
¿Necesitas solucionar problemas con un representante de GitLab? Solicita el soporte al cliente de GitLab aquí.
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:
- Desde el Centro de apps, selecciona GitLab.
- En la parte inferior derecha, haz clic en Eliminar Gitlab.