GitHub intégration avec Changements de vélocité DevOps

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

    • Connectez-vous à votre GitHub instance pour détecter les référentiels, les plans, les définitions de pipeline et configurer des notifications ou des interrogations en temps réel pour activer la traçabilité et l’automatisation des changements.

    Vue d’ensemble de l’intégration GitHub

    Changements de vélocité DevOps prend en charge les options Plan (plans), Code (référentiel) et Orchestration (actions) de l’outil GitHub .

    Les deux GitHub et GitHub Enterprise sont pris en charge.

    Les opérations suivantes sont réalisées dans le cadre de l’intégration GitHub:
    • Connecter : découvrez des référentiels, des plans et des définitions de pipeline en connectant vos GitHub instances à Changements de vélocité DevOps.
    • Configurer : activez l’envoi de notifications en temps réel pour les validations, les éléments de travail et les pipelines en créant automatiquement un Webhook (push, problèmes et workflow_job) dans GitHub afin que ces données puissent être utilisées pour créer des politiques de changement.
    Les référentiels d’une organisation peuvent également être détectés et configurés si vous disposez des autorisations de base suivantes pour l’organisation (privilèges des membres) :
    • Détecter : autorisation de base de Lecture.
    • Configurer : autorisation de base de l’administrateur.
    Si Autorisations de base est spécifiée comme Aucune autorisation pour une organisation, les référentiels de cette organisation ne peuvent pas être détectés, même s’ils sont publics. Le propriétaire d’une organisation peut sélectionner tous les référentiels ou des référentiels spécifiques d’une organisation ; seuls les référentiels sélectionnés sont détectés. Même si un référentiel est public, il ne peut pas être découvert à moins que le propriétaire ne le sélectionne pour une organisation.

    Pour les référentiels d’une organisation, vous ne devez pas avoir le même référentiel configuré dans plus d’un outil sur une instance. Si le même référentiel est configuré pour plusieurs outils, les données sont associées à un outil aléatoire dans le cadre des événements de notification. Si vous souhaitez configurer le même référentiel dans un outil différent, vous devez supprimer les webhooks créés à partir du premier outil, annuler le suivi du référentiel sous cet outil, puis configurer le même référentiel dans l’autre outil.

    Méthodes d'authentification

    Vous pouvez vous connecter à GitHub à l’aide de l’une des méthodes d’authentification suivantes :
    • Authentification de base

      Si vous connectez votre instance GitHub avec l’authentification de base, vous pouvez utiliser les actions personnalisées de la place de marché GitHub. Les environnements GitHub ne sont pas pris en charge pour la connexion d’authentification de base.

    • Informations d’identification OAuth 2.0
      • Si vous connectez votre instance GitHub avec les informations d’identification OAuth 2.0 pour le code d’autorisation, vous pouvez utiliser les actions personnalisées de la place de marché GitHub et créer des secrets à utiliser dans les workflows. Pour plus d'informations, consultez Informations d’identification OAuth 2.0 pour GitHub les applications : code d’autorisation.
      • Si vous connectez votre instance GitHub avec les informations d’identification OAuth 2.0 pour GitHub Apps : JWT, vous pouvez utiliser les actions personnalisées de la place de marché GitHub, créer des secrets à utiliser dans les workflows et des environnements GitHub à déployer dans un environnement. Pour plus d'informations, consultez Informations d’identification OAuth 2.0 pour GitHub les applications - JWT. Pour les dépôts GitHub d’une organisation, une seule organisation peut être installée par outil (c’est-à-dire qu’une application GitHub peut être installée avec une organisation GitHub et un outil GitHub). Si vous souhaitez ajouter d’autres organisations, vous pouvez créer des outils et des applications distincts.

    Des actions personnalisées sont ServiceNow disponibles dans GitHub Marketplace pour l’option d’orchestration, pour transmettre des informations à partir d’actions (workflows) et pour mettre en pause ou reprendre des workflows à partir de .Changements de vélocité DevOps Pour en savoir plus sur les actions personnalisées, reportez-vous à la section Actions personnalisées ServiceNow DevOps de la place de marché GitHub.

    Pour capturer les données du workflow dans Changements de vélocité DevOps, vous devez configurer des clés secrètes dans votre GitHub outil. Pour plus d'informations, consultez Configurations GitHub Actions.

    La prise en charge présente quelques limitations GitHub Actions (reportez-vous à la section Configurations GitHub Actions.

    Premiers pas

    Utilisez l’une des options suivantes pour intégrer GitHub. Pour une expérience guidée, utilisez l’espace de travail pour intégrer un outil. Vous pouvez également utiliser l’expérience Catalogue de services ou Classique.