GitLab-Spoke

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Verwalten Sie den DevOps-Lebenszyklus in GitLab von Ihrer ServiceNow-Instanz aus. Erstellen Sie Flows in ServiceNow, um Verzweigungen, Gruppen, Probleme, Zusammenführungsanforderungen, Projekte und Quellcode in GitLab zu verwalten.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    IntegrationHub-Abonnement

    Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

    Spoke-Version

    GitLab-Spoke v2.2.0 ist die neueste Version.

    Kompatible Versionen

    Diese Spoke wurde für die GitLab API-Version v4 erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel.

    Spoke-Anforderungen

    • GitLab Account
    • Eine Anwendung in GitLab, die für die Integration mit ServiceNowkonfiguriert ist
    • Anwendungs-ID und Geheimer Schlüssel der Anwendung GitLab .
    Anweisungen zum Erstellen und Konfigurieren von Anwendungen finden Sie in der Dokumentation https://docs.gitlab.com/ee/integration/oauth_provider.html .

    Spoke-Aktionen

    GitLab-Spoke bietet Aktionen zum Automatisieren von GitLab -Aufgaben, wenn Ereignisse in ServiceNoweintreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Niederlassungsverwaltung Vergleichen Sie Verzweigungs-Tags oder Commits Vergleicht Verzweigungen, Tags oder Commits.
    Verzweigung erstellen Erstellt eine Verzweigung im erforderlichen Projekt.
    Löschen Sie die Verzweigung Löscht die erforderliche Verzweigung aus einem Projekt.
    Löschen Sie zusammengeführte Verzweigungen Löscht die erforderliche zusammengeführte Verzweigung aus einem Projekt.
    Suchen Sie nach Verzweigung Ruft die Details der erforderlichen Verzweigung ab.
    Sucht Stream mit Verzweigungen Ruft eine Liste von Verzweigungen und die Verzweigungsdetails in einem Projekt ab.
    Verzweigung schützen Schützt eine Verzweigung in einem Projekt mit Zugriffsebenen.
    Schutz für Verzweigung aufheben Hebt den Schutz einer Verzweigung in einem Projekt mit Zugriffsebenen auf.
    Gruppenverwaltung Fügen Sie einer Gruppe Anwender hinzu Fügt den Anwender einer Gruppe GitLab hinzu.
    Entfernen Sie den Anwender aus einer Gruppe Entfernt einen Anwender aus einer Gruppe GitLab.
    Problemverwaltung Problem erstellen Erstellt ein Problem im erforderlichen Projekt.
    Problemnotiz erstellen Erstellt eine Problemnotiz für das erforderliche Problem.
    Löschen Sie die Problemnotiz Löscht eine Problemnotiz für das erforderliche Problem.
    Sucht den Stream mit Problemhinweisen Ruft alle Problemhinweise in einem Problem ab.
    Stream mit Problemen suchen Ruft eine Liste mit Problemen und Problemdetails ab.
    Problem aktualisieren Aktualisiert Details des erforderlichen Problems.
    Update-Problemnotiz Aktualisiert eine Problemnotiz in einem Projekt.
    Anforderungsmanagement zusammenführen Zusammenführungsanforderung akzeptieren Genehmigt eine Zusammenführungsanforderung in GitLab.
    Zusammenführungsanforderung erstellen Erstellt eine Zusammenführungsanforderung in GitLab.
    Zusammenführungsanforderungsnotiz erstellen Erstellt eine Notiz für die erforderliche Zusammenführungsanforderung.
    Zusammenführungsanforderungsnotiz löschen Löscht eine Notiz für die erforderliche Zusammenführungsanforderung.
    Sucht alle Streams mit Zusammenführungsanforderungen Ruft die Liste der Zusammenführungsanforderungen in einem Projekt ab.
    Sucht nach Notizen zur Zusammenführungsanforderung Ruft die Liste der Zusammenführungsanforderungshinweise in einem Projekt ab.
    Zusammenführungsanforderung aktualisieren Aktualisiert Details der erforderlichen Zusammenführungsanforderung.
    Hinweis zur Zusammenführungsanforderung aktualisieren Aktualisiert die Details des erforderlichen Hinweises auf die Zusammenführungsanforderung.
    Paketverwaltung Löschen Sie die Paketdatei Löscht eine Paketdatei aus der Projektpaketregistrierung.
    Löschen Sie das Projektpaket Löscht ein Paket aus der Projektpaketregistrierung.
    Löschen Sie das Registrierungs-Repository Entfernt ein Registrierungs-Repository aus einem Projekt.
    Löschen Sie die Tags des Registrierungs-Repositorys Entfernt Registrierungs-Repository-Tags in einem Batch aus einem Projekt.
    Sucht Details einer Registrierung Ruft Details eines Registrierungs-Repositorys für ein angegebenes Projekt ab.
    Sucht Stream mit Paketdateien Ruft die Liste der Paketdateien eines einzelnen Pakets ab.
    Sucht Pakete innerhalb des Gruppen-Streams Ruft eine Liste von Projektpaketen und Paketdetails auf Gruppenebene ab.
    Sucht Pakete im Projekt-Stream Ruft eine Liste von Projektpaketen und Paketdetails ab.
    Projektpaket suchen Ruft die Details des angegebenen Pakets für ein angegebenes Projekt ab.
    Sucht Registrierungs-Repositorys Ruft eine Liste von Registrierungs-Repositorys für ein angegebenes Projekt ab.
    Pipeline-Management Sucht Projekt-Pipeline nach ID Ruft die Details einer angegebenen Pipeline für ein angegebenes Projekt ab.
    Sucht nach Stream „Projekt-Pipeline-Aufträge“. Ruft die Liste der Aufträge in einer Projektpipeline ab.
    Sucht nach dem Pipeline-Testbericht des Projekts Ruft den Testbericht der angegebenen Pipeline für das angegebene Projekt ab.
    Sucht Stream mit Projekt-Pipelines Ruft die Liste der Pipelines in einem Projekt ab.
    Projekt-Hook-Verwaltung Projekt-Hook erstellen Erstellt einen Hook für ein Projekt.
    Projekt-Hook löschen Entfernt einen Hook aus einem Projekt.
    Sucht nach Projekt-Hook Ruft Details eines angegebenen Hooks in einem Projekt ab.
    Sucht Projekt-Hooks Ruft Details aller Hooks in einem Projekt ab.
    Projekt-Hook aktualisieren Aktualisiert Details eines Hooks für ein angegebenes Projekt.
    Projektmanagement Fügen Sie einem Projekt einen Anwender hinzu Fügt einem Projekt in GitLabeinen Anwender hinzu.
    Archivprojekt Archiviert ein Projekt in GitLab.
    Meilenstein erstellen Erstellt einen Meilenstein in einem GitLab -Projekt.
    Projekt erstellen Erstellt ein Projekt in GitLab.
    Meilenstein löschen Löscht einen Meilenstein in einem GitLab -Projekt.
    Projekt löschen Löscht ein Projekt in GitLab.
    Stream mit Meilensteinen suchen Ruft die Details der Meilensteine GitLabab.
    Projekt suchen Ruft die Details des angegebenen Projekts ab.
    Sucht Stream mit Projektaufträgen Ruft die Details zu Projektaufträgen ab.
    Stream mit Projekten suchen Ruft die Details der Projekte ab.
    Entfernt einen Anwender aus einem Projekt Entfernt den Anwender aus einem Projekt in GitLab.
    Projekt für Gruppe freigeben Gibt ein Projekt für eine Gruppe in GitLabfrei.
    Archivieren Sie das Projekt Hebt das Archiv eines Projekts in GitLabauf.
    Freigabe des Projekts für Gruppe aufheben Hebt die Freigabe eines Projekts für eine Gruppe in GitLabauf.
    Meilenstein aktualisieren Aktualisiert Details eines Meilensteins in einem Projekt.
    Projekt aktualisieren Aktualisiert Details eines Projekts.
    Quellcodeverwaltung Committen abrufen Ruft Details eines Commits in GitLabab.
    Neue Datei zu Repository hinzufügen Fügt eine Datei zu einem Repository in GitLabhinzu.
    Token-Verwaltung Persönliche Zugriffstoken suchen Ruft eine Liste persönlicher Zugriffstoken ab.
    Persönliches Zugriffstoken widerrufen Widerruft ein persönliches Zugriffstoken.

    Spoke-Flows

    Die GitLab -Spoke stellt Beispiel-Flows bereit, um die Automatisierung der GitLab -Aufgaben zu demonstrieren. Um einen Beispiel-Flow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich.
    Flow Beschreibung
    Archivieren Sie Projekte, die älter als 6 Monate sind Archiviert die Projekte, die in den letzten sechs Monaten inaktiv waren.

    Spoke-Subflows

    Die GitLab -Spoke stellt Beispiel-Flows bereit, um die Automatisierung der GitLab -Aufgaben zu demonstrieren. Um einen Beispiel-Subflow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Folgende Beispiel-Subflows sind verfügbar:
    Subflows Beschreibung
    Verarbeiten Sie Webhook-Ereignisse für die GitLab-Bereitstellung​ Verarbeitet Bereitstellungs-Webhooks in GitLab.
    Verarbeiten Sie Webhook-Ereignisse für GitLab-Aufträge​ Verarbeitet Auftrags-Webhook-Ereignisse in GitLab.
    Verarbeitet Webhook-Ereignisse für GitLab-Merge-Anforderungen Verarbeitet Webhook-Ereignisse für Zusammenführungsanforderung in GitLab.
    Verarbeiten Sie Webhook-Ereignisse in der GitLab-Pipeline​ Verarbeitet Pipeline-Webhook-Ereignisse in GitLab.
    GitLab-Push-Webhook-Ereignisse verarbeiten Verarbeitet Push-Webhook-Ereignisse in GitLab.

    Spoke Webhooks

    Bidirektionale Webhooks können so eingerichtet werden, dass sie über die erforderlichen Ereignisse benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die App ServiceNow zu benachrichtigen. Diese Bedingungen basieren auf den Ereignissen in GitLab, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Weiterleitungsrichtlinie den zugehörigen Subflow aus, der wiederum die Aufgaben GitLab automatisiert.

    Die bidirektionalen Webhooks erfordern ein separates Setup und können unabhängig voneinander ohne Verwendung der Spoke-Aktionen verwendet werden. Standardmäßig ist die Anwendung Webhooks GitLab in der -Spoke GitLab verfügbar und verfügt über die folgenden Module:
    Webhook Beschreibung
    GitLab-Webhook-Registrierungen Zeigt die Liste der verfügbaren Webhook-Registrierungen an.
    GitLab-Webhook-Weiterleitungsrichtlinien Zeigt die Liste der verfügbaren Webhook-Weiterleitungsrichtlinien an.

    Spoke-Modul

    GitLab-Spoke stellt die Anwendung Gitlab Token Management bereit, die das Modul Gitlab Token Managements enthält. Sie sollten hier aufzeichnen, um Anforderungen von Ihrer Instanz ServiceNow zu authentifizieren.

    Alias-Anforderungen für Verbindungen und Anmeldeinformationen

    IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

    Informationen zum Einrichten der Spoke finden Sie unter Richten Sie die GitLab -Spoke ein.

    MID-Server-Anforderungen

    Diese Aktionen verwenden REST-Aufrufe, die für MID-Serverausgeführt werden können. Verwenden Sie den Verbindungsdatensatz, der dem Alias GitLab zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt werden, und um Auswahlattribute für MID-Server festzulegen. Weitere Informationen finden Sie unter MID-Server.