GitLab Spoke

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 à Centre 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.2.0 est la dernière version.

Versions compatibles

Ce spoke a été conçu pour GitLab la version d’API v4, 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 d’application et clé secrète 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 des applications.

Actions du spoke

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


Catégorie	Action	Description
Gestion des branches	Comparer les branches, les balises ou les validations	Compare les branches, les balises ou les validations.
	Créer une branche	Crée une branche dans le projet requis.
	Supprimer la 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 des branches et les détails des branches dans un projet.
	Protéger la branche	Protège une branche dans un projet avec des niveaux d’accès.
	Déprotéger 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.
Gestion des groupes	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 sur le problème	Crée une note sur le problème pour le problème requis.
	Supprimer la note sur le problème	Supprime une note sur le problème pour le problème requis.
	Rechercher le flux de notes sur le 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 du problème.
	Mettre à jour le problème	Met à jour les détails du problème requis.
	Mettre à jour la note sur le problème	Met à jour une note sur un 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 des packages du projet.
	Supprimer un package de projet	Supprime un package du registre des packages du 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 de registre	Supprime les balises du référentiel de registre dans un lot 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 un flux de fichiers de package	Récupère la liste des fichiers de package d’un package unique.
	Rechercher des packages dans le flux du groupe	Récupère une liste de packages de projet et les détails du package au niveau du groupe.
	Rechercher des packages dans le 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 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 de tâches du pipeline de projet	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 le flux de pipelines de projet	Récupère la liste des pipelines d’un projet.
Gestion des hook 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 le hook de projet	Récupère les détails d’un hook spécifié dans un projet.
	Rechercher des crochets de projet	Récupère les détails de tous les crochets 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 dans 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 le jalon d’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 la validation	Récupère les détails d’une validation dans GitLab.
Gestion du code source	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.
Gestion des jetons	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 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 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 du 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 par push dans GitLab.

Webhooks sur spoke

Des webhooks bidirectionnels peuvent être configurés pour être avertis 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 informé. Lorsque les conditions sont remplies, la politique d’acheminement déclenche le flux secondaire associé, qui à son tour automatise les GitLab tâches.

Les webhooks bidirectionnels nécessitent une configuration séparée 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 Webhook GitLab	Affiche la liste des registres de webhook disponibles.
Politiques d’acheminement des webhooks GitLab	Affiche la liste des politiques d’acheminement de webhook disponibles.

Module de spoke

Le GitLabSpoke fournit l’application Gestion des jetons Gitlab qui inclut le module Gestion des jetons Gitlab. 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

Centre 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.