GitLab Spoke

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 La version2.1.2 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 clé secrète de l’application GitLab
    Voir le GitLab Documentation pour obtenir des instructions sur la création et la configuration d’applications.

    Actions du spoke

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

    Catégorie Action Description
    Gestion des succursales Comparer les balises ou validations des branches 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 branches 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 leurs détails dans un projet.
    Protéger la branche Protège une branche d’un projet avec des niveaux d’accès.
    Ne pas protéger la branche Désprotè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.
    Supprimer 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 de problème Supprime une note de problème pour le problème requis.
    Rechercher le flux de notes de problèmes 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 leurs détails.
    Mettre à jour le problème Met à jour les détails du problème requis.
    Mettre à jour la note de problème Met à jour une note sur un problème dans un projet.
    Merge Request Management 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 des 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 du package de projet.
    Supprimer le package du projet Supprime un package du registre du package de projet.
    Supprimer le 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 dans 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 les détails du package au niveau du groupe.
    Rechercher des packages dans un flux de projet Récupère une liste de packages de projet et les détails du 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 de registre Récupère une liste de référentiels 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 projets 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 hooks de projet Créer un hook de projet Crée une accroche à un projet.
    Supprimer le hook de projet Supprime un hook d’un projet.
    Rechercher un hook de projet Récupère les détails d’un hook spécifié dans un projet.
    Rechercher des hooks de projet Récupère les détails de tous les hooks d’un projet.
    Mettre à jour le hook 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 un flux de tâches de 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 un 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 dans 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 spokes

    Le GitLab spoke fournit des exemples de flux pour illustrer l’automatisation des GitLab tâches. Pour personnaliser un échantillon de flux, copiez-le dans un nouveau périmètre de l’application.
    Flux Description
    Projets d’archivage de plus de 6 mois Archive les projets inactifs au cours des six derniers 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. Exemples de flux secondaires disponibles :
    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 la tâche dans GitLab.
    Traiter les événements de webhook de demande de fusion GitLab Traite les événements de webhook de demande de fusion 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 des spokes

    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 pour GitLab lesquels vous souhaitez être informé. 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 comporte les modules suivants :
    Webhook Description
    Registres de webhook GitLab Affiche la liste des registres de webhook disponibles.
    Politiques d’acheminement de Webhook GitLab Affiche la liste des politiques d’acheminement de webhook disponibles.

    Module de spokes

    Fournit GitLabSpoke l’application Gitlab Token Management qui inclut le module Gitlab Token Managements. Vous devez enregistrer ici pour authentifier les demandes 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’informations 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 un GitLab spoke.

    Configuration requise pour le Serveur MID

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