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 2022 | Azure DevOps Server 2019

En este artículo, aprenderá a vincular elementos de trabajo a confirmaciones, solicitudes de incorporación de cambios y ramas de GitHub después de conectar el proyecto de Azure Boards con un repositorio de GitHub. Se puede usar la sintaxis #mention para confirmaciones y ramas o añadir una confirmación GitHub, una solicitud o un enlace de rama directamente desde el elemento de trabajo de Azure Boards.

Nota:

Con la aplicación Azure Boards para GitHub, Azure Boards y Azure DevOps Services se integran con repositorios de GitHub.com y GitHub Enterprise Server. Azure DevOps Server 2019 y versiones posteriores admiten la integración solo con repositorios de GitHub Enterprise Server. No se admite la integración con otros repositorios de Git.

Requisitos previos

Categoría Requisitos
Permisos Colaborador tanto en el proyecto de Azure Boards como en el repositorio de GitHub.
Conexiones 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.

Nota:

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

Desde una confirmación, solicitud de incorporación de cambios o problema de GitHub, use la siguiente sintaxis para crear un vínculo al elemento de trabajo de 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 una propuesta, introduzca el AB#ID dentro del título o la descripción. El uso de AB#ID en un comentario no creará 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 .

Importante

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 Acción
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.

Nota:

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#, esos vínculos aparecen en la sección Desarrollo de la solicitud de incorporación de cambios.

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 desde el que desee 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 y seleccione el repositorio de GitHub y la rama base.

  4. Seleccione 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 a la pestaña Vínculos.

    Captura de pantalla del formulario de elemento de trabajo, pestaña Vínculos, Agregar vínculo a problema.

  2. En el cuadro de diálogo Agregar vínculo, seleccione uno de los tipos de vínculo de GitHub, seleccione un repositorio de GitHub, escriba la dirección URL de la rama, confirmación o solicitud de incorporación de cambios de GitHub y, a continuación, seleccione Agregar vínculo.

    En el ejemplo siguiente, se agrega un vínculo a una solicitud de incorporación de cambios de GitHub.

    Captura de pantalla del formulario de elemento de trabajo, pestaña Vínculos, cuadro de diálogo Agregar vínculo, tipo de vínculo de solicitud de incorporación de cambios de GitHub seleccionado.

    Azure Boards completa una comprobación para asegurarse de 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.

Nota:

Hay un retraso al completar los vínculos AB# si usa Azure DevOps Server y GitHub Enterprise Server. Tenemos un diseño de "inserción y extracción" para extraer de los eventos de GitHub cada hora los cambios incrementales en Confirmar, Solicitud de cambios y Incidencia.

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

Evento de GitHub Acción
Vínculo a la rama Cuando se crea una solicitud de incorporación de cambios desde una rama, se vincula automáticamente al elemento de trabajo.
Confirmación de combinación Una vez combinada la solicitud de incorporación de cambios, la confirmación 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 Desarrollo del formulario del elemento de trabajo se enumeran los vínculos creados a confirmaciones de GitHub y solicitudes de incorporación de cambios con el icono de GitHub .

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

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

Visualización de objetos de GitHub en un panel

Con las anotaciones de GitHub habilitadas en el panel, puede abrir rápidamente confirmaciones, solicitudes de incorporación de cambios o propuestas de GitHub vinculadas 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