Vincular GitHub confirmaciones, solicitudes de extracción y problemas a elementos de trabajo en Azure Boards

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019

Una vez que haya conectado el proyecto Azure Boards con un repositorio de GitHub, puede vincular elementos de trabajo a GitHub confirmaciones y solicitudes de extracción. Puede agregar vínculos mediante la sintaxis #mention conocida para los usuarios de GitHub o agregando un tipo de vínculo de confirmación de GitHub o solicitud de incorporación de cambios GitHub desde el elemento de trabajo Azure Boards trabajo.

Nota

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

Nota

Con la aplicación Azure Boards para GitHub, en Azure DevOps Servers 2019 y versiones posteriores se admite la integración con repositorios de GitHub Enterprise Server. No se admite la integración con otros repositorios de Git.

Requisitos previos

  • El Azure Boards proyecto debe estar conectado al repositorio de GitHub donde existen las confirmaciones y las solicitudes de extracción a las que desea vincular o desde. Para más información, consulte Integración Boards-GitHub Azure.
  • Debe ser colaborador de Azure Boards.
  • Debe ser colaborador del repositorio de GitHub.
  • Si su organización usa el modelo de proceso XML hospedado para personalizar la experiencia de seguimiento de trabajo, deberá actualizar los tipos de elementos de trabajo para vincular y ver los tipos de vínculo de GitHub desde la sección Desarrollo del formulario de elemento de trabajo. Para obtener más información, vea Actualizar definiciones XML para tipos de elementos de trabajo seleccionados.

Desde una GitHub confirmación, solicitud de extracción o problema, use la sintaxis siguiente para crear un vínculo al Azure Boards trabajo. Escriba dentro AB#ID del texto de un mensaje de confirmación. O bien, para una solicitud de extracción o un problema, escriba AB#ID dentro del título o la descripción (no un comentario).

Desde una GitHub confirmación o solicitud de extracción, use la sintaxis siguiente para crear un vínculo al Azure Boards trabajo. Escriba dentro del texto de un mensaje de confirmación o para una solicitud de extracción, escriba dentro del título o la descripción de la solicitud de extracción (no un comentario de AB#IDAB#ID solicitud de extracción).

AB#{ID}

Por ejemplo, AB#125 se vinculará al identificador de elemento de trabajo 125.

También puede escribir un mensaje de confirmación o solicitud de extracción para realizar la transición del elemento de trabajo. El sistema lo fix, fixes, fixed reconocerá y aplicará al elemento #-mention que sigue. Algunos ejemplos se proporcionan como se muestra.

Ejemplos:

Mensaje de confirmación Acción
Fixed AB#123 Vincula y realiza la transición del elemento de trabajo al estado "listo".
Adds a new feature, fixes AB#123. Vincula y realiza la transición del elemento de trabajo al estado "listo".
Fixes AB#123, AB#124, and AB#126 Vínculos Azure Boards los elementos de trabajo 123, 124 y 126. Solo realiza la transición del primer elemento, 123, al estado "listo".
Fixes AB#123, Fixes AB#124, Fixes AB#125 Vínculos Azure Boards los elementos de trabajo 123, 124 y 126. Realiza la transición de todos los elementos al estado "listo".
Fixing multiple bugs: issue #123 and user story AB#234 Vínculos a GitHub problema 123 y Azure Boards de trabajo 234. No hay transiciones.

Nota

Si ha conectado el mismo repositorio GitHub a proyectos definidos en dos o más organizaciones Azure DevOps, es posible que vea una vinculación inesperada de menciones de AB#. Para más información, consulte Solución de GitHub Azure Boards integración. Por esta razón, se recomienda conectar solo un repositorio de GitHub a los proyectos definidos en una sola Azure DevOps organización.

Nota

La vinculación a un GitHub problema requiere Azure DevOps Server 2019 Update 1 o una versión posterior.

  1. Para vincular a una solicitud de confirmación o de extracción, abra el elemento de trabajo y elija Agregar vínculo en la sección Desarrollo.

    Sección Desarrollo, Agregar vínculo

    Para vincular a un problema, elija la pestaña Vínculos y, a continuación, elija Agregar vínculo elemento existente.

    Pestaña Vínculos, Agregar vínculo al problema

  2. En el cuadro de diálogo Agregar vínculo, seleccione uno de los tipos de vínculo GitHub, escriba la dirección URL de la confirmación, la solicitud de extracción o el problema y, a continuación, elija Aceptar.

    Aquí se agrega un vínculo a una solicitud de GitHub de extracción.

    GitHub de vínculo de solicitud de extracción

    Azure Boards completa una comprobación para asegurarse de que ha escrito un vínculo válido. El repositorio vinculado a GitHub debe integrarse con el proyecto o se producirá un error en la validación.

    Aquí, se agrega un vínculo a un GitHub problema.

    Cuadro de diálogo Agregar vínculo, GitHub problema

En la sección Desarrollo del formulario de elemento de trabajo se enumeran los vínculos creados para GitHub y solicitudes de extracción con el icono GitHub trabajo.

La sección desarrollo muestra GitHub vínculos

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

Visualización GitHub objetos en el panel Kanban

Con GitHub anotaciones habilitadas en el panel Kanban, puede abrir rápidamente las confirmaciones de GitHub vinculadas, las solicitudes de extracción o los problemas para obtener más detalles. Para obtener más información sobre cómo habilitar anotaciones, vea Personalizar tarjetas.

El panel Kanban muestra GitHub vínculos

Nota

GitHub anotaciones requieren Azure DevOps Server 2019 Update 1 o una versión posterior.

Pruebe esto a continuación