Intégrer GitLab à Changements de vélocité DevOps — Espace de travail

Connectez-vous à votre GitLab instance à l’aide du playbook de l’espace de travail de changement DevOps pour détecter les référentiels et le pipeline.

Avant de commencer

Effectuez les tâches spécifiées dans la Premiers pas avec Changements de vélocité DevOps rubrique.

Rôle requis : sn_devops.admin ou sn_devops.tool_owner

Procédure

1. Accédez à la Espaces de travail > Espace de travail de changement DevOps et utilisez l’une des options suivantes pour ouvrir le Playbook à embarquer GitLab.

   Option	Étapes
   Page d'accueil	Sélectionnez Connecter un outil. Dans le modal Connecter à un outil, sélectionnez l’outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter en GitLab tant qu’outil GitLab de codage, sélectionnez dans la catégorie Code .
   Module d’application	Sélectionnez Applications ( ) dans la navigation primaire. Sélectionnez une application existante ou créez-en une. Pour créer une application, reportez-vous à la section Créer une application : espace de travail. Dans le volet Actions recommandées, sélectionnez la fiche Connecter un outil . Dans le modal Connecter à un outil, sélectionnez l’outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter en GitLab tant qu’outil GitLab de codage, sélectionnez dans la catégorie Code .
   Module d’outils	Sélectionnez Outils ( dans la navigation primaire. Dans la liste Aptitude, sélectionnez la catégorie appropriée. Par exemple, si vous souhaitez vous connecter en GitLab tant qu’outil de codage, vous devez sélectionner la catégorie Codage . Sélectionnez Connecter un outil. Dans le modal Se connecter à un outil, sélectionnez GitLab.

   Important :

   Si vous souhaitez détecter et suivre des objets d’outils tels que des pipelines ou des référentiels lors de la connexion à l’outil, vous devez connecter votre outil à partir du module Application.
2. Dans le champ Nom de l’outil , saisissez un nom pour l’outil.
   
3. Sélectionnez Suivant.

   Le DevOps playbook s’ouvre pour vous aider à accomplir les tâches d’intégration.

4. Saisissez les détails de votre GitLab instance.
   1. Entrez l’URL de votre GitLab instance.
   2. Dans le champ Type d’informations d’identification , sélectionnez-en un.
      • Authentification de base
      • OAuth 2.0
   3. Entrez les informations d’identification.
      • Authentification de base : entrez le nom d’utilisateur et le mot de passe/jeton d’accès de votre GitLab instance.
        Remarque :

        Seul le jeton d’accès personnel est pris en charge. Lorsque vous générez le jeton, sélectionnez l’API du périmètre et accordez un accès en lecture/écriture, y compris tous les groupes et projets, le registre des conteneurs et le registre des packages.
      • OAuth 2.0 : entrez vos informations d’identification OAuth.

        Pour plus d’informations sur les informations d’identification OAuth2.0, reportez-vous à la section Configurer les informations d’identification GitLab OAuth 2.0 pour DevOps.

   4. Facultatif : Si votre GitLab instance est associée à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.

      Pour plus d’informations sur le MID Server, reportez-vous à la section Sélection du MID Server

   5. Sélectionnez Connexion.

      

5. Les contrôles d’autorisation sont exécutés sur les informations d’identification que vous avez saisies.
   Les autorisations requises et les autorisations disponibles s’affichent. Si vous souhaitez saisir des informations d’identification avec de meilleures autorisations, sélectionnez Saisir à nouveau les informations d’identification. Pour en savoir plus sur toutes les autorisations requises, reportez-vous à la section GitLab Autorisations dans Autorisations requises pour DevOps les outils.

   Vous pouvez choisir de continuer avec la connexion de l’outil même si vous ne disposez pas de toutes les autorisations requises.

   

6. Sélectionnez Suivant.
7. Spécifiez l’accès pour l’outil.
   1. Si vous souhaitez contrôler l’accès à l’outil, ajoutez les groupes qui doivent avoir accès à l’outil dans le champ Géré par .
      Les tâches que ces utilisateurs peuvent effectuer dans les groupes dépendent du rôle qui leur est affecté.

      • DevOps Rôle du propriétaire de l’outil : peut afficher et modifier l’outil.
      • DevOps Rôle du propriétaire de l’application : permet d’afficher l’outil et peut associer, détecter, importer des données historiques et modifier les étapes du pipeline (le cas échéant) des objets de l’outil (tels que les plans, les référentiels et les pipelines).
      • DevOps Rôle d’administrateur : peut modifier tous les outils.
      • Autres DevOps rôles : peut afficher l’outil.
      Remarque :

      Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs ayant le rôle de propriétaire de l’outil DevOps seront en mesure de modifier l’outil.
   2. Si vous choisissez de contrôler l’accès à l’outil, l’option Tous les propriétaires d’applications peuvent afficher et associer des objets d’outil aux applications devient disponible à la sélection.

      Cette option permet à tous les utilisateurs ayant le rôle de DevOps propriétaire de l’application d’accéder à l’outil. Si cette option est sélectionnée, ils seront en mesure d’afficher, d’associer, de détecter, d’importer des données historiques et de modifier les étapes du pipeline (le cas échéant) des objets de l’outil.

   3. Sélectionnez Affecter.

   

8. Sélectionnez les projets pour lesquels vous souhaitez configurer automatiquement les webhooks.

   Vous pouvez également choisir d’activer l’interrogation nocturne pour récupérer les données de tous les pipelines suivis en sélectionnant l’option de propriété Activer l’interrogation dans le module Administration . Consultez Propriétés du Changements de vélocité DevOps.

9. Sélectionnez Configurer.
   

   Pour configurer manuellement, sélectionnez Configurer manuellement. Consultez Configurer manuellement les webhooks GitLab pour plus d'informations.

   Important :

   • Si vous vous connectez à partir de la page d’accueil ou du module Outils, la connexion est terminée et vous êtes redirigé vers la page Résumé.
   • Si vous vous connectez à partir du module Applications, les référentiels et les pipelines disponibles dans votre projet sont détectés. Vous pouvez en suivre et en importer des données historiques.
10. Sélectionnez les référentiels à suivre.
    1. Sélectionnez les référentiels pour lesquels vous souhaitez suivre les mises à jour et les associer à l’application.

    2. Sélectionnez Suivant.

       

    3. Si vous souhaitez importer des données de référentiel, sélectionnez la plage de dates, puis sélectionnez Soumettre.

       Vous pouvez importer jusqu’à 90 jours de données.

11. Sélectionnez le pipeline que vous souhaitez suivre, puis sélectionnez Suivant.

    Pour chaque pipeline sélectionné, toutes les étapes sont importées pour la dernière exécution réussie.

    

12. Facultatif : Dans l’activité Affecter des services aux étapes du pipeline, spécifiez le type d’étape et le service pour chaque étape du pipeline.

    La réalisation de cette étape dans le cadre de l’intégration de l’outil permet aux Analyses DevOps tableaux de bord d’afficher immédiatement des données plus significatives.

13. Sélectionnez Suivant.
14. Sur la page Résumé , passez en revue les détails de l’outil correctement connecté GitLab .

    Sélectionnez Afficher l’enregistrement de l’outil pour examiner les détails de l’instance connectée.

    

Résultats

Vous avez intégré avec succès votre GitLab outil à Changements de vélocité DevOps.

Remarque :

Si les informations d’identification de votre outil changent, vous devez également les mettre à jour dans Changement DevOps. Pour plus d'informations, consultez Mettre à jour les informations d’identification d’outils tiers dans Changements de vélocité DevOps.

Tâches associées

• Configurer des webhooks à partir de l’enregistrement d’outil