Compartir a través de

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

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

En este inicio rápido, instalará 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. Después de instalar la aplicación Azure Boards para GitHub en su cuenta o organización de GitHub, elija a qué repositorios de GitHub quiere conectarse desde el proyecto.

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.

Requisitos previos

Categoría Requisitos
Permisos - Miembro del grupo de Administradores de la colección de proyectos. Si ha creado el proyecto, tener permisos.
- Administrador o propietario de la organización de GitHub para instalar la aplicación Azure Boards.
- Leer permisos de para el repositorio de GitHub.
Miembros del proyecto Miembro del proyecto.

Importante

Si el repositorio ya está conectado mediante otro tipo de autenticación como OAuth, debe quitar ese repositorio de la conexión existente antes de volver a conectarlo mediante 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. No debe conectar un repositorio de GitHub a más de una organización de Azure DevOps.

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

La secuencia de instalación puede variar debido a la configuración de la cuenta. Si es necesario, siga las indicaciones de la pantalla entre los pasos siguientes.

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

  2. En Planes y precios, en Gratis, seleccione Instalar.

  3. En Instalar y autorizar Azure Boards, elija los repositorios que desea conectar a Azure Boards y, a continuación, seleccione Instalar y autorizar.

    En este ejemplo se usan todos los repositorios:

    Captura de pantalla que muestra la página Instalar y autorizar con todos los repositorios seleccionados.

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

    Captura de pantalla que muestra la página configurar el proyecto de Azure Boards, donde se selecciona una organización y un proyecto.

    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.

Dar acceso a la organización a Azure Boards

Si es necesario, para conceder a GitHub acceso a su 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 que muestra la opción Configuración en el perfil.

  2. Seleccione Aplicaciones en Integraciones.

  3. Seleccione Aplicaciones de GitHub autorizadas>Azure Boards.

    Captura de pantalla que muestra las aplicaciones de GitHub autorizadas con Azure Boards resaltadas.

  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 que muestra el acceso de la organización con organizaciones sin acceso.

Comprobación de la directiva de acceso a aplicaciones de terceros

Asegúrese de que la organización de GitHub permite el acceso a aplicaciones de terceros para la aplicación de Azure Boards. Si el acceso de terceros está restringido, agregar repositorios de Azure DevOps puede mostrar una lista vacía o producir un error.

Para habilitar el acceso:

  1. En GitHub, abra la organización y vaya a Configuración Directiva > de aplicación de OAuth.

  2. Apruebe específicamente la aplicación azure Boards (recomendada) o quite restricciones para todas las aplicaciones de terceros.

    Captura de pantalla que muestra la directiva de acceso a aplicaciones de terceros.

Nota:

Debe ser propietario o administrador de la organización para cambiar esta configuración.

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. En Tipo de vínculo, seleccione Solicitud de incorporación de cambios de GitHub.

  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 que muestra la acción Agregar vínculo en la historia de usuario, mostrando la selección del repositorio y cuadros vacíos para ingresar el identificador de solicitud de incorporación de cambios y un 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 que muestra el 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 Solicitud de cambios de mezcla.

    Captura de pantalla que muestra la solicitud de incorporación de cambios de ejemplo en GitHub.

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

    Captura de pantalla que muestra el repositorio de GitHub con el distintivo agregado.

    Para obtener más información, consulte Adición de distintivos de estado para el repositorio 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 Incorporación o eliminación de repositorios o eliminación de una conexión de Azure Boards.

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 que muestra el menú de Más opciones de conexión con GitHub.

  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 que muestra la confirmación de la eliminación de la conexión de GitHub.

Cambio del acceso al repositorio

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

  2. Seleccione Integraciones>Aplicaciones. En Aplicaciones de GitHub instaladas, seleccione Configurar.

    Captura de pantalla que muestra las aplicaciones de GitHub instaladas con Azure Boards y la opción Configurar.

    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 que muestra el acceso al repositorio, donde puede elegir repositorios seleccionados.

  5. Selecciona 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 que muestra la sección Zona de peligro, con opciones para suspender y desinstalar.

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

    Captura de pantalla que muestra el cuadro de diálogo de 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 que muestra el cuadro de diálogo de 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 o eliminar repositorios de GitHub.

Captura de pantalla que muestra la aplicación gitHub de Azure Boards desinstalada.

Pasos siguientes

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

Contenido relacionado

  • Last updated on