Integración con GitHub

Vincula espacios directamente con repositorios de GitHub para siempre saber qué trabajo está relacionado.

Los propietarios y administradores de espacios de trabajo pueden conectar Spaces a sus repositorios, permitiendo a los miembros agregar su trabajo de Github a las tareas.

Las tareas en Espacios con un repositorio conectado pueden vincularse con confirmaciones, ramificaciones y solicitudes de validación.

Lo que necesitarás

  • La integración con GitHub está disponible en todos los planes de ClickUp.
  • Sólo los administradores de repositorios pueden agregar repositorios de GitHub a ClickUp. Una vez añadido, los administradores del entorno de trabajo pueden agregar esos repositorios a los espacios de ClickUp!
  • Solo los propietarios y administradores del entorno de trabajo pueden actualizar los ajustes del entorno de trabajo en el Centro de apps .
  • Sólo los propietarios y administradores de Espacios de trabajo pueden agregar y vincular repositorios a Espacios.
  • Sólo los propietarios y administradores de espacios de trabajo pueden crear conexiones de espacios de trabajo. Se permiten múltiples conexiones de entornos de trabajo.
  • Miembros y superiores pueden crear conexiones personales.
  • Invitados no pueden utilizar la integración con GitHub.
  • La búsqueda conectada del entorno de trabajo está disponible en el plan Business y superiores.

  • La Búsqueda Personal Conectada no está disponible para la integración con GitHub.

Ejemplo real

El equipo de ingeniería de tu aplicación móvil y el equipo de desarrollo web trabajan en repositorios y espacios separados, dentro de la misma organización de GitHub y entorno de trabajo de ClickUp.

Para comenzar con la integración:

  1. El propietario del entorno de trabajo o el administrador crea una conexión de GitHub en el entorno de trabajo.
  2. El gestor de la app móvil conecta el repositorio de GitHub app-mobile al espacio de desarrollo de apps móviles.
  3. El administrador del sitio web conecta el repositorio de GitHub del sitio web al espacio marketing sitio web.
  4. Las tareas en los Espacios de desarrollo de aplicaciones móviles y sitios web de marketing muestran ahora el icono de GitHub, lo que permite a ambos equipos vincular sus tareas con commits, ramas y pull requests de GitHub.

Configura la integración

Hay cuatro pasos para configurar la integración de GitHub en ClickUp:

  1. Conecta GitHub.
  2. Anexa repositorios de GitHub a tu Espacio de trabajo.
  3. Vincula repositorios de GitHub a los Espacios de ClickUp.
  4. Opcionalmente, puedes establecer un formato de nombre de rama personalizado.

Paso 1: Conectar GitHub

Necesitarás ser propietario o administrador de un espacio de trabajo para configurar una conexión de espacio de trabajo para GitHub.

Puedes configurar una conexión con GitHub desde el Centro de apps o el centro de comandos.

Desde el Centro de apps:

  1. Busca y selecciona GitHub.
  2. Haz clic en la pestaña Entorno de trabajo.

    También puedes configurar una conexión personal para crear solicitudes de validación y ramificaciones desde ClickUp. Las conexiones personales también pueden utilizarse para vincular directamente solicitudes de validación, ramificaciones y confirmaciones existentes desde tareas de ClickUp. 

  3. Haz clic en Conectar.
  4. Inicia sesión en tu cuenta de GitHub para autorizar el acceso.

Captura de pantalla del botón clickup de Autorizar al configurar la integración.

Desde el centro de comandos:

  1. Debajo de la barra de búsqueda, haz clic en Aplicaciones.
  2. Bajo GitHub, haga clic en Conectar.
  3. Bajo Conexiones del entorno de trabajo, haz clic en Conectar.
  4. Inicia sesión en tu cuenta de GitHub para autorizar el acceso.

Paso 2: Vincula repositorios de GitHub a tu entorno de trabajo

Los propietarios y administradores de espacios de trabajo pueden elegir qué repositorios de GitHub quieren vincular a su espacio de trabajo ClickUp. El propietario o administrador también debe ser un administrador del repositorio en GitHub.

Vincular un repositorio no otorga a los usuarios de ClickUp acceso al código base de tu repositorio.

Para agregar un repositorio a un Espacio de trabajo:

  1. Abre GitHub en el Centro de apps.
  2. Haz clic en **Ajustes del entorno de trabajo**.
  3. Junto a Conectar Repositorios a ClickUp, haz clic en Agregar repo.
  4. Selecciona todos los repositorios que deseas agregar.

Si no ves los repos correctos, puede que iniciaste sesión con la cuenta de GitHub equivocada.

Paso 3: Vincula repositorios de GitHub a espacios de ClickUp

