Intégrer GitHub à Changements de vélocité DevOps — classique

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Connectez votre GitHub instance pour détecter, configurer et importer des référentiels, des plans et des pipelines.

    Avant de commencer

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

    Effectuez les étapes spécifiées dans la section Mise en route avant de vous connecter à un outil.

    Pourquoi et quand exécuter cette tâche

    • Connectez-vous à l’URL GitHub Webhook et obtenez l’URL lorsque vous soumettez un enregistrement d’outil DevOps .
    • Découvrir les référentiels et les plans.
    • Configurez le webhook dans le GitHub référentiel.
    • Importez des enregistrements de branche et de validation.

    Procédure

    1. Entrez les détails de l’instance pour vous connecter à DevOps GitHub Change Velocity en accédant à Tout > DevOps > Outils > Créer nouveau (hérité).
    2. Entrez une valeur dans le champ Nom de l’outil et remplissez les détails de l’outil.
      Tableau 1. Formulaire Créer un outil DevOps
      Champ Description
      Intégration d'outils

      Outil à intégrer. Dans ce cas, sélectionnez GitHub.
      URL de l'outil

      URL de l’instance existante GitHub à intégrer. Par exemple, https://api.github.com
      GitHub Type d’informations d’identification
      • Authentification de base
        • Nom d'utilisateur GitHub
        • Jeton d’accès personnel (classique)

        Seul un jeton d’accès personnel (classique) est pris en charge avec l’authentification de base. Lorsque vous générez un jeton d’accès personnel (classique) pour GitHub, vous devez spécifier les champs d’application à autoriser si vous n’accordez pas l’accès complet. Les champs d’application minimum que vous devez sélectionner pour l’autorisation sont repo, admin :repo_hook et user :email.

      • OAuth

        GitHub Informations d’identification de l’outil. Consultez Configurer les informations d’identification GitHub OAuth 2.0 pour Changements de vélocité DevOps.

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

    3. Facultatif : Sélectionnez Serveur MID pour un outil local qui est associé à un serveur MID.

      L’application est automatiquement définie sur DevOps et la fonctionnalité est définie sur REST.

      Remarque :
      Pour GitHub Enterprise Server (instance locale), OAuth n’est pas pris en charge si vous vous connectez à l’aide d’un MID Server.
    4. Sélectionnez Soumettre.
    Une fois l’outil créé, vous êtes redirigé vers la page d’enregistrement de 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 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.
      • DevOps Rôle du propriétaire de l’outil : peut afficher et modifier l’outil.
      • DevOps Rôle du propriétaire de l’application : permet d’afficher l’outil et peut associer, détecter, 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).
      • DevOps Rôle d’administrateur : peut modifier tous les outils.
      • Autres DevOps rôles : peut afficher l’outil.
      Remarque :
      Seuls les groupes contenant des utilisateurs ayant DevOps des rôles peuvent être sélectionnés dans le champ Géré par .

      L’option Tous les propriétaires d’applications peuvent afficher et associer des objets d’outil à des applications devient disponible à la sélection si vous choisissez de restreindre l’accès à l’outil. Cette option permet à tous les utilisateurs ayant le rôle de DevOps propriétaire de l’application 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.

    2. Sélectionnez Détecter pour détecter les référentiels, plans ou pipelines existants pour l’outil.
      Les enregistrements du référentiel sont ajoutés à la liste connexe Référentiels.
    3. Configurez automatiquement l’URL Webhook dans un référentiel afin d’envoyer GitHub des notifications à l’outil DevOps en sélectionnant Configurer.
      Vous pouvez également choisir d’activer l’interrogation nocturne pour extraire le système de données pour tous les référentiels ou pipelines suivis en définissant la propriété Activer l’interrogation sur Oui.
      Remarque :
      Si vous ne disposez pas des privilèges d’administrateur pour votre GitHub outil (pour permettre la configuration automatique de l’URL Webhook), vous devrez peut-être demander à l’utilisateur administrateur de l’outil de la configurer pour vous (créer et configurer manuellement l’URL Webhook dans l’instance de votre outil). Une fois le webhook configuré dans l’outil, passez en mode de configuration manuelle pour vous connecter manuellement à l’outil, puis quittez.
    4. Cliquez sur Importer pour importer des données historiques à partir du référentiel.
      Les enregistrements de branche et les enregistrements de validation importés à partir du référentiel sont ajoutés aux listes connexes correspondantes.
    5. Dans le champ Application , cliquez sur la liste de recherche et sélectionnez un enregistrement d’application à associer au référentiel, ou cliquez sur Nouveau pour en créer un.