Instalación de la aplicación Azure Boards para GitHub

  • Artículo

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

Instale la aplicación Azure Boards para GitHub para conectar Azure Boards a los repositorios de GitHub. Cuando conecta proyectos de Azure Boards con repositorios de GitHub.com, habilita la vinculación entre las confirmaciones de GitHub, las solicitudes de incorporación de cambios de elementos de trabajo. Puede usar GitHub para el desarrollo de software y Azure Boards para planificar el trabajo y realizar su seguimiento.

Para información general sobre la integración que admite la aplicación Azure Boards para GitHub, consulte Integración de Azure Boards con GitHub. Una vez instalada la aplicación Azure Boards para GitHub en su cuenta u organización de GitHub, elija a qué repositorios de GitHub desea conectarse por medio del proyecto.

Requisitos previos

Permisos:

  • Debe ser un administrador o propietario de la organización de GitHub para instalar la aplicación Azure Boards.
  • Debe tener permisos de lectura para el repositorio de GitHub.
  • Debe ser miembro del grupo Administradores de la colección de proyectos. Si ha creado el proyecto, ya tiene estos permisos.

Importante

Si el repositorio ya está conectado a través de otro tipo de autenticación, como OAuth, deberá eliminar ese repositorio de la conexión existente antes de volver a conectarlo a través de la aplicación de GitHub. Siga los pasos que se indican en Agregar o quitar repositorios de GitHub que encontrará más adelante en este artículo antes de configurar la aplicación de GitHub.

Puede conectar una organización de Azure DevOps a varios repositorios de GitHub si es administrador de esos repositorios. Sin embargo, no debe conectar un repositorio de GitHub a más de una organización de Azure DevOps.

Dar acceso a la organización a Azure Boards

Para conceder acceso de GitHub a la organización de Azure DevOps, siga estos pasos.

  1. En el portal web de GitHub, abra Configuración en el menú del perfil.

    Captura de pantalla del perfil abierto, opción Configuración elegida.

  2. Seleccione Aplicaciones en Integraciones.

  3. Seleccione Aplicaciones de GitHub autorizadas>Azure Boards.

    Captura de pantalla de la pestaña Aplicaciones de OAuth autorizadas, opción Azure Boards elegida.

  4. En Acceso de organización, resuelva cualquier problema que pueda aparecer. Seleccione Conceder para conceder acceso a las organizaciones que se muestran con una Solicitud de acceso pendiente.

    Captura de pantalla de Acceso a la organización con organizaciones sin acceso.

Instalación y configuración de la aplicación Azure Boards

  1. Vaya a la aplicación Azure Boards en el Marketplace de GitHub.

  2. Seleccione Crear un plan.

    Captura de pantalla de Marketplace de GitHub, botón Configurar un plan.

  3. Elija la organización de GitHub que desea conectar a Azure Boards.

    Captura de pantalla que muestra el cuadro de diálogo Instalar Azure Boards.

  4. Elija los repositorios que desee conectar a Azure Boards.

    En el ejemplo siguiente, se decide conectarse a todos los repositorios.

    Captura de pantalla que muestra todos los repositorios seleccionados.

  5. Elija la organización de Azure DevOps y el proyecto de Azure Boards que desee conectar a GitHub.com.

    Captura de pantalla del cuadro de diálogo de configuración de conexión.

    Solo se puede conectar un proyecto a la vez. Si tiene otros proyectos para conectar, puede hacerlo más adelante, como se describe en Configuración de otros proyectos o repositorios más adelante en este artículo.

  6. Para conectar con GitHub.com, autorice su organización Azure Boards.

    Captura de pantalla del cuadro de diálogo de autorización de Azure Boards.

  7. Confirme los repositorios de GitHub.com que desea conectar. Seleccione los repositorios a los que quiera conectarse. Anule la selección de los repositorios que no quiera que se integren.

    Captura de pantalla del cuadro de diálogo Confirmar los repositorios de GitHub.

Use la conexión.

En este momento, la integración de Azure Boards con GitHub es completa. Puede ignorar los siguientes pasos o pasar por ellos para conocer las funciones compatibles con la conexión.

  1. En el panel, seleccione Nuevo elemento de trabajo para escribir un nuevo elemento de trabajo denominado "Add badge to README": Problema (Basic), Caso de usuario (Agile) o Elemento de trabajo pendiente del producto (Scrum), según el modelo de proceso usado por el proyecto de Azure Boards.

    Aparece un elemento de trabajo llamado Add badge to README en el panel.

  2. Abra el elemento de trabajo, vaya a la sección Desarrollo y seleccione Agregar vínculo.

  3. Seleccione Solicitud de incorporación de cambios de GitHub en el menú desplegable de tipo vínculo.

  4. Seleccione el repositorio y escriba el ID de la solicitud de incorporación de cambios y deje un comentario de forma opcional.

  5. Seleccione Agregar vínculo.

    Captura de pantalla de la acción Agregar vínculo en el caso del usuario, en la que se muestran los cuadros de selección del repositorio y los cuadros vacíos para la entrada del identificador de solicitud de incorporación de cambios y el comentario opcional.

    Las siguientes acciones se producen automáticamente en segundo plano:

    • Agrega una notificación al archivo LÉAME del primer repositorio de la lista de repositorios de GitHub conectados.
    • Crea una confirmación de GitHub para la actualización realizada agregando la notificación al archivo LÉAME.
    • Crea una solicitud de incorporación de cambios de GitHub para combinar los cambios realizados en el archivo LÉAME.
    • Vincula la confirmación y la solicitud de incorporación de cambios de GitHub al elemento de trabajo creado en el paso 1.

  6. Seleccione el primer vínculo de solicitud de incorporación de cambios del elemento de trabajo.

    Captura de pantalla del formulario de problema para la solicitud de incorporación de cambios abierta en GitHub.

    La solicitud de incorporación de cambios de GitHub se abre en una nueva pestaña del explorador.

  7. Seleccione Merge pull request (Combinar solicitud de incorporación de cambios).

    Captura de pantalla de un ejemplo de solicitud de incorporación de cambios en GitHub.

  8. Vaya al archivo README de su repositorio y vea el distintivo que se haya agregado.

    Captura de pantalla del repositorio de GitHub con el distintivo agregado.

    Para obtener más información, consulte Configurar distintivos de estado para agregarlos a los archivos README de GitHub.