Después de agregar repositorios a tu entorno de trabajo, puedes agregar cada repositorio a uno o más espacios. Cada espacio de ClickUp puede tener múltiples repositorios agregados.

Puedes añadir o eliminar repositorios de los espacios en cualquier momento.

Para vincular un repositorio a un Espacio:

  1. Abre GitHub en el Centro de apps.
  2. Haz clic en **Ajustes del entorno de trabajo**.
  3. Haz clic en el nombre del repositorio que deseas vincular.
  4. Haz clic en + Añadir espacio.
  5. Repite para los espacios adicionales que desees vincular.

Paso 4: Establece el formato de nombre de tu rama

Si tu organización utiliza un formato específico para los nombres de las ramificaciones, puedes establecerlo desde la página de GitHub en el Centro de apps. Cuando las personas crean ramificaciones desde tareas de ClickUp, se utilizará este formato.

El formato predeterminado es: :taskId:_:taskName:_:username:

Por ejemplo: CU-ae27de_Auto-generated-naming_John-smith

Las opciones disponibles se muestran en la siguiente tabla:

Valor Descripción
:nombre de usuario: El nombre de usuario de la cuenta de ClickUp que creó la ramificación. Los espacios se reemplazan por un guion.
:taskId: El ID de la tarea de ClickUp donde se crea la ramificación. Incluye el prefijo requerido.
:taskName: El nombre de la tarea donde se crea la ramificación. Los espacios se reemplazan por un guion.

Para establecer tu formato de nombre predeterminado de GitHub en el App Center:

  1. Haz clic en **Ajustes del entorno de trabajo**.
  2. En Nombre de rama generado automáticamente, introduce el formato de nombre de rama que prefieras.
  3. Haz clic en Guardar.

Captura de pantalla de alguien creando un nombre de rama autogenerado.

Busca archivos de GitHub usando la Búsqueda Conectada

Al usar una conexión de entorno de trabajo en el plan Business y superior, puedes usar Búsqueda conectada del entorno de trabajo para permitir que todos los miembros del entorno de trabajo busquen cualquier archivo público de los repositorios que agregues. Los archivos privados no pueden ser buscados.

Desde el Centro de apps:

  1. Busca y selecciona GitHub.
  2. Haz clic en la pestaña Entorno de trabajo.
  3. Haz clic en el interruptor junto a Búsqueda Conectada del Espacio.
  4. Junto a tu conexión de entorno de trabajo, haz clic en Guardar.
  5. Los archivos de GitHub en los repositorios que has añadido se mostrarán al buscar en tu entorno de trabajo.

Fija GitHub al centro de comandos

Filtra los resultados de búsqueda para archivos de GitHub fijando GitHub al centro de comandos.

Vincula tareas desde GitHub

ClickUp asocia automáticamente la nueva actividad de GitHub con las tareas si incluyes un ID de tarea válido de ClickUp ID de tarea en cualquier parte del título de la solicitud de validación, la descripción de la solicitud de validación, el nombre de la ramificación o el mensaje de confirmación.

Cuando se incluye un ID de tarea ClickUp en una pull request, se publicará un comentario con un enlace a la tarea ClickUp en la pull request. No se mostrará un enlace al pegar manualmente una pull request en una tarea ClickUp.

El comentario se publicará empleando la cuenta de GitHub de la persona que creó el repositorio y el mapeo espacial.

El ID de tarea debe formatearse usando una de estas opciones:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Vincula tareas desde ClickUp

También puedes vincular manualmente tareas de ClickUp con confirmaciones, ramificaciones y solicitudes de validación de GitHub desde la tarea de ClickUp. Asegúrese de que la tarea esté ubicada en un espacio que esté vinculado a un repositorio.

Para vincular una tarea:

  1. Abre una tarea y haz clic en el ícono de GitHub.

    A la derecha, verás nombres de ramas sugeridos y mensajes de confirmación que puedes copiar al portapapeles. También puedes copiar el ID de tarea desde aquí.

  2. En la esquina inferior derecha, haz clic en Agregar enlace de GitHub.
    Captura de pantalla del cuadro de diálogo modal para añadir un enlace de GitHub.
  3. Pega un vínculo.
  4. En la esquina inferior derecha, haz clic en Agregar.

Crea incidencias, ramas y pull requests en GitHub desde ClickUp

También puedes crear nuevos problemas, ramificaciones y solicitudes de fusión directamente desde las tareas. Asegúrese de que la tarea esté ubicada en un espacio que esté vinculado a un repositorio.

