Lier GitHub à Azure Boards

L’intégration entre GitHub et Azure Boards crée une approche hybride puissante qui combine l’environnement convivial de GitHub avec les fonctionnalités de planification d’entreprise d’Azure Boards. Cette connexion permet aux organisations de maintenir la gouvernance centralisée des projets tout en permettant aux équipes de développement de travailler dans leur environnement GitHub préféré.

Avantages métier de l’intégration :

• Visibilité unifiée : les parties prenantes peuvent suivre la progression du développement sans accéder directement à GitHub
• Conformité et audit : Maintenir le suivi formel des projets tout en préservant les flux de travail des développeurs
• Collaboration interfonctionnelle : combler l’écart entre les responsables de projets et les équipes de développement
• Synchronisation automatisée : réduire la surcharge manuelle pour maintenir l’état du projet actuel

Application Azure Boards : Base d’intégration

L’application Azure Boards sert de pont technique permettant un flux de données fluide entre GitHub et Azure Boards. Cette application de la Place de marché fournit un accès sécurisé et authentifié tout en conservant l’intégrité des deux plateformes.

Fonctionnalités d’intégration clés :

• Liaison bidirectionnelle : connectez des éléments de travail Azure Boards avec des commits GitHub, des demandes de tirage (pull request) et des problèmes
• Transitions d’état automatisées : éléments de travail complets lorsque GitHub mentionne des mots clés tels que des « correctifs »
• Synchronisation en temps réel : les modifications dans GitHub reflètent immédiatement dans Azure Boards
• Contrôle d’étendue flexible : choisir l’intégration de référentiels à l’échelle de l’organisation ou sélective

Conditions requises et autorisations d’installation

Conditions préalables pour GitHub :

• Accès au référentiel : Autorisations d’administrateur ou de propriétaire pour les référentiels cibles
• Autorisations de l’organisation : rôle propriétaire pour les installations à l’échelle de l’organisation
• Accès à la Place de marché : Possibilité d’installer des applications à partir de La Place de marché GitHub

Conditions préalables pour Azure DevOps :

• Administrateur de collection de projets : Requis pour la configuration initiale de la connexion
• Autorisations de projet : Accès des parties prenantes ou supérieur pour afficher les éléments de travail liés
• Informations d’identification d’authentification : PAT ou OAuth pour un accès API sécurisé

Considérations relatives à l’authentification et à la sécurité

L’authentification sécurisée est essentielle pour maintenir l’intégrité des données et le contrôle d’accès sur les deux plateformes. Azure Boards prend en charge plusieurs méthodes d’authentification, chacune ayant des implications de sécurité et des cas d’usage spécifiques.

Options d’authentification GitHub :

Bonnes pratiques en matière de sécurité :

• Principe du privilège minimum : accorder uniquement les autorisations nécessaires pour les fonctionnalités d’intégration
• Rotation des jetons : Mettez régulièrement à jour les paTs et passez en revue les autorisations d’accès
• Journalisation d’audit : Surveiller l’activité d’intégration pour les modèles d’accès inhabituels
• Isolation des référentiels : connecter uniquement les référentiels qui nécessitent l’intégration d’Azure Boards

Processus de connexion pas à pas :

1. Installer l’application Azure Boards à partir de la Place de marché GitHub
2. Configurer l’accès au dépôt (tous les dépôts ou sélectivement)
3. Authentifiez-vous auprès d’Azure DevOps en utilisant la méthode préférée
4. Associer des dépôts à des projets dans Azure Boards
5. Tester l’intégration avec des modèles de liens et des commits

Pour obtenir des conseils d’implémentation détaillés, consultez : Connecter Azure Boards à GitHub

Flexibilité et gestion de la configuration

Fonctionnalités de gestion côté GitHub :

• Contrôle de la portée du référentiel : ajouter ou supprimer des référentiels spécifiques de l’intégration
• Mappage de projet : Configurer les projets Azure Boards qui se connectent à chaque référentiel
• Suspension de l’intégration : désactiver temporairement sans perdre la configuration
• Suppression complète : Désinstaller l’application et supprimer toutes les connexions

Fonctionnalités de gestion côté Azure Boards :

• Connexions multi-référentiels : lier plusieurs référentiels GitHub à des projets uniques
• Liaison interprojets : autoriser les dépôts à se connecter à plusieurs projets Azure Boards
• Surveillance de l’intégrité de la connexion : suivre l’état de l’intégration et résoudre les problèmes de connectivité
• Gestion des autorisations : contrôler les utilisateurs qui peuvent modifier les connexions GitHub

Scénarios d’intégration pris en charge

L’intégration d’Azure Boards-GitHub prend en charge les connexions suivantes :

• À partir de GitHub :

  • Soutien à l'intégration pour tous les dépôts d'un compte GitHub ou pour une organisation, ou pour des dépôts sélectionnés.
  • Ajoutez ou supprimez des dépôts GitHub participant à l’intégration et configurez le projet auquel ils se connectent.
  • Suspendez l’intégration d’Azure Boards-GitHub ou désinstallez l’application.

• À partir d’Azure Boards :

  • Connectez un ou plusieurs référentiels GitHub à un projet Azure Boards.
  • Ajoutez ou supprimez des dépôts GitHub d’une connexion GitHub au sein d’un projet Azure Boards.
  • Supprimez complètement une connexion GitHub pour un projet.
  • Autoriser un dépôt GitHub à se connecter à un ou plusieurs projets Azure Boards au sein de la même organisation ou collection Azure DevOps.

L’intégration d’Azure Boards-GitHub prend en charge les tâches opérationnelles suivantes :

• Créez des liens entre les éléments de travail et les commits GitHub, les pull requests et les issues en fonction des mentions GitHub.
• Prise en charge de la transition d’état des éléments de travail vers un état Terminé ou Effectué lors de l’utilisation des mentions GitHub avec correctifs, corrigé ou fix/fixed.
• Assurez la traçabilité complète en publiant un commentaire de discussion sur GitHub en liant un élément de travail à un commit GitHub, une pull request ou un problème.
• Afficher les artefacts de code liés à GitHub dans la section Développement de l'élément de travail.
• Afficher les artefacts liés à GitHub en tant qu’annotations sur les cartes de tableau Kanban.
• Prendre en charge les badges d’état des colonnes de tableau kanban ajoutées aux référentiels GitHub.

Les tâches suivantes ne sont pas prises en charge pour l’instant :

• Interrogez les éléments de travail avec des liens vers des artefacts GitHub. Toutefois, vous pouvez interroger des éléments de travail avec un nombre de liens externes supérieur à 0.

Pour plus d’informations, consultez :

• Modifier l’accès au dépôt GitHub, ou suspendre ou désinstaller l'intégration.
• Ajouter ou supprimer des référentiels GitHub.
• Pour plus d’informations sur la liaison à des éléments de travail, consultez lier les validations, demandes de tirage (pull requests) et problèmes GitHub aux éléments de travail.