Afin de débuter la collecte de données pour vos pull requests, PBI et déploiements, une intégration doit être configurée puis liée au projet concerné. Il vous suffit d'ajouter l'intégration une seule fois pour la lier à plusieurs projets, ce qui vous permet d'évaluer différentes équipes.
Intégrations disponibles
Si vous voulez configurer Azure DevOps avec OAuth ou avec un compte de service principal, suivez cet article.
Pour configurer une intégration Azure DevOps
- Accédez au projet pour lequel vous souhaitez débuter la collecte de données.
Psst! Si vous n'avez pas encore ajouté un projet, commencez par cette étape!
- Cliquer sur Paramètres pour accéder aux paramètres du projet, puis aller dans l'onglet Intégrations.
- Descendez dans la section Gestionnaire de code source. Cliquer sur Ajouter une intégration.
-
Sélectionner Azure DevOps, puis suivant.
- Cliquer sur Ajouter une Intégration.
- Vous pouvez vous authentifier avec un jeton d'accès personnel ou OAuth. Si vos repositories sont hébergés sur site (auto-hébergés sur un réseau privé), nous vous suggérons d'utiliser le jeton d'accès personnel.
-
Une fenêtre s'ouvrira. Entrez vos informations de connexion Azure DevOps.
- Le Nom de votre intégration a pour but de vous aider à reconnaître cette intégration par la suite. Ce nom ne sera pas affiché ailleurs que dans la page Paramètres.
-
Le Nom de votre organisation Azure DevOps doit être le même que celui indiqué dans Azure DevOps lui-même.
-
Accédez à Azure DevOps
-
Accédez aux paramètres utilisateurs (icône de silhouette au coin supérieur droit)
-
Sélectionnez l’option Personal access tokens au bas de la liste
-
Cliquez sur + New Token.
Psst! Il est impossible d’afficher un PAT existant. Par conséquent, si vous disposez de documentation interne privée où le PAT peut être stocké, il peut être judicieux d’y ajouter cette donnée. De plus, comme le PAT comporte une date d'expiration, il est conseillé de sélectionner la plus longue période possible (soit un an) et de planifier un rappel de mise à jour (votre calendrier ou celui de l'équipe). Au moment de la mise à jour, vous devrez simplement délier l'intégration existante, générer un nouveau PAT dans Azure DevOps et lier l'intégration de nouveau. Ne vous inquiétez pas; la synchronisation des données est rétroactive, c'est-à-dire que les données synchronisées par le passé demeurent accessibles dans Axify.
Le Jeton d’accès personnel doit être généré au préalable directement dans les paramètres d’Azure DevOps. Vous pouvez vous référer à cet article d’aide officiel de Microsoft (article en anglais) pour plus d’informations à ce sujet.
-
- Inscrivez le PAT généré dans le champ Jeton d'accès personnel.
-
(Facultatif) Si vous disposez d'une instance sur site, Axify aura besoin d'une URL publique accessible pour accéder à votre réseau privé (par exemple via un proxy inverse). Dans ce cas, vous pouvez saisir l'URL du proxy dans l'URL du proxy de l'instance Azure DevOps.
- Vous pouvez également ajouter des en-têtes supplémentaires. Un exemple d'utilisation typique consiste à saisir un X-AXIFY-ID avec une valeur spécifique afin que votre réseau sache qu'il s'agit de nous et non d'un tiers. Lors de la récupération des requêtes, Axify enverra ces en-têtes supplémentaires à chaque requête.
- Une fois les champs complétés, cliquez sur Ajouter une intégration Azure DevOps.
Voilà! Votre intégration Azure DevOps est configurée et prête à être liée à votre projet pour débuter la collecte de données!
Psst! Selon le volume de données, la synchronisation de l'Axe Technique peut prendre plusieurs minutes, voir plusieurs heures dans les cas plus extrêmes.