Intégrer GitLab à Vélocité de changement DevOps — Espace de travail

Connectez-vous à votre GitLab instance à l’aide du playbook de l’espace de travail de changement DevOps pour détecter des plans, des référentiels et des pipelines.

Avant de commencer

Effectuez les tâches spécifiées dans la Premiers pas avec Vélocité de changement 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 à intégrer GitLab.

   Option	Étapes
   Page d'accueil	Sélectionnez Connecter un outil. Dans la fenêtre modale 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 de codage, sélectionnez-le GitLab dans la catégorie Code .
   Module Applications	Sélectionnez Applications (icône 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 carte Connecter un outil . Dans la fenêtre modale 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 de codage, sélectionnez-le GitLab dans la catégorie Code .
   Module Outils	Sélectionnez Outils (icône dans la navigation primaire. Dans la liste des options, 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 la fenêtre modale Connecter à un outil, sélectionnez GitLab.

   Important :

   Si vous souhaitez détecter et suivre des objets d’outil tels que des plans, 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 à terminer les tâches d’intégration.

4. Entrez les détails de votre GitLab instance.
   1. Saisissez 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. Saisissez les informations d’identification.
      • Authentification de base : saisissez 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 l’accès en lecture/écriture, y compris tous les groupes et projets, le registre de conteneurs et le registre de packages.
      • OAuth 2.0 : saisissez vos informations d’identification OAuth.

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

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

      Pour plus d’informations sur le serveur MID, voir Sélection du serveur MID

   5. Sélectionnez Connexion.

      

5. Les vérifications d’autorisation portent sur les informations d’identification que vous avez entrées.
   Les autorisations requises et les autorisations disponibles sont affichées. Si vous souhaitez entrer les informations d’identification avec de meilleures autorisations, sélectionnez Ressaisir les informations d’identification. Pour obtenir des informations détaillées sur toutes les autorisations requises, consultez la section GitLab Autorisations dans Autorisations requises pour les DevOps outils.

   Vous pouvez choisir de continuer 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 dans les groupes peuvent effectuer 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 : peut afficher l’outil et peut associer, détecter, importer des données historiques et modifier les étapes de 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 Propriétaire de l’outil DevOps pourront 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 pour la sélection.

      Cette option permet à tous les utilisateurs ayant le rôle de propriétaire d’application DevOps d’accéder à l’outil. S’ils sont sélectionnés, ils pourront afficher, associer, découvrir, importer des données historiques et 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 Vélocité de changement DevOps.

9. Sélectionnez Configurer.
   

   Pour effectuer une configuration manuelle, 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 plans, les référentiels et les pipelines disponibles dans votre projet sont détectés. Vous pouvez suivre et importer des données historiques à partir de ces données.
10. Sélectionnez les pipelines que vous souhaitez associer à l’application, puis sélectionnez Associer des pipelines.

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

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

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

12. Sélectionnez les plans que vous souhaitez associer à l’application, puis sélectionnez Plans associés.
13. Sélectionnez les référentiels que vous souhaitez associer à l’application, puis sélectionnez Associer les référentiels.
14. Dans l’étape Importer les données historiques, sélectionnez la plage de dates dans les champs Date de début et Date de fin , puis sélectionnez Importer les données.
    Remarque :

    Vous pouvez importer jusqu’à 90 jours de données.
15. Sélectionnez Suivant.
16. Dans 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é votre GitLab outil avec succès à Vélocité de changement 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 de l’outil tiers dans Vélocité de changement DevOps.

Tâches associées

• Configurer les webhooks à partir de l’enregistrement de l’outil