GitLab Spoke

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 8 minutes de lecture
  • Gérez le cycle de vie DevOps dans GitLab à partir de votre instance ServiceNow. Créez des flux dans ServiceNow pour gérer les branches, les groupes, les problèmes, les demandes de fusion, les projets et le code source dans GitLab.

    Demander des applications dans l'App Store

    Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

    Abonnement à Hub d'intégration

    Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez Calendriers juridiques - Vue d'ensemble du Centre d'intégration.

    Version de spoke

    GitLabSpoke v2.1.3 est la dernière version.

    Versions compatibles

    Ce spoke a été conçu pour GitLab la version v4 de l’API, mais peut être compatible avec les versions ultérieures.

    Exigences relatives au spoke

    • GitLab compte
    • Une application est GitLab configurée pour s’intégrer à ServiceNow
    • ID et secret de l’application GitLab
    Consultez la documentation pour obtenir des instructions sur la création et la https://docs.gitlab.com/ee/integration/oauth_provider.html configuration d’applications.

    Actions du spoke

    Fournit GitLabSpoke des actions pour automatiser les tâches lorsque des GitLab événements se produisent dans ServiceNow. Les actions disponibles sont les suivantes :

    Catégorie Action Description
    Gestion des succursales Comparer les branches, les balises ou les validations Compare des branches, des balises ou des validations.
    Créer une branche Crée une branche dans le projet requis.
    Supprimer une branche Supprime la branche requise d’un projet.
    Supprimer les succursales fusionnées Supprime la branche fusionnée requise d’un projet.
    Rechercher une branche Récupère les détails de la branche requise.
    Rechercher un flux de branches Récupère une liste de branches et les détails de branches dans un projet.
    Protéger la branche Protège une succursale dans un projet avec des niveaux d’accès.
    Annuler la protection de la branche Déprotège une branche d’un projet avec des niveaux d’accès.
    Gestion des groupes Ajouter un utilisateur à un groupe Ajoute un utilisateur à un GitLab groupe.
    Retirer l’utilisateur d’un groupe Supprime l’utilisateur d’un GitLab groupe.
    Gestion des problèmes Créer un problème Crée un problème dans le projet requis.
    Créer une note de problème Crée une note de problème pour le problème requis.
    Supprimer la note sur le problème Supprime une note de problème pour le problème requis.
    Rechercher le flux de notes de problème Récupère toutes les notes de problème dans un problème.
    Rechercher le flux de problèmes Récupère une liste des problèmes et des détails de problème.
    Mettre à jour le problème Met à jour les détails du problème requis.
    Mettre à jour la note du problème Met à jour une note de problème dans un projet.
    Gestion des demandes de fusion Accepter la demande de fusion Approuve une demande de fusion dans GitLab.
    Créer une demande de fusion Crée une demande de fusion dans GitLab.
    Créer une note de demande de fusion Crée une note pour la demande de fusion requise.
    Supprimer la note de demande de fusion Supprime une note pour la demande de fusion requise.
    Rechercher le flux de toutes les demandes de fusion Récupère la liste des demandes de fusion dans un projet.
    Rechercher les notes de demande de fusion Récupère la liste des notes de demande de fusion dans un projet.
    Mettre à jour la demande de fusion Met à jour les détails de la demande de fusion requise.
    Mettre à jour la note de demande de fusion Met à jour les détails de la note de demande de fusion requise.
    Gestion des packages Supprimer le fichier de package Supprime un fichier de package du registre de package de projet.
    Supprimer le package de projet Supprime un package du registre du package de projet.
    Supprimer un référentiel du registre Supprime un référentiel de registre d’un projet.
    Supprimer les balises du référentiel du registre Supprime les balises de référentiel de registre d’un lot à partir d’un projet.
    Rechercher les détails d’un registre Récupère les détails d’un référentiel de registre pour un projet spécifié.
    Rechercher le flux de fichiers de package Récupère la liste des fichiers de package d’un package unique.
    Rechercher des packages dans le flux de groupe Récupère une liste de packages de projet et des détails de package au niveau du groupe.
    Rechercher des packages dans le flux de projet Récupère une liste de packages de projet et des détails de package.
    Rechercher un package de projet Récupère les détails du package spécifié pour un projet spécifié.
    Rechercher des référentiels du Registre Récupère une liste des référentiels de registre pour un projet spécifié.
    Gestion des pipelines Rechercher un pipeline de projet par ID Récupère les détails d’un pipeline spécifié pour un projet spécifié.
    Rechercher le flux des tâches de pipeline de projets Récupère la liste des tâches dans un pipeline de projet.
    Rechercher un rapport de test de pipeline de projet Récupère le rapport de test du pipeline spécifié pour le projet spécifié.
    Rechercher un flux de pipelines de projets Récupère la liste des pipelines dans un projet.
    Gestion des hook de projet Créer un hook de projet Crée une accroche à un projet.
    Supprimer le hook du projet Supprime un hook d’un projet.
    Rechercher une accroche de projet Récupère les détails d’un hook spécifié dans un projet.
    Rechercher des accroches de projet Récupère les détails de tous les hooks d’un projet.
    Mettre à jour une accroche de projet Met à jour les détails d’un hook pour un projet spécifié.
    Gestion des projets Ajouter un utilisateur à un projet Ajoute un utilisateur à un projet dans GitLab.
    Archiver le projet Archive un projet en GitLab.
    Créer un jalon Crée un jalon dans un GitLab projet.
    Créer un projet Crée un projet dans GitLab.
    Supprimer le jalon Supprime un jalon dans un GitLab projet.
    Supprimer le projet Supprime un projet dans GitLab.
    Rechercher un flux de jalons Récupère les détails des jalons GitLab.
    Rechercher un projet Récupère les détails du projet spécifié.
    Rechercher le flux de tâches du projet Récupère les détails des tâches du projet.
    Rechercher un flux de projets Récupère les détails des projets.
    Supprimer l’utilisateur d’un projet Supprime l’utilisateur d’un projet dans GitLab.
    Partager le projet avec le groupe Partage un projet avec un groupe dans GitLab.
    Désarchiver le projet Désarchive un projet dans GitLab.
    Ne plus partager le projet avec le groupe Annule le partage d’un projet avec un groupe dans GitLab.
    Mettre à jour le jalon Met à jour les détails d’un jalon dans un projet.
    Mettre à jour un projet Met à jour les détails d’un projet.
    Gestion du code source Obtenir une validation Récupère les détails d’une validation dans GitLab.
    Ajouter un nouveau fichier au référentiel Ajoute un fichier à un référentiel au format GitLab.
    Gestion des jetons Rechercher des jetons d’accès personnels Récupère une liste des jetons d’accès personnels.
    Révoquer le jeton d’accès personnel Révoque un jeton d’accès personnel.

    Flux de spoke

    Le GitLab spoke fournit des exemples de flux pour illustrer l’automatisation des GitLab tâches. Pour personnaliser un exemple de flux, copiez-le dans un nouveau périmètre de l’application.
    Flux Description
    Archiver les projets de plus de 6 mois Archive les projets inactifs depuis six mois.

    Flux secondaires du spoke

    Le GitLab spoke fournit des exemples de flux pour illustrer l’automatisation des GitLab tâches. Pour personnaliser un exemple de flux secondaire, copiez-le dans un nouveau périmètre de l’application. Les exemples de flux secondaires disponibles sont les suivants :
    Flux secondaires Description
    Traiter les événements de webhook de déploiement GitLab Traite les webhooks de déploiement dans GitLab.
    Traiter les événements de webhook de tâche GitLab Traite les événements de webhook de tâche dans GitLab.
    Traiter les événements de Webhook de demande de fusion GitLab Les processus fusionnent les événements de webhook de demande dans GitLab.
    Traiter les événements de webhook de pipeline GitLab Traite les événements de webhook de pipeline dans GitLab.
    Traiter les événements de webhook push GitLab Traite les événements de webhook push dans GitLab.

    Webhooks de spoke

    Des webhooks bidirectionnels peuvent être configurés pour être informé des événements requis. La politique d’acheminement définit les conditions qui doivent être remplies pour notifier l’application ServiceNow . Ces conditions sont basées sur les événements GitLab pour lesquels vous souhaitez être notifié. Lorsque les conditions sont remplies, la politique d’acheminement déclenche le flux secondaire associé, qui automatise à son tour les GitLab tâches.

    Les webhooks bidirectionnels nécessitent une configuration distincte et peuvent être utilisés indépendamment sans utiliser les actions de spoke. Par défaut, l’application GitLab Webhooks est disponible dans le GitLab spoke et comprend les modules suivants :
    Webhook Description
    Registres Webhook GitLab Affiche la liste des registres webhook disponibles.
    Politiques d’acheminement des webhooks GitLab Affiche la liste des politiques d’acheminement de webhook disponibles.

    Module de spoke

    Ils GitLabSpoke fournissent l’application Gitlab Token Management qui inclut le module Gitlab Token Managements. Vous devez enregistrer ici pour authentifier les demandes à partir de votre ServiceNow instance.

    Exigences en matière d'alias de connexion et d'informations d'identification

    Hub d'intégration utilise des alias pour gérer les informations de connexion et d’identification, ainsi que les informations d’identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.

    Pour en savoir plus sur la configuration du spoke, consultez Configurer le GitLab spoke.

    Configuration requise pour le Serveur MID

    Ces actions utilisent des appels REST, qui peuvent s’exécuter sur un Serveur MID. Utilisez l’enregistrement de connexion associé à l’alias pour configurer l’emplacement GitLab d’exécution des actions et définir Serveur MID les attributs de sélection. Pour en savoir plus, consultez Serveur MID.