¿Cómo podemos ayudar?

La integración con GitHub

 

monday-dev-banner (2).png

 

 

Entendemos la importancia de tener una integración robusta entre tu herramienta de código fuente y monday.com, así que queremos presentarte nuestra integración con GitHub.

La integración de instalación única con GitHub ofrece plantillas potentes para que tu equipo pueda trabajar con un flujo de desarrollo de software perfecto, desde la planificación y el seguimiento de los sprints en monday dev hasta la ejecución del código perfecto en GitHub.

Esta integración requiere permisos a nivel de la cuenta. Una vez hecha la preinstalación de la integración en solo unos pasos, cualquier desarrollador de su equipo puede crear nuevas plantillas.

 

Sugerencia: Para que la integración con GitHub se sincronice sin problemas, primero deberán instalar la aplicación monday.com en GitHub. También tendrán que ser administradores de la cuenta de monday.com y tener permisos de administrador en la organización de GitHub para instalar la aplicación.
Para empezar, debes ir a github.com/apps/monday-com-github e instalar la app monday.com en GitHub:

Devs Install GitHub.png

 

Se te pedirá que elijas una organización en tu cuenta:

Devs Choose Organization.png

 

Deberás autorizar a monday.com en tu cuenta de GitHub:

Devs monday Permissions.png

Una vez instalada la app, los usuarios pueden agregar plantillas nuevas de GitHub, que se autenticarán automáticamente con su cuenta de GitHub.

 

Haz clic aquí para saber qué significan estos permisos

Es importante tener en cuenta que monday.com solo accede a los datos necesarios, como nombres y ubicaciones de tus datos, para garantizar la funcionalidad. Estos permisos incluyen:

  • Acceso a tu código: En particular respecto a la plantilla TODO, monday.com lee los cambios en el PR, sin guardar el código, para poder conectarlo con tu elemento de monday 
  • Problemas - monday.com necesita acceder a información sobre problemas para disparar la automatización relevante de monday
  • Metadatos - monday.com necesita acceso a una colección de puntos finales de solo lectura con metadatos para disparar la automatización relevante de monday. Estos puntos finales no proporcionan información confidencial ni privada del repositorio.
  • Pull request - monday.com necesita leer los cambios en el PR, así también como poder acceder al permiso de escritura en los pull request, para poder disparar la automatización relevante de monday y las plantillas bidireccionales de monday

 

Cómo agregarla a su flujo de trabajo 

Para agregar las plantillas de la integración con GitHub al tablero deseado, puedes ir a ese tablero y hacer clic en Integrar en la esquina superior derecha:Group 64 (54).png

 

En el Centro de automatizaciones, busca “GitHub” en la barra de búsqueda:Group 64 (55).png

 

Haz clic en el banner de GitHub y encontrarás las plantillas que ofrece nuestra integración:Screenshot 2024-07-07 at 17.46.19 1.png

 

Luego simplemente selecciona las plantillas que quieras agregar al tablero.

 

Las plantillas de integración que admite monday.com son las siguientes:
  • When an issue is labeled with something in this repository, create an item
  • When a pull request is merged in these repositories, and item id is mentioned in it, change status to something
  • When an issue is created in these repositories, create an item
  • When a pull request is created in these repositories, and item id is mentioned in it, change status to something
  • When a pull request is created in these repositories, and item id is mentioned in it, add pull request link to link column
  • When a branch is created in these repositories, create an item
  • When an issue status changes to something in these repositories, and item id is mentioned in it, set status to something
  • When github user pushes a TODO comment to these repositories, create an item
  • When an issue is created in these repositories, and item id is mentioned in it, add link to this link column
  • When a pull request status changes to something in these repositories, and item id is mentioned in it, set status to something
  • When an issue is labeled with something in this repository, and item id is mentioned in it, set status to something
  • When a pull request status changes to something in these repositories, and item id is mentioned in it, create an update
  • When a pull request is labeled with something in this repository, and item id is mentioned in it, set status to something
  • When an issue is created in these repositories, create an item and sync future changes
  • When an issue is created with these labels in this repository, create an item and sync future changes
  • When a pull request is created or updated in these repositories, create an item and sync future changes (Cuando se cree o actualice un pull request en estos repositorios, crear un elemento y sincronizar los cambios futuros)
  • when an item is created or updated, create in issue in this repository,with these fields and sync future (Cuando se crea o actualiza un elemento, crear una incidencia en este repositorio, con estos cambios y sincronizar los cambios futuros)

 

Crear una sincronización bidireccional