Configuración de otros proyectos o repositorios

Puede configurar otros repositorios de Azure Boards/Azure DevOps Projects o GitHub.com, o cambiar la configuración actual desde la página de la aplicación de Azure Boards. Para más información, consulte Cambio del acceso al repositorio de GitHub o suspensión o desinstalación de la integración.

Añadir o eliminar repositorios o eliminar una conexión de Azure Boards

Si se produce un problema con una conexión, se recomienda eliminar la conexión y empezar de nuevo.

  1. En el proyecto en Azure DevOps, vaya a Configuración del proyecto>Conexiones de GitHub.

  2. Para agregar o eliminar repositorios, seleccione los puntos suspensivos de Más opciones para la conexión y seleccione Agregar repositorios o Eliminar repositorios en el menú.

    Captura de pantalla del menú de conexión de GitHub Más opciones.

  3. Para eliminar todos los repositorios y la conexión, elija la opción Quitar conexión. A continuación, elija Quitar para confirmar.

    Captura de pantalla de la confirmación de eliminación de la conexión de GitHub.

  1. Para agregar o eliminar repositorios, abra el icono de acciones de la conexión y seleccione Agregar repositorios o Eliminar repositorios en el menú.

    Captura de pantalla de la adición o eliminación de repositorios de GitHub.

  2. Para eliminar todos los repositorios y la conexión, elija la opción Quitar conexión. A continuación, elija Quitar para confirmar.

    Captura de pantalla del cuadro de diálogo de confirmación de eliminación de la conexión de GitHub.

Cambio del acceso al repositorio

  1. Inicie sesión en GitHub y abra la configuración del perfil de la organización.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Vaya a Aplicaciones instaladas de GitHub>Azure Boards>Configurar
    Captura de pantalla de Cuenta de organización abierta, Aplicaciones de GitHub instaladas, Azure Boards y Configuración.

    Se abrirá la página de configuración de Azure Boards.

  3. Desplácese hacia abajo hasta la sección Acceso al repositorio.

  4. Elija la opción que desee, Todos los repositorios o Solo ciertos repositorios.

    Si elige Solo ciertos repositorios, seleccione los repositorios que desea que participen en la integración con Azure Boards.

    Captura de pantalla del acceso al repositorio, opción Solo ciertos repositorios elegida.

  5. Seleccione Guardar.

Suspensión o desinstalación de la integración de Azure Boards

  1. A partir del paso 2 del procedimiento anterior, desplácese hacia abajo hasta la sección Zona de peligro.

    Captura de pantalla de Configuración de Azure Boards, sección Zona de peligro.

  2. Para suspender la integración, elija Suspender. En la ventana de confirmación emergente, elija Aceptar para confirmar la suspensión.

    Captura de pantalla de la confirmación de suspensión.

    Para anular la suspensión de la integración, elija Anular la suspensión.

  3. Para desinstalar la aplicación Azure Boards, elija Desinstalar y Aceptar en la ventana de confirmación emergente.

    Captura de pantalla de la confirmación de desinstalación.

Actualizar las conexiones de GitHub de Azure Boards

Si cambia los repositorios que admite la aplicación Azure Boards para GitHub, es posible que se le redirija a las conexiones de GitHub de Azure Boards. Un procedimiento recomendado es quitar los repositorios de Azure Boards que ya no se puedan conectar a GitHub. Para obtener más información, consulte Añadir o eliminar repositorios de GitHub.

Si desinstala la aplicación Azure Boards para GitHub, aparecerá el siguiente mensaje en Azure Boards, Configuración del proyecto>Conexiones de GitHub. Elija Eliminar conexión para quitar todas las conexiones de GitHub realizadas anteriormente. Para obtener más información, consulte Añadir/eliminar repositorios de GitHub.

Captura de pantalla de la aplicación Azure Boards con GitHub desinstalada.

Pasos siguientes

Vínculo de confirmaciones y solicitudes de incorporación de cambios de GitHub a los elementos de trabajo