Vinculación de GitHub a Azure Boards
La integración entre GitHub y Azure Boards crea un enfoque híbrido eficaz que combina el entorno fácil de desarrolladores de GitHub con las funcionalidades de planeamiento empresarial de Azure Boards. Esta conexión permite a las organizaciones mantener la gobernanza centralizada del proyecto, al tiempo que permite a los equipos de desarrollo trabajar en su entorno de GitHub preferido.
Ventajas empresariales de la integración:
- Visibilidad unificada: las partes interesadas pueden realizar un seguimiento del progreso del desarrollo sin acceder directamente a GitHub.
- Cumplimiento y auditoría: mantener el seguimiento formal del proyecto al tiempo que se conservan los flujos de trabajo del desarrollador.
- Colaboración entre funciones: puentee la brecha entre los administradores de proyectos y los equipos de desarrollo
- Sincronización automatizada: reducir la sobrecarga manual para mantener el estado del proyecto actual
Aplicación Azure Boards: la base de integración
La aplicación azure Boards actúa como puente técnico que permite el flujo de datos sin problemas entre GitHub y Azure Boards. Esta aplicación de Marketplace proporciona acceso seguro y autenticado al tiempo que mantiene la integridad de ambas plataformas.
Funcionalidades de integración clave:
- Vinculación bidireccional: conexión de elementos de trabajo de Azure Boards con confirmaciones, solicitudes de incorporación de cambios y problemas de GitHub
- Transiciones de estado automatizadas: complete los elementos de trabajo cuando las menciones de GitHub incluyan palabras clave como "correcciones".
- Sincronización en tiempo real: los cambios en GitHub se reflejan inmediatamente en Azure Boards
- Control de ámbito flexible: elija la integración de repositorios selectivos o de toda la organización.
Requisitos y permisos de instalación
Requisitos previos de GitHub:
- Acceso al repositorio: permisos de administrador o propietario para repositorios de destino
- Permisos de la organización: rol de propietario para instalaciones de toda la organización
- Acceso a Marketplace: capacidad de instalar aplicaciones desde GitHub Marketplace
Requisitos previos de Azure DevOps:
- Administrador de la colección de proyectos: necesario para la configuración de la conexión inicial
- Permisos de proyecto: acceso de partes interesadas o superior para ver elementos de trabajo vinculados
- Credenciales de autenticación: PAT o OAuth para el acceso seguro a la API
Consideraciones de autenticación y seguridad
La autenticación segura es fundamental para mantener la integridad de los datos y el control de acceso en ambas plataformas. Azure Boards admite varios métodos de autenticación, cada uno con implicaciones de seguridad y casos de uso específicos.
Opciones de autenticación de GitHub:
| Método | Nivel de seguridad | Mejor para | Consideraciones |
|---|---|---|---|
| Token de acceso personal | High | Integraciones automatizadas, CI/CD | Requiere una gestión cuidadosa del alcance |
| Nombre de usuario y contraseña | Medio | Conexiones de usuario individuales | Menos seguro, no recomendado para prod |
| Aplicaciones de OAuth | High | Integraciones para toda la organización | Administración centralizada del acceso |
Procedimientos recomendados de seguridad:
- Principio de privilegios mínimos: conceda solo los permisos necesarios para la funcionalidad de integración.
- Rotación de tokens: actualice periódicamente los PAT y revise los permisos de acceso.
- Registro de auditoría: Supervisión de la actividad de integración en busca de patrones de acceso inusuales
- Aislamiento de repositorio: conexión solo a repositorios que requieren integración de Azure Boards
Proceso de conexión paso a paso:
- Instalación de la aplicación de Azure Boards desde Marketplace de GitHub
- Configurar el acceso al repositorio (todos los repositorios o selectivos)
- Autenticación con Azure DevOps mediante el método preferido
- Asignación de repositorios a proyectos en Azure Boards
- Prueba de la integración con vínculos y confirmaciones de ejemplo
Para obtener instrucciones detalladas sobre la implementación, consulte Conexión de Azure Boards a GitHub.
Flexibilidad y administración de la configuración
Funcionalidades de administración del lado de GitHub:
- Control de ámbito del repositorio: agregar o quitar repositorios específicos de la integración
- Mapeo de proyectos: configuración de los proyectos de Azure Boards que se conectan a cada repositorio
- Suspensión de integración: deshabilitar temporalmente sin perder la configuración
- Eliminación completa: desinstalación de la aplicación y eliminación de todas las conexiones
Capacidades de administración en Azure Boards:
- Conexiones de varios repositorios: vinculación de varios repositorios de GitHub a proyectos únicos
- Vinculación entre proyectos: permitir que los repositorios se conecten a varios proyectos de Azure Boards
- Supervisión del estado de conexión: seguimiento del estado de integración y resolución de problemas de conectividad
- Administración de permisos: controlar qué usuarios pueden modificar las conexiones de GitHub
Escenarios de integración admitidos
La integración de Azure Boards-GitHub admite las siguientes conexiones:
Desde GitHub:
- Compatibilidad con la integración de todos los repositorios de una cuenta u organización de GitHub, o bien de repositorios seleccionados.
- Agregue o quite repositorios de GitHub que participan en la integración y configure el proyecto al que se conectan.
- Suspenda la integración de Azure Boards-GitHub o desinstale la aplicación.
Desde Azure Boards:
- Conecte uno o varios repositorios de GitHub a un proyecto de Azure Boards.
- Agregue o quite repositorios de GitHub de una conexión de GitHub dentro de un proyecto de Azure Boards.
- Quite completamente una conexión de GitHub para un proyecto.
- Permitir que un repositorio de GitHub se conecte a uno o varios proyectos de Azure Boards dentro de la misma organización o colección de Azure DevOps.
La integración de Azure Boards-GitHub admite las siguientes tareas operativas:
- Crear vínculos entre elementos de trabajo y confirmaciones de GitHub, solicitudes de incorporación de cambios e incidencias en función de menciones de GitHub.
- Admitir la transición de estado de los elementos de trabajo a un estado terminado o completado al usar menciones de GitHub mediante términos seleccionados.
- Admita la rastreabilidad completa publicando un comentario de discusión en GitHub al vincular desde un elemento de trabajo a una confirmación, solicitud de incorporación de cambios o problema de GitHub.
- Mostrar vínculos a artefactos de código de GitHub en la sección Desarrollo de elementos de trabajo.
- Mostrar vínculos a artefactos de GitHub como anotaciones en tarjetas de panel Kanban.
- Se admiten distintivos de estado de las columnas de la placa Kanban agregadas a los repositorios de GitHub.
En este momento no se admiten las siguientes tareas:
- Consulta de elementos de trabajo con vínculos a artefactos de GitHub. Sin embargo, puede consultar elementos de trabajo con un recuento de vínculos externos mayor que 0.
Nota
Consulte: Integración de Azure Boards y GitHub.
Para obtener más información, consulte:
- Cambie el acceso al repositorio de GitHub, o suspenda o desinstale la integración.
- Agregar o quitar repositorios de GitHub.
- Consulte Vinculación de confirmaciones de GitHub, solicitudes de incorporación de cambios e incidencias a elementos de trabajo para obtener más información sobre la vinculación a elementos de trabajo.