Intégrer GitLab à Vélocité de changement DevOps - Classique

Créez un enregistrement de l'outil GitLab dans Vélocité de changement DevOps pour connecter, détecter et importer des données de l'outil GitLab.

Avant de commencer

Complétez les étapes spécifiées dans la section Mise en route avant de connecter un outil.

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

Pourquoi et quand exécuter cette tâche

• Connectez-vous à l'aide des détails de votre instance GitLab.
• Détectez les plans, les référentiels et les pipelines.
• Configurez des webhooks dans GitLab.
• Importez des enregistrements de branche et de validation, des éléments de travail ainsi que des enregistrements d'exécution de tâches et d'exécution d'étapes.

Procédure

1. Saisissez les détails de l'instance GitLab pour vous connecter à Vélocité de changement DevOps.
   1. Accédez à la DevOps > Outils > Créer nouveau (hérité) et créer un enregistrement.
   2. Saisissez une valeur dans le champ Nom de l'outil et renseignez les détails de l'outil.

      URL de l'outil	URL de l'outil GitLab. Par exemple : https://gitlab.com
      Nom d'utilisateur de l'outil	Nom d'utilisateur GitLab
      Mot de passe/jeton d'accès de l'outil	Jeton d'accès GitLab 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, comprenant tous les groupes et projets, le registre des conteneurs et le registre des packages.

      Pour obtenir la liste de toutes les autorisations requises sur les informations d'identification pour la connexion à GitLab, reportez-vous à la section relative aux autorisations GitLab dans Autorisations requises pour les outils DevOps.

   3. Facultatif : Sélectionnez Serveur MID pour un outil sur site connecté à un Serveur MID.
      La valeur du champ Application est automatiquement définie sur DevOps et celle du champ Aptitude est définie sur REST.
   4. Cliquez sur Envoyer.
      L'outil est connecté avec succès.

Une fois l'outil créé, vous êtes redirigé vers la page d'enregistrement de l'outil.

2. Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par de l'onglet Accès.
   Les tâches que les utilisateurs des groupes peuvent effectuer dépendent des rôles qui leur sont affectés.

   • Rôle Propriétaire de l'outil DevOps : peut afficher et modifier l'outil.
   • Rôle Propriétaire de l'application DevOps : peut afficher l'outil, associer, détecter et 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).
   • Rôle Administrateur DevOps : peut modifier tous les outils.
   • Autres rôles DevOps : peuvent afficher l'outil.

   Remarque :

   seuls les groupes contenant des utilisateurs disposant de rôles DevOps peuvent être sélectionnés dans le champ Maintenu par.

   Si vous choisissez de restreindre l'accès à l'outil, l'option Tous les propriétaires d'applications peuvent visualiser et associer des objets d'outil aux applications peut être sélectionnée. Cette option permet à tous les utilisateurs disposant du rôle Propriétaire de l'application DevOps 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. Cliquez sur Détecter pour détecter les plans, référentiels et pipelines existants, et renseignez les champs de la fenêtre Filtre de recherche du projet.
   Remarque :

   les plans, les référentiels et les pipelines GitLab détectés sont déterminés en fonction de ces conditions de filtre. Pour détecter des référentiels supplémentaires, modifiez le filtre du projet pour développer les résultats.

   Détenu par moi (recommandé)	Recherche les référentiels dans le projet dont l'utilisateur actuel est propriétaire.
   Actuellement membre de	Recherche les référentiels du projet dont l'utilisateur actuel est membre.
   Rechercher	Recherche les référentiels dans les projets avec la chaîne de texte spécifiée.

   Remarque :

   les plans, référentiels et pipelines GitLab détectés sont également déterminés par les informations d'identification (niveau d'accès) configurées dans la connexion.
   Les enregistrements sont ajoutés aux listes connexes correspondantes.
4. Configurez automatiquement l'URL du webhook dans un référentiel GitLab afin d'envoyer des notifications à l'outil DevOps en sélectionnant Configurer.
   Vous pouvez également activer l'interrogation nocturne pour extraire le système de données pour tous les plans, référentiels ou pipelines suivis en définissant la propriété Enable Polling (Activer l'interrogation) sur Oui.
5. Pour les plans, référentiels et pipelines détectés, importez les données historiques de l'outil et associez-les à une application.
   1. Ouvrez l'enregistrement du référentiel, du plan ou du pipeline à partir de la liste connexe correspondante et cliquez sur Importer.
      Les enregistrements de branche, les validations, les exécutions de pipelines, les éléments de travail, etc. importés sont ajoutés aux listes connexes correspondantes.
   2. Dans le champ Application, cliquez sur la liste de recherche et sélectionnez un enregistrement d'application à associer au référentiel, au plan ou au pipeline.
   Les enregistrements de données historiques importés sont ajoutés aux listes connexes correspondantes.