GitHub y Asana | Guía del producto

Resumen

Gracias a la integración entre Asana y GitHub, puedes sincronizar automáticamente las actualizaciones de estado de las solicitudes de extracción de GitHub con las tareas de Asana y mejorar la colaboración entre diferentes departamentos.

Esta integración permite aumentar la visibilidad y la transparencia en torno a los trabajos de ingeniería entre los equipos técnicos y no técnicos. Gracias a esta nueva integración, los desarrolladores pueden comunicarse con mayor facilidad a través de Asana para mantener informados a los equipos y a los colaboradores de diferentes departamentos; y de esta forma, se evita pasar trabajos por alto.

La integración de Asana para GitHub está disponible para todos los clientes con planes Premium, Business y Enterprise.

Instalación para Asana y acciones de GitHub

Conecta Asana y GitHub para sincronizar los estados de las solicitudes de extracción. Para usar la aplicación, la configuración se debe hacer en Asana y para otras funciones, dentro de GitHub.

Pantalla sobre cómo se agrega la aplicación con el menú Personalizar

Cómo configurar todo en Asana:

  1. Ve al proyecto de Asana en el que quisieras instalar la integración de Asana para GitHub. Haz clic en el menú desplegable Personalizar del extremo superior derecho.
  2. Deslízate hasta Aplicaciones y selecciona Agregar aplicación.

Aplicación de GitHub

  • Haz clic en +Agregar al proyecto para seleccionar GitHub.
  • Sigue las instrucciones para autorizar tu cuenta de GitHub.
  • La integración de GitHub + Asana se instalará a nivel del proyecto.
  • En la siguiente pantalla podrás seleccionar más proyectos a los que quieras agregar esta integración.

¡Felicitaciones! Ya puedes conectar las solicitudes de extracción de GitHub con las tareas de Asana. Si quieres activar alguna otra funcionalidad con la integración, consulta la siguiente sección. De lo contrario, omite el paso y sigue leyendo sobre las funcionalidades clave.

Cómo configurar las acciones de GitHub:

El contenido de esta sección se brinda bajo el supuesto de que se cuenta con cierta familiaridad básica respecto a git y los secretos del repositorio de GitHub. Si no tienes acceso para configurarlos, comunícate con el responsable del repositorio.

Admitimos dos tipos de acciones de GitHub:

  1. Automatizar las notificaciones de solicitudes de extracción de GitHub en Asana: Con esta acción se generan comentarios sobre el estado de las solicitudes de extracción en la tarea de Asana. Se incluye el título de la solicitud de extracción y un enlace a la tarea asociada de Asana. Para configurarlo, consulta la página de acciones de GitHub.
  2. Conectar los adjuntos de las descripciones de las solicitudes de extracción de GitHub con Asana: Con esta acción se conecta automáticamente cada solicitud de extracción de GitHub con las tareas de Asana. Es decir, se agregan las URL de las tareas de Asana a la descripción de la solicitud de extracción. Para configurarlo, consulta la página de acciones de GitHub.

De un modo similar a lo que sucede con otras acciones de GitHub, solamente funcionarán cuando se produzca un evento en el repositorio para el que hayas configurado las acciones. Por ejemplo, puedes configurar una acción para que se active cada vez que alguien combine o comente en una solicitud de extracción.

Cada una de estas acciones de GitHub se debe configurar por separado, a menos que haya varias acciones idénticas en el mismo repositorio. Por ejemplo, puedes configurar una acción para que se emita un comentario sobre la tarea en la descripción de la solicitud de extracción cada vez que se complete una prueba, y otra acción para agregar otro comentario en la tarea cuando la solicitud de extracción se combina con otra.

Las acciones de GitHub también se pueden agregar como parte de un flujo de trabajo que ya existe. Para más información, consulta la guía de recursos sobre acciones de GitHub.

Cómo revocar tokens secretos

Si configuras las acciones de GitHub según la sección anterior, podrás revocar los tokens secretos, consulta esta página de configuración y selecciona Revoke all (Revocar todo).

De este modo, se revocarán todos los tokens secretos de acciones de GitHub.

Aún podrás ver la información de la solicitud de extracción en el proyecto de Asana para el que has creado la integración.

Funcionalidad clave

Cómo adjuntar una solicitud de extracción a una tarea de Asana (en Asana):

