Intégrer GitHub à Vélocité de changement DevOps - Espace de travail

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 10 minutes de lecture
  • Connectez-vous à votre instance GitHub à l'aide du playbook Espace de travail de changement DevOps pour détecter, configurer et importer 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

    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 GitHub.
      OptionÉtapes
      Page d'accueil
      1. Sélectionnez Connecter un outil.
      2. Dans le modal Se connecter à un outil, sélectionnez l'outil dans la catégorie appropriée (Orchestration, Plan, Code ou Qualité logicielle). Par exemple, si vous souhaitez vous connecter à GitHub en tant qu'outil de codage, sélectionnez la catégorie Outils de codage.
      Module Applications
      1. Sélectionnez Applications ( icône Applications.) dans la barre de navigation principale.
      2. Sélectionnez une application existante ou créez-en une. Pour créer une application, consultez Créer une application - Espace de travail.
      3. Dans le volet Actions recommandées, sélectionnez la carte Connecter un outil.
      4. Dans le modal Se connecter à un outil, sélectionnez l'outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitHub en tant qu'outil de codage, sélectionnez GitHub dans la catégorie Code.
      Module Outils
      1. Sélectionnez Outils ( icône Outils.) dans la barre de navigation principale.
      2. Dans la liste Aptitude, sélectionnez la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitHub en tant qu'outil de codage, sélectionnez la catégorie Codage.
      3. Sélectionnez Connecter un outil.
      4. Dans le modal Se connecter à un outil, sélectionnez GitHub.
      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.
    2. Dans le champ Nom de l'outil, saisissez un nom pour l'outil.

      Se connecter à GitHub

    3. Sélectionnez Suivant.

      Le playbook DevOps s'ouvre pour vous aider à accomplir les tâches d'intégration.

    4. Terminez la connexion et la configuration à l'aide du playbook.
      1. Dans le champ Type d'informations d'identification, sélectionnez l'un des types d'informations d'identification suivants.
        • Authentification de base
        • OAuth 2.0 avec code d'autorisation
        • OAuth 2.0 avec jeton Web JSON (JWT)
      2. 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 GitHub.

        Type d'informations d'identification pour l'authentification de base GitHub.

        OAuth 2.0 avec code d'autorisation

        Sélectionnez un enregistrement d'informations d'identification existant OAuth 2.0 avec code d'autorisation ou créez-en un. Pour plus d'informations, consultez Créer un enregistrement d'informations d'identification pour le fournisseur d'applications GitHub (code d'autorisation).

        Type d'informations d'identification GitHub OAuth 2.0 avec code d'autorisation

        OAuth 2.0 avec jeton Web JSON (JWT)
        Pour vous connecter à l'aide d'OAuth 2.0 avec un jeton JWT, vous devez d'abord effectuer les opérations suivantes :
        Une fois les conditions préalables remplies, vous pouvez continuer avec l'activité du playbook Connexion de Vélocité de changement DevOps :
        1. Sélectionnez l'option Utiliser un enregistrement d'informations d'identification JWT existant si vous souhaitez utiliser un enregistrement d'informations d'identification JWT déjà existant. Si cette option n'est pas sélectionnée, les champs permettant de créer un enregistrement d'informations d'identification JWT s'affichent. Passez à l'étape suivante.
        2. Dans le champ Certificat JKS, sélectionnez un certificat JKS existant. Il s'agit du nom que vous avez saisi pour identifier de façon unique le fournisseur JWT. Les certificats JKS sont créés à l'aide de commandes shell pour créer un enregistrement sys_certificate.

          Pour plus d'informations, consultez Créer une clé de signature JWT pour le certificat GitHub JKS.

        3. Dans le champ Clé de signature, saisissez la clé de signature à affecter à votre certificat JKS. Il s'agit du mot de passe d'exportation saisi lors de la génération du certificat JKS.
        4. Dans le champ ID de l'application GitHub, sélectionnez l'ID votre application GitHub (disponible dans la section À propos de votre configuration d'application GitHub dans GitHub). L'image suivante présente un exemple de la section À propos d'une configuration d'application GitHub à partir de laquelle vous pouvez accéder à l'ID de l'application GitHub, l'ID client et le secret client.

          Page À propos de l'application GitHub.

        5. Dans le champ ID client, sélectionnez l'ID client de votre application GitHub (disponible dans la section À propos de votre configuration d'application GitHub dans GitHub).
        6. Dans le champ Secret client, sélectionnez le secret client de votre application GitHub (disponible dans la section À propos de votre configuration d'application GitHub dans GitHub).
        7. Dans le champ URL de jeton, sélectionnez l'emplacement du point de terminaison du jeton que l'instance utilise pour récupérer et actualiser les jetons.

          Pour la version dans le cloud, saisissez : https://api.github.com/app/installations/<installation_id>/access_tokens.

          Pour la version d'entreprise, saisissez : https://<HOST_URL>/api/v3/app/installations/<installation_id>/access_tokens.

          Pour l'ID d'installation, accédez à la section d'installation de l'application dans votre configuration d'application GitHub dans GitHub et sélectionnez l'icône d'engrenage pour configurer votre application. L'ID d'installation se trouve dans l'URL de la page Web. Par exemple, https://github.com/settings/installations/<installation_id>.

          Type d'informations d'identification GitHub OAuth 2.0 avec JWT.

        Si les informations d'identification OAuth sont créées en utilisant Applications GitHub - JWT, l'option Configure with GitHub App (Configurer avec l'application GitHub) est disponible sur la page d'enregistrement de l'outil.

        Pour plus d'informations sur les informations d'identification OAuth 2.0, consultez Configurer les informations d'identification OAuth 2.0 GitHub pour Vélocité de changement DevOps.

      3. Facultatif : Saisissez une valeur dans le champ Nom de la slug de l'application GitHub pour vérifier les besoins d'autorisation de l'outil avant de le connecter si vous avez créé vos informations d'identification OAuth 2.0 à l'aide des applications GitHub.
        Vous trouverez le nom de la slug de l'application sur la page des paramètres de votre application.
      4. Facultatif : Si votre instance GitHub 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.

        Remarque :
        Le code d’autorisation OAuth et les types d’accord JWT sont pris en charge pour GitHub et GitHub Enterprise avec serveur MID.
      5. Sélectionnez Connexion.

        Connectez GitHub à Vélocité de changement DevOps.

      6. 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 GitHub dans Autorisations requises pour les outils DevOps.

        Pour OAuth 2.0, si vous n'avez pas saisi le nom de la slug de l'application GitHub, l'outil est connecté sans vérification des besoins d'autorisation.

      7. Sélectionnez Suivant.

        Vérifications des autorisations

    5. Spécifiez l'accès à l'outil.
      1. 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.
      2. 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.

      3. Sélectionnez Affecter.

      Spécifier l'accès à l'outil

    6. Configurez automatiquement les webhooks dans votre instance GitHub pour envoyer des données à Vélocité de changement DevOps.
      Cette action configure les webhooks suivants :
      • push : pour collecter des validations, des branches et des balises de référentiel
      • workflow_job : pour collecter des données de pipeline
      • issues : pour collecter des données (élément de travail) sur les problèmes
      Remarque :
      il est recommandé d'effectuer la configuration dans le cadre de cette tâche, car les notifications en temps réel sont idéales pour maintenir les informations à jour, notamment pour automatiser les demandes de changement. Sinon, vous pouvez configurer manuellement le webhook ultérieurement en activant 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é Enable Polling sur Oui.

      Sélectionnez les référentiels pour lesquels vous souhaitez configurer des webhooks, puis sélectionnez Configurer.

      Sélectionnez les référentiels à configurer à partir de GitHub.

      Pour configurer manuellement des webhooks, sélectionnez Configurer manuellement. Consultez Configurer manuellement des webhooks dans GitHub 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 et les pipelines disponibles sont détectés. Vous pouvez en suivre et en importer des données historiques.
    7. Sélectionnez les plans à suivre.
      1. Sélectionnez les plans dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application.

        Une fois l'intégration de l'outil terminée, seuls les éléments de travail de ces plans sélectionnés sont importés automatiquement.

      2. Sélectionnez Suivant.

        Étape du playbook de suivi des plans

    8. Sélectionnez les référentiels à suivre.
      1. Sélectionnez les référentiels dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application.
      2. Sélectionnez Suivant.

        Sélectionnez les référentiels à suivre.

      3. Si vous souhaitez importer des données de référentiel, sélectionnez la plage de dates, puis Soumettre.

        Vous pouvez importer jusqu'à 90 jours de données. Les workflows associés aux référentiels sont également importés.

    9. Sélectionnez les pipelines à suivre.
      1. Sélectionnez les pipelines dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application.

      2. Sélectionnez Suivant.

      3. Pour chaque pipeline sélectionné, toutes les étapes sont importées pour la dernière exécution réussie. Dans l'activité Assign services to pipeline steps (Affecter des services aux étapes du pipeline), vous pouvez sélectionner les éléments suivants pour chaque étape du pipeline :
        1. Type d'étape du pipeline : sélectionnez un type d'étape auquel vous souhaitez affecter un service.

          Conseil :
          indiquez au moins le type d'étape Prod deploy pour les étapes qui représentent le déploiement de production afin de permettre à DevOps d'identifier les exécutions de pipeline correctes en tant que déploiements de production.
        2. Service : sélectionnez le service d'application CMDB auquel l'étape de pipeline est mappée.

          Le service d'application est mappé approximativement à l'environnement. Si vous utilisez la même étape de pipeline pour procéder au déploiement dans différents environnements, laissez le champ vide. Les informations sur le service permettent à DevOps d'identifier et de signaler des mesures opérationnelles telles que les incidents, les pannes, etc.

      4. Sélectionnez Suivant.

        Affectez des services aux pipelines à partir de GitHub.

    10. Dans la page Résumé, sélectionnez Afficher l'enregistrement de l'outil pour examiner les détails de l'outil GitHub connecté.

      Résumé de connexion

      Pour les pipelines GitHub Actions, vous devez effectuer des étapes supplémentaires telles que la création de secrets, la définition de la configuration de workflow dans GitHub, etc. Pour plus d'informations, consultez Configurations de GitHub Actions.

    Résultats

    Vous avez intégré avec succès votre outil GitHub à Vélocité de changement DevOps.

    Que faire ensuite

    Vous pouvez également détecter manuellement les plans une fois que votre outil GitHub est intégré. Comme il n'existe aucune entité de plan dans GitHub, les référentiels sont pris en compte pour détecter les enregistrements de plan correspondants dans ServiceNow.

    1. Sur la page d'enregistrement de l'outil, sélectionnez Détecter pour détecter les plans.
    2. Sélectionnez Configurer. Les plans sont suivis, et un webhook appelé issues est créé pour envoyer des notifications en temps réel pour les éléments de travail.
    Les informations suivantes sont mises à jour pour un élément de travail dans ServiceNow lorsque le problème correspondant est mis à jour dans GitHub.
    • Changement de l'intitulé du problème
    • Mise à jour des délégataires
    • Transfert d'un problème
      Remarque :
      lorsqu'un problème est transféré, il est marqué comme transféré dans le référentiel à partir duquel il est transféré et ouvert dans le référentiel vers lequel il est transféré.
    • Suppression d'un problème
      Remarque :
      lorsqu'un problème est supprimé dans GitHub, l'élément de travail correspondant n'est pas supprimé dans ServiceNow, mais l'état de l'élément de travail est marqué comme supprimé.

    Si vous effectuez une mise à niveau, les plans de vos référentiels sont détectés via la tâche planifiée de découverte périodique ou via la découverte manuelle. Une fois vos plans détectés, vous pouvez activer la propriété sn_devops.track.github.issues pour reconfigurer en une seule fois tous les référentiels précédemment configurés afin que tous les plans soient suivis et que le webhook des problèmes soit créé pour les éléments de travail.

    Remarque :
    l'importation de l'historique des plans n'est pas prise en charge.