Intégrer Bitbucket à Vélocité de changement DevOps - Espace de travail
Créez, connectez, découvrez et configurez votre Bitbucket instance à l’aide de l’espace de Vélocité de changement DevOps travail.
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 Bitbucket.
Option Étapes Page d'accueil - Sélectionnez Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez Bitbucket 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 Bitbucket dans la catégorie Code.
Module Outils - Sélectionnez Outils (
) dans la barre de navigation principale.
- Dans la liste Aptitude, sélectionnez Codage.
- Sélectionnez Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez Bitbucket.
Important :si vous souhaitez détecter et suivre des objets d'outil tels que des référentiels lors de la connexion à l'outil, vous devez connecter votre outil à partir du module Application. -
Sélectionnez Bitbucket Cloud ou BitBucket Server dans la liste déroulante Plateforme, saisissez un nom pour l’outil dans le champ Nom de l’outil , puis sélectionnez Suivant.
-
Dans l’activité du playbook Détails de l’instance Bitbucket , saisissez les détails suivants.
Outil Étapes Serveur Bitbucket - Entrez l'URL de votre instance Bitbucket.
- Saisissez les informations d'identification de connexion de l'administrateur général de l'instance Bitbucket.
- Si votre instance Bitbucket est connectée à un serveur MID, sélectionnez l'option Serveur MID et saisissez les détails correspondants. Un serveur MID est nécessaire si votre instance d'outil est hébergée sur site. Pour plus d'informations sur le serveur MID, consultez Sélection de Serveur MID.
Bitbucket Cloud - Sélectionnez le type d’informations d’identification comme l’un des suivants :
- Authentification de base
- Jeton d'accès
- OAuth 2.0 : code d’autorisation
- OAuth 2.0 : informations d’identification du client
- Procédez comme suit en fonction du type d’informations d’identification que vous avez sélectionné, Pour l’authentification de base,
- Saisissez une valeur dans le champ Nom d’utilisateur de Bitbucket Cloud .
- Saisissez une valeur dans le champ Mot de passe .Remarque :Pour plus d’informations sur la création d’informations d’identification d’authentification de base, reportez-vous à la section Bitbucket intégration avec Vélocité de changement DevOps.
Pour le jeton d’accès,- Saisissez une valeur dans le champ Jeton d’accès .
- Saisissez l’identificateur unique de votre espace de travail Bitbucket Cloud dans le champ ID de l’espace de travail .
Pour OAuth 2.0 : code d’autorisation,- Si vous disposez déjà d’un enregistrement d’informations d’identification, saisissez une valeur dans le champ Informations d’identification .
- Si ce n’est pas le cas, créez des informations d’identification en suivant les étapes spécifiées dans la Configurer le code d’autorisation OAuth 2.0 pour Bitbucket le cloud rubrique.
Pour OAuth 2.0 : informations d’identification du client,- Si vous avez déjà créé un enregistrement d’informations d’identification OAuth, sélectionnez l’option Utiliser un enregistrement d’informations d’identification OAuth existant , puis sélectionnez l’enregistrement d’informations d’identification requis dans le champ Informations d’identification . Si tel n'est pas le cas, passez à l'étape suivante.
- Entrez une valeur dans les champs ID client et Secret client .Remarque :Vous pouvez obtenir les valeurs ID client et Secret client à partir de votre compte Bitbucket. L’ID client de votre outil Bitbucket est disponible dans la section Consommateurs OAuth des paramètres de votre espace de travail dans le champ Clé de Bitbucket Cloud. Le secret client de votre outil Bitbucket est disponible dans la section Consommateurs OAuth des paramètres de votre espace de travail dans le champ Secret de Bitbucket Cloud. Pour plus d'informations, consultez Bitbucket intégration avec Vélocité de changement DevOps.
- Si votre instance Bitbucket est connectée à un serveur MID, sélectionnez l'option Serveur MID et saisissez les détails correspondants. Un serveur MID est nécessaire si votre instance d'outil est hébergée sur site. 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 Bitbucket 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 référentiels pour lesquels vous souhaitez configurer des webhooks automatiquement.
Les notifications en temps réel sont idéales pour garantir l'actualisation des informations, notamment pour automatiser les demandes de changement.
Vous pouvez également configurer un webhook manuellement. Vous pouvez également activer l'interrogation nocturne pour extraire le système de données pour tous les référentiels suivis en définissant la propriété Enable Polling (Activer l'interrogation) sur Oui.
-
Sélectionnez Configurer.
Pour configurer manuellement des webhooks, sélectionnez Configurer manuellement. Consultez Configurer manuellement des webhooks dans Bitbucket 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 disponibles dans votre instance sont détectés. Vous pouvez en suivre et en importer des données historiques.
- 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.Les validations, branches et enregistrements de demande d’extraction importés du référentiel sont ajoutés aux listes connexes correspondantes.
- Sélectionnez Suivant.
-
Dans la page Résumé, passez en revue les détails de l'outil Bitbucket correctement connecté.
Sélectionnez Afficher l'enregistrement de l'outil pour examiner les détails de l'instance connectée et des référentiels détectés correspondants.