Intégrer GitLab à Vélocité de changement DevOps - Espace de travail
Connectez-vous à votre instance GitLab à l'aide du playbook Espace de travail de changement DevOps pour détecter les plans, les référentiels et les pipelines.
Avant de commencer
Effectuez les tâches spécifiées dans la rubrique Premiers pas avec Vélocité de changement DevOps.
Rôle requis : sn_devops.admin ou sn_devops.tool_owner
Procédure
-
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 le modal Se connecter à un outil, sélectionnez l'outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitLab en tant qu'outil de codage, sélectionnez GitLab dans la catégorie Code.
Module Applications - Sélectionnez Applications (
) dans la barre de navigation principale.
- Sélectionnez une application existante ou créez-en une. Pour créer une application, consultez Créer une application - Espace de travail.
- Dans le volet Actions recommandées, sélectionnez la carte Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez l'outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitLab en tant qu'outil de codage, sélectionnez GitLab dans la catégorie Code.
Module Outils - Sélectionnez Outils (
) dans la barre de navigation principale.
- Dans la liste Aptitude, sélectionnez la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitLab en tant qu'outil de codage, sélectionnez 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'outil tels que des pipelines, des plans ou des référentiels lors de la connexion à l'outil, vous devez connecter votre outil à partir du module Application. -
Dans le champ Nom de l'outil, saisissez un nom pour l'outil.
-
Sélectionnez Suivant.
Le playbook DevOps s'ouvre pour vous aider à accomplir les tâches d'intégration.
-
Saisissez les détails de votre instance GitLab.
- Saisissez l'URL de votre instance GitLab.
-
Dans le champ Type d'informations d'identification, sélectionnez l'une des deux options ci-dessous.
- Authentification de base
- OAuth 2.0
-
Saisissez les informations d'identification.
- Authentification de base : saisissez le nom d'utilisateur et le mot de passe/jeton d'accès de votre instance 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.
- OAuth 2.0 : saisissez vos informations d'identification OAuth.
Pour plus d'informations sur les informations d'identification OAuth 2.0, consultez Configurer les informations d'identification OAuth 2.0 GitLab pour DevOps.
- Authentification de base : saisissez le nom d'utilisateur et le mot de passe/jeton d'accès de votre instance GitLab.
- Facultatif :
Si votre instance GitLab est liée à un Serveur MID, sélectionnez l'option Serveur MID et saisissez les détails correspondants.
Pour plus d'informations sur le serveur MID, consultez Sélection de Serveur MID.
-
Sélectionnez Connexion.
-
Des vérifications d'autorisation sont exécutées 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 disposant de meilleures autorisations, sélectionnez Saisir à nouveau les informations d'identification. Pour obtenir des informations détaillées sur toutes les autorisations requises, consultez la section relative aux autorisations GitLab dans Autorisations requises pour les outils DevOps.
Vous pouvez continuer avec la connexion de l'outil même si vous ne disposez pas de toutes les autorisations requises.
- Sélectionnez Suivant.
-
Spécifiez l'accès à l'outil.
- Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par.Les tâches que ces utilisateurs des groupes peuvent effectuer dépendent du rôle qui leur est affecté.
- 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 :Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs disposant du rôle Propriétaire de l'outil DevOps seront en mesure de modifier l'outil. - Si vous choisissez de contrôler 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 et d'importer des données historiques et pourront également modifier les étapes du pipeline (le cas échéant) des objets de l'outil.
- Sélectionnez Affecter.
- Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par.
-
Sélectionnez les projets pour lesquels vous souhaitez configurer des webhooks automatiquement.
Vous pouvez également activer l'interrogation nocturne pour récupérer les données des pipelines suivis en sélectionnant l'option de propriété Enable Polling (Activer l'interrogation) dans le module Administration. Consultez Propriétés du Vélocité de changement DevOps.
-
Sélectionnez Configurer.
Pour configurer manuellement des webhooks, sélectionnez Configurer manuellement. Consultez Configurer manuellement des webhooks dans 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 en suivre et en importer des données historiques.
-
Sélectionnez les pipelines que vous souhaitez associer à l'application, puis Pipelines associés.
Pour chaque pipeline sélectionné, toutes les étapes sont importées pour la dernière exécution réussie.
- Facultatif :
Dans l'activité Assign services to pipeline steps (Affecter des services aux étapes du pipeline), spécifiez le type d'étape et le service pour chaque étape du pipeline.
L'exécution de cette étape dans le cadre de l'intégration de l'outil permet aux tableaux de bord Analyses DevOps d'afficher immédiatement les données plus significatives.
- Sélectionnez les plans que vous souhaitez associer à l'application, puis Plans associés.
- Sélectionnez les référentiels que vous souhaitez associer à l'application, puis Associer les référentiels.
-
Dans l'étape Importer des 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.
- Sélectionnez Suivant.
-
Dans la page Résumé, passez en revue les détails de l'outil GitLab correctement connecté.
Sélectionnez Afficher l'enregistrement de l'outil pour examiner les détails de l'instance connectée.