Compartir a través de

Vinculación de confirmaciones, solicitudes de incorporación de cambios, ramas e incidencias de GitHub con elementos de trabajo en Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

En este artículo, aprenderá a vincular elementos de trabajo a confirmaciones, solicitudes de incorporación de cambios, ramas y compilaciones después de conectar el proyecto de Azure Boards con un repositorio de GitHub. Puede usar la sintaxis de #mention para confirmaciones y ramas, usar ! menciones para hacer referencia a solicitudes de incorporación de cambios de GitHub de discusiones de elementos de trabajo o agregar un vínculo de confirmación, solicitud de incorporación de cambios o rama de GitHub directamente desde el elemento de trabajo de Azure Boards.

Note

Compatibilidad con la integración de GitHub:

  • Azure DevOps Services: se integra tanto con repositorios de GitHub.com como con GitHub Enterprise Server a través de la aplicación Azure Boards para GitHub.
  • Azure DevOps Server 2020 y versiones posteriores: solo admite la integración con repositorios de GitHub Enterprise Server.
  • Otros repositorios de Git: no se admite la integración.

Prerequisites

Category Requirements
Permissions Colaborador tanto en el proyecto de Azure Boards como en el repositorio de GitHub.
Conexión de proyecto El proyecto Azure Boards está conectado al repositorio de GitHub donde existen los commits, pull requests y la rama a la que quieres enlazar o desde la que quieres enlazar. Para obtener más información, consulte Integración de Azure Boards y GitHub.

Note

Para ver la sección Desarrollo y los tipos de vínculo de GitHub, los proyectos que usan el modelo de proceso XML hospedado requieren actualizaciones de los tipos de elemento de trabajo. Para obtener más información, consulte Actualización de las definiciones XML para tipos de elementos de trabajo elegidos.

Desde una confirmación en GitHub, un pull request o un issue, use la siguiente sintaxis para crear un enlace al elemento de trabajo en Azure Boards. Escriba AB#ID dentro del texto de un mensaje de confirmación. O bien, para una solicitud de incorporación de cambios o un problema, introduzca el AB#ID en la descripción. El uso de AB#ID en un comentario o un título de solicitud de incorporación de cambios no crea un vínculo en el elemento de trabajo.

AB#{ID}

Por ejemplo, AB#125 enlaza con el ID del elemento de trabajo 125.

También puede escribir un mensaje de confirmación o pull request para transicionar el elemento de trabajo. El sistema reconoce {state} o {state category}, junto con fix, fixes, fixedy lo aplica al elemento #-mention siguiente.

Cuando una descripción de la solicitud de incorporación de cambios incluye un nombre de estado válido, por ejemplo, Closed AB#1234, el sistema actualiza el elemento de trabajo al que se hace referencia a ese estado específico. Si el nombre de estado no se reconoce directamente, Azure Boards intenta coincidir con una categoría de flujo de trabajo como Resolved o Completed. Si se encuentra una coincidencia, el elemento de trabajo pasa al primer estado disponible definido en esa categoría.

De forma predeterminada, los elementos de trabajo a los que se hace referencia con fix, fixeso fixed pasan al primer estado asociado a la categoría Resuelto . Si no existe este estado en el proceso actual, el sistema pasa el elemento de trabajo al primer estado de la categoría Completado .

Important

Todavía puede vincular elementos de trabajo y dirigir otras ramas, pero las reglas de transición de estado no se aplican a menos que se fusione el pull request en la rama predeterminada.

Para obtener más información, consulte Uso de los estados de flujo de trabajo y las categorías de estado en trabajos pendientes y paneles de Azure Boards.

Consulte la tabla siguiente de ejemplos:

Mensaje de confirmación o solicitud de incorporación de cambios Action
Fixed AB#123 Vincula y realiza la transición del elemento de trabajo al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Closed AB#123 Vincula y cambia el elemento de trabajo al estado Cerrado del flujo de trabajo. Si no se define ninguno, no se realiza ninguna transición.
Adds a new feature, fixes AB#123. Vincula y realiza la transición del elemento de trabajo al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Fixes AB#123, AB#124, and AB#126 Vínculos a los elementos de trabajo 123, 124 y 126 de Azure Boards. Solo realiza la transición del primer elemento, 123, al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Fixes AB#123, Fixes AB#124, Fixes AB#125 Vínculos a los elementos de trabajo 123, 124 y 126 de Azure Boards. Realiza la transición de todos los elementos al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Fixing multiple bugs: issue #123 and user story AB#234 Vínculos al problema 123 de GitHub y al elemento de trabajo 234 de Azure Boards. No se realiza ninguna transición.

