Intégrer GitHub à Vélocité de changement DevOps — Classique

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 Webhook GitHub et obtenez-la lorsque vous soumettez un enregistrement d’outil DevOps .
• Découvrir des référentiels et des plans.
• Configurez le webhook dans le GitHub référentiel.
• Importez des enregistrements de branche et de validation.

Procédure

1. Saisissez les détails de l’instance GitHub pour vous connecter à la vélocité de changement DevOps en accédant à Tous > DevOps > Outils > Créer nouveau (hérité).
2. Entrez une valeur dans le champ Nom de l’outil et renseignez 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 un accès complet. Les champs d’application minimaux 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 Configuration des informations d’identification GitHub OAuth 2.0 pour Vélocité de changement DevOps.

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

3. Facultatif : Sélectionnez Serveur MID pour un outil sur site attaché à un serveur MID.

   L’application est automatiquement définie sur DevOps et l’aptitude est définie sur REST.

   Remarque :

   Le code d’autorisation OAuth et les types d’accords JWT sont pris en charge pour GitHub et GitHub Enterprise avec serveur MID.
4. Sélectionnez Soumettre.

Une fois l’outil créé, vous êtes redirigé vers la page d’enregistrement de l’outil.

5. 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 : 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 :

   Seuls les groupes contenant des utilisateurs dotés DevOps de 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 aux 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 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.

6. Sélectionnez Détecter pour détecter les référentiels, les plans ou les pipelines existants pour l’outil.
   Les enregistrements du référentiel sont ajoutés à la liste connexe Référentiels.
7. Configurez automatiquement l’URL Webhook dans un référentiel pour envoyer des GitHub 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 surOui.

   Remarque :

   Si vous ne disposez pas de 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 le configurer pour vous (créez et configurez l’URL Webhook manuellement dans votre instance d’outil). Une fois le webhook configuré dans l’outil, passez en mode de configuration manuelle pour vous connecter manuellement à l’outil, puis quittez.
8. 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.
9. 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.