¿Usando nuestra integración con GitHub para sincronizar el trabajo entre GitHub y ClickUp? Añade automatizaciones de GitHub para construir un flujo de trabajo eficiente. Los equipos de software pueden reducir el cambio de contexto utilizando Automatizaciones para mantener todo actualizado.
Qué necesitas
- Las integraciones de automatización están disponibles en los planes Business y superiores.
- El administrador o propietario del entorno de trabajo debe habilitar la ClickApp de Automatización.
- Necesitas permisos de administrador en el repositorio de GitHub para configurar Automatizaciones.
- Invitados no pueden utilizar la integración de GitHub.
Agregar una Automatización de GitHub en ClickUp
Puedes añadir Automatizaciones de GitHub en los niveles de Espacio, Carpeta y Listas de la Jerarquía de ClickUp.
- Navega al espacio, carpeta, o lista donde se aplicará la Automatización.
- Haz clic en el botón Automatizaciones en la esquina superior derecha.
- Haz clic en Añadir automatizaciones.
- Selecciona Explorar en la parte superior.
- Seleccione Github en la barra lateral izquierda.
- Selecciona la Automatización que deseas utilizar o haz clic en Mostrar más para ver más Automatizaciones de GitHub disponibles.
- Conecta tu cuenta de GitHub utilizando las siguientes opciones:
-
Seleccione de la lista desplegable de cuentas de GitHub existentes.
- Para actualizar una cuenta de GitHub previamente autorizada, debes eliminarla y volver a añadirla.
- Eliminar una cuenta no afectará ninguna Automatización existente que utilice esa cuenta. Necesitarás volver a añadirlo para crear Automatizaciones en GitHub en el futuro.
- Introduce tu nombre de usuario de GitHub y haz clic en Conectar cuenta para autorizar a ClickUp o haz clic en Crear una cuenta para crear una nueva cuenta en GitHub.com.
-
Seleccione de la lista desplegable de cuentas de GitHub existentes.
- Especifica quién puede usar tu cuenta de GitHub para crear Automatizaciones.
- Configura el desencadenante, las condiciones y las acciones.
- Cada automatización de GitHub te permite seleccionar un repositorio específico.
- Las opciones disponibles variarán dependiendo de la Automatización de GitHub que estés utilizando.
- Haz clic en Crear.
- Considera darle a tu Automatización de GitHub una descripción significativa para ayudar a otros a entender qué hace.
Automatizaciones de GitHub
Las Automatizaciones de GitHub utilizan la misma estructura que Automatizaciones en ClickUp.
Cada Automatización consta de un Desencadenante y una Acción. Los usuarios del plan Business y superiores tienen la opción de utilizar Condiciones.
Disparadores de GitHub
Cuando se produzcan los siguientes eventos en el repositorio de GitHub especificado y se cumplan las condiciones, la Automatización se ejecutará y realizará una Acción.
-
Solicitud de fusión completada
-
Rama Combinada
-
Al confirmar
-
Revisión de solicitud de validación creada
-
Revisión de solicitud de validación actualizada
-
Estado de CI/CD Cambiado
-
Solicitud de validación enlazada
-
Rama vinculada
-
Confirmación enlazada
Condiciones de GitHub
Las automatizaciones de GitHub relacionadas con las solicitudes de validación admiten una o más condiciones.
Por ejemplo, puedes actualizar el estado de la tarea cuando se enlaza una solicitud de validación a la rama principal. O establece la prioridad de la tarea como urgente y comenta cuando una solicitud de fusión con la etiqueta hotfix se combine en la rama QA .
Las condiciones pueden establecerse para múltiples combinaciones de etiquetas de solicitud de validación, valores de referencia base y referencia de cabeza.
Lógica condicional
Puedes utilizar la siguiente lógica de Condición:
- es cualquiera de: La solicitud de fusión incluye al menos uno de los rótulos o ramas especificados.
- incluye todo: La solicitud de validación incluye todas las etiquetas o ramas especificadas.
- no es ninguna de: La solicitud de validación no incluye ninguno de los rótulos o ramificaciones especificados.
- no es todo: La solicitud de validación no incluye todos los rótulos o ramificaciones especificados.
Para etiquetas, puedes utilizar la lógica mencionada anteriormente y:
- establecido: Se ha aplicado al menos una etiqueta a la solicitud de extracción.
- no está establecido: No se han aplicado etiquetas a la solicitud de validación.
Añadir una condición
Para añadir una Condición a tu Automatización de GitHub:
- En una Automatización, en la sección de Desencadenante, haz clic en Añadir Condición.
- Selecciona a qué debe aplicarse la condición:
- Condición de etiqueta en Github: Etiquetas aplicadas a la solicitud de validación.
- Ref. principal: La rama fuente que contiene tus cambios propuestos.
- Ref. base: La rama objetivo donde se aplicarán tus cambios.
Acciones en ClickUp
Cada Acción de Automatización excepto nuestra acción de webhook está disponible para actualizar tareas usando disparadores de GitHub.
Para que las Acciones de Automatización se apliquen a las tareas existentes, la tarea ya debe estar vinculada al repositorio de GitHub mediante la vinculación de un commit, una rama o una solicitud de extracción. La acción de Crear Tarea es la única excepción, ya que las nuevas tareas no pueden vincularse por adelantado.
Acciones en GitHub
Puedes utilizar Automatizaciones con la acción Crear problema, que genera un nuevo problema en GitHub.
Por ejemplo, cuando se envía un formulario de error y se crea una tarea en una Lista específica, una Automatización puede crear un problema en Github.