Note

Si ha conectado el mismo repositorio de GitHub a proyectos definidos en dos o más organizaciones de Azure DevOps, podría ver menciones AB# vinculadas inesperadamente. Para obtener más información, consulte Resolución de problemas de conexión. Por este motivo, se recomienda conectar solo un repositorio de GitHub a los proyectos definidos en una sola organización de Azure DevOps.

Al agregar un vínculo a un elemento de trabajo mediante AB# en una descripción de la solicitud de incorporación de cambios, esos vínculos aparecen en la sección Desarrollo de la solicitud de incorporación de cambios de GitHub. Estos vínculos solo están disponibles cuando se usa AB# en la descripción de la solicitud de incorporación de cambios. No aparecen si vinculas a la solicitud de incorporación de cambios directamente desde el elemento de trabajo. Al quitar la referencia AB# de la descripción, también se quita de la sección Desarrollo.

Captura de pantalla de los enlaces AB# en la sección de desarrollo del pull request de GitHub.

Creación de una rama de GitHub a partir de un elemento de trabajo

Para crear una rama de GitHub directamente desde un elemento de trabajo, siga estos pasos:

  1. En el panel, busque el elemento de trabajo que desea usar para crear una rama de GitHub.

  2. Seleccione Acciones de elemento de trabajo>Nueva rama de GitHub.

    Captura de pantalla del elemento de trabajo con más acciones seleccionadas y resaltada la opción de nueva rama de GitHub.

  3. En el cuadro de diálogo Crear una rama de GitHub , escriba el nombre de la rama. Seleccione el repositorio de GitHub y la rama base.

  4. Selecciona Crear.

    Captura de pantalla del cuadro de diálogo Crear una rama de GitHub.

    Azure Boards crea la rama en el repositorio de GitHub especificado y lo vincula al elemento de trabajo. Para obtener más información, consulte Integración de Azure Boards y GitHub.

  1. Abra el elemento de trabajo y vaya al área Desarrollo .

  2. Seleccione Agregar vínculo. En cada menú desplegable, seleccione el tipo de vínculo, el repositorio de GitHub y la solicitud de incorporación de cambios de GitHub. Puede buscar y explorar en profundidad dentro del repositorio para buscar y seleccionar una solicitud de incorporación de cambios o confirmación específicas, sin necesidad de copiar y pegar una dirección URL.

  3. Seleccione Agregar vínculo.

    Captura de pantalla que muestra la secuencia de cinco pasos para agregar un vínculo de solicitud de incorporación de cambios al elemento de trabajo.

    Azure Boards comprueba que ha escrito un vínculo válido. El repositorio vinculado a GitHub debe estar conectado al proyecto de Azure Boards o se producirá un error en la validación.

Note

Si usa Azure DevOps Server y GitHub Enterprise Server, existe un retraso al completar los vínculos AB#. El proceso utiliza un diseño de "push-and-pull" para extraer de los eventos de GitHub cada hora sobre los cambios incrementales de Commit, PR e Issue.

Varios eventos actualizan automáticamente los vínculos en el formulario de elemento de trabajo, por lo que no es necesario crearlos manualmente. Estos eventos incluyen:

Evento de GitHub Action
Vínculo a la rama Cuando se crea una solicitud de incorporación de cambios a partir de una rama, se vincula automáticamente al elemento de trabajo.
Confirmación de combinación Una vez que se fusiona el pull request, el commit de combinación resultante se vincula automáticamente al elemento de trabajo.
Eliminar rama Si la rama se elimina (normalmente después de la combinación), su vínculo se quita automáticamente del elemento de trabajo.

En la sección de Desarrollo del formulario del elemento de trabajo, se enumeran los vínculos creados a las confirmaciones y pull requests de GitHub utilizando el icono de GitHub.

Captura de pantalla del formulario de elemento de trabajo, sección Desarrollo donde se muestran los vínculos de GitHub.

Seleccione el vínculo para abrir la solicitud de confirmación o incorporación de cambios en GitHub.

Información de solicitud de incorporación de cambios de GitHub

