Afin de débuter la collecte de données pour l'Axe Technique, 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
- Azure DevOps
- GitLab
- GitHub
Pour configurer une intégration GitLab
- 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!
- Accédez à l'Axe Technique, puis cliquez sur Lier une intégration.
- Dans la fenêtre qui s'ouvrira, cliquez sur Ajouter une intégration.
- Sélectionnez l'option GitLab puis cliquez sur Ajouter.
- Une fenêtre s'ouvrira. Entrez vos informations de connexion GitLab.
- Le Nom de votre intégration a pour but de vous aider à reconnaître cette intégration par la suite. Ce nom ne sera affiché que dans la page Paramètres.
- Le Jeton d’accès personnel doit être généré au préalable directement dans les paramètres de GitLab. Vous pouvez vous référer à cet article d’aide officiel de GitLab (article en anglais) pour plus d’informations à ce sujet. Cet article est également mis à votre disposition directement dans la fenêtre de configuration.
- La Clé d’API est une clé créée dans les réglages du profil de l’utilisateur GitLab. Pour ce faire :
- Accédez à GitLab
- Accéder à vos paramètres utilisateurs (votre avatar au coin supérieur droit)
- Dans le menu vertical de gauche, sélectionnez Access tokens
- Nommez le nouveau token et, si nécessaire, déterminez sa date d’expiration
- Sélectionnez les scopes à inclure
Psst! Les projets accessibles par l'intégration sont seulement ceux dont le détenteur du jeton est membre.
read_user
read_api
read_repository
- Inscrivez le token généré dans le champ Clé d’API
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.
-
- L’URL est le site de base de GitLab auquel nous souhaitons nous connecter. Par exemple, nous pourrions avoir https://gitlab.monserveur.com. Il est à noter que, dans certains cas, le serveur est tout simplement l'URL principale de GitLab, sans extension.
Une fois les champs complétés, cliquez sur Ajouter l'intégration.
- L’URL est le site de base de GitLab auquel nous souhaitons nous connecter. Par exemple, nous pourrions avoir https://gitlab.monserveur.com. Il est à noter que, dans certains cas, le serveur est tout simplement l'URL principale de GitLab, sans extension.
Voilà! Votre intégration GitLab 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.