Búsqueda

Pregúntame lo que quieras

Usar las automatizaciones de GitHub

¿Usas nuestra integración con GitHub para sincronizar el trabajo entre GitHub y ClickUp? Agrega Automatizaciones de GitHub para crear un flujo de trabajo más eficiente. Los equipos de desarrollo pueden reducir el cambio de contexto usando Automatizaciones para mantener todo al día.

Las integraciones de Automatización están disponibles en los planes Business y superiores.

El administrador o propietario del Entorno de trabajo debe activar el ClickApp de Automatización.

Necesitas permisos de administrador en el repositorio de GitHub para configurar Automatizaciones.

Los invitados y los miembros con acceso limitado no pueden usar la integración con GitHub.

Crear una Automatización de GitHub en ClickUp

Para configurar una Automatización de GitHub, desde una Lista, Subcarpeta, Carpeta o Espacio:

  1. En la parte superior derecha, haz clic en el ícono de robot.
  2. Haz clic en Crear Automatización:
    • Selecciona un disparador o una acción de GitHub.
    • O, desde la barra lateral izquierda, haz clic en GitHub y selecciona una plantilla de Automatización.
  3. Configura tu Disparador, Condiciones y Acciones.
    • Selecciona o conecta tu cuenta de GitHub.
    • Escribe tu nombre de usuario de GitHub, haz clic en Conectar cuenta y autoriza ClickUp.
    • O haz clic en Crear una cuenta para crear una nueva cuenta en GitHub.com.
    • Para actualizar una cuenta de GitHub que ya autorizaste, debes quitarla y volver a agregarla.
    • Quitar una cuenta no afecta ninguna Automatización existente que la use. Deberás volver a agregarla para crear Automatizaciones de GitHub en el futuro.
    • Especifica quién puede usar tu cuenta de GitHub para crear Automatizaciones.
    • Cada Automatización de GitHub te permite elegir un repositorio específico (repo).
  4. Haz clic en Crear.

Automatizaciones de GitHub

Las Automatizaciones de GitHub usan la misma estructura que las Automatizaciones en ClickUp.

Cada Automatización consta de un Disparador y una Acción. Los usuarios del plan Business y superiores pueden usar Condiciones.

Disparadores de GitHub

Cuando ocurren los siguientes eventos en el repositorio de GitHub especificado y se cumplen las Condiciones, la Automatización se ejecuta y realiza una Acción.

  • Pull Request fusionado
  • Rama fusionada
  • Al hacer commit
  • Revisión de Pull Request creada
  • Revisión de Pull Request actualizada
  • Estado de CI/CD cambiado
  • Pull Request vinculado
  • Rama vinculada
  • Commit vinculado

Condiciones de GitHub

Las Automatizaciones de GitHub relacionadas con pull requests admiten una o más Condiciones.

Por ejemplo, puedes actualizar el estado de la tarea cuando se vincula un pull request a la rama main. O establecer la prioridad de la tarea como urgente y agregar un comentario cuando un pull request con la etiqueta hotfix se fusiona con la rama QA.

Las Condiciones se pueden configurar para múltiples combinaciones de etiquetas de pull request, base ref y valores de head ref.

Lógica de condiciones

Puedes usar la siguiente lógica de Condiciones:

  • Es cualquiera de: El pull request incluye al menos una de las etiquetas o ramas especificadas.
  • Es todo de: El pull request incluye todas las etiquetas o ramas especificadas.
  • No es ninguna de: El pull request no incluye ninguna de las etiquetas o ramas especificadas.
  • No es todo de: El pull request no incluye todas las etiquetas o ramas especificadas.

Para las etiquetas, puedes usar la lógica indicada arriba y además:

  • Está definida: Se aplicó al menos una etiqueta al pull request.
  • No está definida: No se aplicó ninguna etiqueta al pull request.

Agregar una condición

Para agregar una Condición a tu Automatización de GitHub:

  1. Desde una Automatización, en la sección Disparador, haz clic en Agregar condición.
  2. Selecciona a qué debe aplicarse la condición:
    • Condición de etiqueta de GitHub: Etiquetas aplicadas al pull request.
    • Head ref: La rama de origen que contiene los cambios propuestos.
    • Base ref: La rama de destino donde se aplicarán los cambios.
  3. Selecciona la lógica de la Condición.
  4. Elige el valor de etiqueta o rama que usarás con esta condición. Las condiciones distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con el nombre de la etiqueta o la rama; de lo contrario, no cumplirán los criterios y no activarán la Automatización.
  5. Haz clic en Agregar otro para incluir un valor adicional de etiqueta o rama.
  6. Haz clic en Agregar condición para agregar múltiples Condiciones.

Acciones de ClickUp

Todas las Acciones de Automatización, excepto la acción de Webhook, están disponibles para actualizar tareas mediante Disparadores de GitHub.

Para que las Acciones de Automatización se apliquen a tareas existentes, la tarea ya debe estar vinculada al repositorio de GitHub mediante un commit, una rama o un pull request. La acción Crear tarea es la única excepción, ya que las tareas nuevas no pueden vincularse con anticipación.

Acciones en GitHub

Puedes usar Automatizaciones con la Acción Crear issue, que crea un nuevo issue 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 issue en GitHub.