Una sincronización bidireccional ocurre cuando los datos se envían de monday.com a GitHub y se reciben desde GitHub en monday.com. De esta forma, los datos coinciden dentro de ambas plataformas y permanecen actualizados.

Group 64 (56).png

 

Para crear una sincronización bidireccional, selecciona ambas direcciones en el menú desplegable.

Por ejemplo, si deseas asignar la columna Propietario de tu elemento en monday.com al campo Titular en GitHub, seleccionarás esos campos en cada menú desplegable respectivo. Luego, en el menú desplegable Elegir dirección, elige ambas direcciones.

GitHub Two-Way Sync.gif

 

¿Cuál es el ID del elemento?

Algunas de las plantillas de integración requieren una “conexión exclusiva” entre monday.com y GitHub para sincronizar las dos plataformas, y el ID del elemento es ese número exclusivo asociado con el elemento.

 

Nota: Deben escribir el símbolo “#” adelante del número en GitHub para que la columna ID del elemento de monday.com reconozca la conexión. Por ejemplo: deben escribir “#376479” en GitHub, no “376479”. 

 

Group 64 (57) (1) 1.png

 

Veamos, por ejemplo, la siguiente plantilla de integración: “When a pull request is created in this repository, and item ID is mentioned in the pull request name, change status to something” ("Cuando se cree un pull request en este repositorio, y el ID del elemento sea mencionado en el nombre del pull request, cambiar el estado a algo").

Una vez creada la solicitud de extracción en GitHub, el sistema usa el ID del elemento en monday.com para identificar qué elemento debe cambiar.

Sugerencia: Puedes hacer clic una vez en la columna ID del elemento para copiar con facilidad el valor desde tu tablero automáticamente.

 

Acciones de GitHub

Acciones de GitHub es una herramienta integrada en GitHub que te permite automatizar tareas dentro de tu flujo de trabajo de desarrollo de software. Te ayudará a eliminar tareas repetitivas, agilizando a su vez el proceso de desarrollo y haciéndolo más eficiente.Screenshot 2024-07-07 at 17.29.51 1.png

¿Qué pueden hacer las Acciones de GitHub?

  • Automatizar la canalización de CI/CD: Esto te permitirá configurar procesos automáticos para compilar, probar e implementar tu código siempre que haya cambios. Esto ayuda a detectar bugs desde el principio y agilizar el proceso de lanzamiento.
  • Ejecutar flujos de trabajo basados en eventos: Las Acciones de GitHub pueden activar flujos de trabajo basados en varios eventos en tu repositorio. Por ejemplo, puedes crear un flujo de trabajo que ejecute pruebas automáticamente cada vez que se envíes un pull request.
  • Utiliza una gran cantidad de acciones de la comunidad: Hay una amplia colección de acciones prediseñadas disponibles que puede usar para diversas tareas. Estas pueden ser cualquier cosa, desde implementar tu código en diferentes plataformas hasta crear tickets en herramientas de gestión de proyectos. También puedes crear tus propias acciones personalizadas.

Encontrarás la plantilla para nuestra integración de GitHub que abre un elemento en flujos de trabajo específicos y termina con conclusiones específicas. El elemento se puede completar con datos de flujo de trabajo.

Para usar la plantilla, navega al Centro de automatizaciones y busca GitHub. Desde allí, haz clic en la plantilla como se muestra a continuación. download (19).gif

Nota:Para usar Acciones de GitHub, el administrador de la organización de GitHub debe permitir la configuración "Permiso de lectura de acciones". Si tienes algún problema con esto, comunícate con nosotros

 

¿Qué más necesitas saber?

¿La integración funcionará incluso si no se instala la aplicación en GitHub?

  • No, la integración no es posible sin instalar la aplicación en GitHub.

¿Se puede conectar la cuenta de monday.com con múltiples organizaciones en GitHub?

  • ¡Claro que sí! Puedes conectar tus cuentas de monday.com con múltiples organizaciones en GitHub.

Luego, para desinstalar la app de monday.com desde GitHub, debes ir a tu cuenta de GitHub > Configuración > Aplicaciones y buscar monday.com. Baja hasta la “Zona de peligro” y haz clic en “Desinstalar”.

 

Si necesitas ayuda para crear integraciones personalizadas, tenemos una opción de asistencia paga con nuestra red de partners certificados de monday.com. Si te interesa, completa este formulario y alguien responderá a la brevedad. 

 

Si tienes preguntas, comunícate con nuestro equipo aquí. Estamos disponibles las 24 horas, los 7 días de la semana, y será un gusto ayudarte.