Las solicitudes de incorporación de cambios de GitHub vinculadas en la sección Desarrollo muestran detalles de estado adicionales, por lo que puede evaluar el progreso sin abrir la solicitud de incorporación de cambios en GitHub.

Requisitos previos para análisis de pull requests

Para ver información de solicitudes de incorporación de cambios, vaya a la aplicación Azure Boards en GitHub y acepte los permisos actualizados para el acceso de lectura y escritura a Comprobaciones.

Captura de pantalla del cuadro de diálogo de permisos de la app de Azure Boards en GitHub que muestra los permisos de verificaciones actualizados.

Visualización de los detalles del estado de la solicitud de incorporación de cambios

  1. Abra un elemento de trabajo que tenga una solicitud de incorporación de cambios de GitHub vinculada.

  2. En la sección Desarrollo , busque la solicitud de incorporación de cambios vinculada. Los siguientes detalles de estado aparecen junto al vínculo de solicitud de incorporación de cambios:

    • Estado del borrador: muestra si la solicitud de incorporación de cambios sigue siendo un borrador.
    • Estado de revisión: muestra si la solicitud de incorporación de cambios necesita revisión, se ha aprobado o ha solicitado cambios.
    • Comprueba el estado: muestra si las comprobaciones de CI pasan, producen errores o están pendientes.

    Captura de pantalla de la sección de Desarrollo que muestra un pull request de GitHub vinculado con indicadores detallados de estado: cerrado, en revisión y en comprobación.

  3. Mantenga el puntero sobre un indicador de estado para ver más detalles o seleccione el vínculo de solicitud de incorporación de cambios para abrirlo directamente en GitHub.

Mencionar las solicitudes de incorporación de cambios de GitHub mediante !

Use ! menciones para hacer referencia y analizar las solicitudes de incorporación de cambios de GitHub directamente desde cualquier campo de texto enriquecido o comentario de discusión del elemento de trabajo. Al escribir ! en un campo de texto, aparece un selector que puede usar para buscar y seleccionar una solicitud de incorporación de cambios de GitHub de un repositorio conectado. La solicitud de incorporación de cambios seleccionada se inserta como un vínculo en el que se puede hacer clic.

Esta característica facilita la referencia a solicitudes de extracción relacionadas en descripciones de elementos de trabajo, criterios de aceptación o hilos de discusión, sin necesidad de copiar manualmente las URLs.

Gif que muestra cómo usar: ! mención para referenciar una solicitud de incorporación de cambios de GitHub desde una conversación sobre un elemento de trabajo.

Visualización del estado de compilación de las canalizaciones YAML (integrada en la compilación)

Cuando utiliza YAML de Azure Pipelines para compilar código hospedado en un repositorio de GitHub, puede crear automáticamente vínculos Integrado en la compilación en los elementos de trabajo asociados. Esta característica proporciona rastreabilidad de compilación para los Repositorios de GitHub, logrando la paridad con la experiencia disponible para Azure Repos.

Para habilitar esta característica:

  1. Abra la canalización de YAML, seleccione Más acciones y, a continuación, seleccione Configuración.

  2. En el cuadro de diálogo de configuración de canalización, habilite vincular automáticamente nuevos elementos de trabajo en esta compilación.

    Captura de pantalla del cuadro de diálogo de configuración de la canalización YAML que muestra la opción Vincular automáticamente nuevos elementos de trabajo en esta compilación.

Cuando finaliza la compilación, un vínculo Integrado en la compilación aparece automáticamente en la sección Desarrollo de cada elemento de trabajo asociado, lo que proporciona al equipo una rastreabilidad completa desde el elemento de trabajo hasta la compilación.

Captura de pantalla del elemento de trabajo que muestra el vínculo integrado en la compilación en la sección Desarrollo.

Para obtener más información sobre cómo configurar esta configuración, consulte Configuración de canalizaciones para admitir el seguimiento del trabajo.

Visualización de objetos de GitHub en un panel

Al habilitar anotaciones de GitHub en la placa, puede abrir rápidamente confirmaciones de GitHub vinculadas, solicitudes de incorporación de cambios o problemas para obtener más detalles. Para obtener más información, consulte Personalización de tarjetas.

Captura de pantalla del panel que muestra vínculos de GitHub en tarjetas de elementos de trabajo.

Pasos siguientes

Configurar notificaciones de estado

Contenido relacionado

  • Last updated on