Para crear un problema, una ramificación o una solicitud de validación:

  1. Abre una tarea y haz clic en el ícono de GitHub.
    A la derecha, verás nombres de ramas sugeridos y mensajes de confirmación que puedes copiar al portapapeles. También puedes copiar el ID de tarea desde aquí.
  2. En la esquina inferior derecha, haz clic en Agregar enlace de GitHub.
  3. Elige una de las siguientes opciones:
    • Nuevo problema en GitHub
    • Nueva rama de GitHub
    • Nueva solicitud de validación en GitHub
  4. Nombra la incidencia, rama o pull request.
  5. Selecciona un repositorio y completa la información. Agregar una rama de origen y una rama de destino si corresponde.
    Captura de pantalla de alguien creando una nueva incidencia en GitHub.
  6. Haz clic en Crear.

Ver la actividad de GitHub en ClickUp

Para ver toda la actividad de GitHub en una tarea, haz clic en el icono GitHub en el lado derecho de la tarea.

Captura de pantalla de la pestaña de GitHub en una tarea después de que alguien agregó una ramificación y un problema desde ClickUp.

La actividad de tarea en GitHub usa el nombre de usuario de ClickUp de la persona, o su nombre de usuario de GitHub si no tiene una cuenta de ClickUp.

Actualiza los estados de las tareas desde GitHub

Puedes actualizar el estado de una tarea de ClickUp cuando enlazas una confirmación, envías una confirmación o creas una solicitud de validación. ClickUp detecta automáticamente la nueva actividad en GitHub y la asocia con tareas si incluyes un ID de tarea válido en cualquier parte del título de la solicitud de validación, la descripción de la solicitud de validación, el nombre de la rama o el mensaje de confirmación.

El ID de tarea debe formatearse usando una de estas opciones:

#{task_id}[estado]

CU-{task_id}[estado]

{custom_task_id}[estado]

#{custom_task_id}[estado]

Para actualizar el estado de una tarea:

  1. Agrega el ID de la tarea ClickUp en cualquier parte del mensaje de confirmación o de solicitud de extracción.
  2. Incluye el estado actualizado de la tarea entre corchetes.

Por ejemplo #ud5b[listo]

Todos los formatos mencionados en la sección Vincular tareas desde GitHub 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.

También puedes actualizar los estados de las tareas usando Automatizaciones de GitHub!

Gestiona problemas de GitHub, ramificaciones, solicitudes de validación y confirmaciones desde ClickUp

Después de vincular problemas, ramificaciones, solicitudes de validación o confirmaciones, se mostrarán en el lado derecho de tu tarea cuando hagas clic en el icono de GitHub. Emplea el menú elipsis ... para copiar el enlace o eliminar el elemento.

Una vez que vinculas un elemento de GitHub, se muestra la siguiente información en tu tarea de ClickUp:

Emitir información

Después de vincular un problema, puedes ver los siguientes detalles:

  • La persona que abrió el tema, conocida como el autor
  • Cualquier revisor asignado
  • Se creó el vínculo .
  • Repositorio
  • El estado del problema.
  • URL

Información de la sucursal

Una vez que se vincula una ramificación, puedes ver los detalles siguientes:

  • La persona que creó la ramificación, conocida como el autor
  • Creador de enlaces
  • Repositorio
  • URL

Información de solicitud de validación

Después de que una solicitud de validación esté vinculada, puedes ver los siguientes detalles:

  • La persona que inició la solicitud de validación, conocida como el autor
  • Cualquier revisor asignado
  • Personas asignadas
  • Cambios de línea
  • Se creó el vínculo .
  • Repositorio
  • Rama de origen
  • Rama objetivo
  • El estado de la solicitud de fusión
  • URL

Información de confirmación

Después de que una confirmación esté vinculada, puedes ver los siguientes detalles:

  • La persona que creó el commit, conocida como autor
  • Archivos modificados
  • Cambios de línea
  • Se creó el vínculo .
  • Repositorio
  • URL

Agrega tu cuenta de GitHub a ClickUp

Los miembros del entorno de trabajo pueden vincular sus cuentas de GitHub con su cuenta de ClickUp de manera anticipada o cuando crean una ramificación o solicitud de validación.

Para añadir tu cuenta de GitHub desde el Centro de apps:

  1. Busca y selecciona GitHub.
  2. Haga clic en la pestaña Personal.
  3. Junto a Crear una conexión personal, haz clic en Conectar.
  4. Inicia sesión en GitHub y autoriza a ClickUp.

Desconectar la integración de GitHub

Si ya no necesita acceder a los archivos de GitHub en ClickUp, puede desconectar la integración desde el Centro de apps:

  1. Busca y selecciona GitHub.
  2. Selecciona la pestaña espacio.

    Solo los propietarios y administradores pueden desconectar las conexiones del entorno de trabajo.

  3. Junto a Conectado, haz clic en el menú de puntos suspensivos ....
  4. Selecciona Desconectar.
  5. Para confirmar, haz clic en Desconectar.

¿Fue útil este artículo?