Después de instalar la integración con GitHub en Asana, en todas las tareas del proyecto asociado verás un campo de GitHub.

Campo de GitHub en una tarea

Para adjuntar una solicitud de extracción a una tarea de Asana, copia la URL de la solicitud de extracción y pégala en el campo vacío de GitHub. Ahora, debería aparecer un widget en la tarea de Asana con los siguientes detalles: el estado de revisión, el de construcción (Build), el de la PR (solicitud de extracción), los cambios de línea y la cantidad de conversaciones de GitHub.

Enlace de solicitud de extracción de GitHub

Cómo adjuntar una solicitud de extracción a una tarea de Asana (en GitHub):

Después de instalar la integración de GitHub en Asana y de configurar las acciones de GitHub, ahora, puedes adjuntar automáticamente una solicitud de extracción a una tarea de Asana desde la descripción de una solicitud de extracción de GitHub.

Descripción de solicitud de extracción de GitHub

En la descripción de la solicitud de extracción de GitHub, obtienes la URL de la tarea de Asana. Pégala en la descripción. Ahora, debería aparecer un widget, al ver la tarea de Asana, con los siguientes detalles: el estado de revisión, el de construcción (Build), el de la PR (solicitud de extracción) y los cambios de línea.

Cualquier error se debería ver reflejado en la pestaña de acciones de GitHub dentro de GitHub.

Cómo recibir actualizaciones sobre las combinaciones y los cierres de las solicitudes de extracción:

Las solicitudes de extracción se pueden cerrar en GitHub después de que el equipo correspondiente haya revisado y combinado los cambios. El estado se actualizará automáticamente en el widget de Asana.

Si quieres adjuntar una solicitud de extracción nueva de GitHub, puedes agregar la URL de la tarea de Asana en la descripción de la nueva solicitud de extracción de GitHub y el widget se reemplazará automáticamente, o puedes eliminar la solicitud de extracción cerrada en Asana haciendo clic en el menú de arriba a la derecha. Una vez eliminada, puedes colocar la URL de la nueva solicitud de extracción de GitHub.

Después de instalar la integración de GitHub en Asana y de configurar las acciones de GitHub, recibirás comentarios en las tareas de Asana que tengan solicitudes de extracción abiertas adjuntas. Estos comentarios incluirán actualizaciones sobre si las solicitudes de extracción se han combinado o cerrado.

actualizaciones

Preguntas frecuentes

  • ¿El mismo secreto generado se puede usar en varios repositorios a la vez?
  • ¿Mis compañeros de trabajo pueden ver la información sobre las solicitudes de extracción que adjunto a una tarea de Asana, aunque no tengan acceso a la solicitud de extracción?
    • Sí. Cuando adjuntas una solicitud de extracción a una tarea, todos los que pueden ver la tarea también ven la información del widget.
  • ¿Si genero un token nuevo se desactiva el token secreto anterior?
    • No, los tokens secretos anteriores seguirán funcionando. Si quieres desactivar tokens secretos, puedes hacerlo aquí.
  • ¿El mismo secreto generado se puede usar en varios repositorios?
  • Cuando intentamos extraer el archivo de flujo de trabajo, git dice que mi token no tiene acceso para crear flujos de trabajo. ¿Qué debería hacer?
    • Si usas la autenticación de dos factores en interacción con GitHub en la línea de comandos, GitHub necesitará que uses tu token de acceso personal como contraseña. Crea un token nuevo de acceso personal de GitHub con el alcance del flujo de trabajo.
  • ¿Cómo solicitamos estos permisos de GitHub?
    • Solamente leemos y escribimos a partir de solicitudes de extracción que se encuentran en esta integración. El permiso de la página de autenticación es el más restrictivo que podemos pedir en GitHub para acceder a las solicitudes de extracción.
  • ¿Qué sucede si la acción de GitHub adjunta una solicitud de extracción a una tarea de un proyecto que no tiene la integración activada?
    • En la sección de comentarios de la tarea se podrá ver un adjunto vinculado a la solicitud de extracción, pero el widget que sincroniza el estado de la solicitud no aparecerá.

Lo sentimos, este navegador no es compatible

Asana no funciona con el navegador de internet que utilizas actualmente. Regístrate utilizando uno de estos navegadores compatibles.

Elige el idioma

Al seleccionar un idioma, este cambia y también puede cambiar el contenido en asana.com.