Intégrer Bitbucket à : espace de Vélocité de changement DevOps travail

Créez, connectez, détectez 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 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 Bitbucket.

   Option	Étapes
   Page d'accueil	Sélectionnez Connecter un outil. Dans la fenêtre modale Se connecter à un outil, sélectionnez une catégorie Bitbucket 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 Se connecter à un outil, sélectionnez une catégorie Bitbucket Code.
   Module Outils	Sélectionnez Outils (icône dans la navigation primaire. Dans la liste Aptitude, sélectionnez Codage. Sélectionnez Connecter un outil. Dans la fenêtre modale Se connecter à un outil, sélectionnez Bitbucket.

   Important :

   Si vous souhaitez détecter et suivre les objets d’outil tels que les référentiels lors de la connexion à l’outil, vous devez connecter votre outil à partir du module Application.
2. 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.

   

3. Dans l’activité du playbook des détails de l’instance Bitbucket , saisissez les détails suivants.

   Outil	Étapes
   Serveur Bitbucket	Entrez l’URL de votre Bitbucket instance. Saisissez les informations d’identification de connexion de l’administrateur général pour l’instance Bitbucket . Si votre Bitbucket instance est connectée à un serveur MID, sélectionnez l’option Serveur MID et entrez ses détails. Un Serveur MID est requis si votre instance d’outil est hébergée sur site. Pour plus d’informations sur le serveur MID, voir Sélection du 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 Effectuez les étapes suivantes 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 effectuant 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. Saisissez une valeur dans les champs ID client et Secret client . Remarque : Vous pouvez obtenir les valeurs d’ID client et de 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 Bitbucket instance est connectée à un serveur MID, sélectionnez l’option Serveur MID et entrez ses détails. Un Serveur MID est requis si votre instance d’outil est hébergée sur site. Pour plus d’informations sur le serveur MID, voir Sélection du serveur MID.

4. 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 Bitbucket 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 référentiels pour lesquels vous souhaitez configurer automatiquement les webhooks.

   Les notifications en temps réel sont idéales pour maintenir les informations les plus à jour, notamment pour automatiser les demandes de changement.

   Vous pouvez également configurer le Webhook en le configurant manuellement. Vous pouvez également choisir d’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é Activer l’interrogation sur Oui.

9. Sélectionnez Configurer.
   

   Pour effectuer une configuration manuelle, sélectionnez Configurer manuellement. Consultez Configurer manuellement les webhooks 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 suivre et importer des données historiques à partir de ces données.
10. Sélectionnez les référentiels que vous souhaitez associer à l’application, puis sélectionnez Associer les référentiels.
11. 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.
    Les validations, les branches et les enregistrements de demande d’extraction importés du référentiel sont ajoutés aux listes connexes correspondantes.
12. Sélectionnez Suivant.
13. Dans la page Résumé , passez en revue les détails de l’outil correctement connecté Bitbucket .

    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 à partir de celle-ci.

    

Résultats

Vous avez intégré votre Bitbucket 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