Richten Sie den bidirektionalen Webhook für die GitLab-Spoke ein

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Konfigurieren Sie einen Webhook, um GitLab mit einer ServiceNow-Rückruf-URL zu abonnieren.

    Vorbereitungen

    • Fordern Sie ein Integration Hub-Abonnement an
    • Aktivieren Sie die GitLab-Spoke
    • Erforderliche Rolle: admin

    Registrieren Sie den GitLab-Webhook in der ServiceNow-Instanz

    Registrieren Sie GitLab in ServiceNow, um die ServiceNow-App zu benachrichtigen, wenn bestimmte Ereignisse in GitLab auftreten.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > GitLab-Webhooks > GitLab-Webhook-Registrierungen.
    2. Um das vorhandene Webhooks-Konto GitLab abzurufen, klicken Sie auf Alle Webhooks abrufen.
    3. Um einen Webhook zu erstellen, klicken Sie auf Neu.
    4. Füllen Sie die Felder des Formulars aus.
      Felder Beschreibung
      Name Name des Webhook Beispiel: Job-Webhook.
      Beschreibung Beschreibung des Datensatzes.
      Projekt-ID Eindeutiger Identifier des Projekts, für das der Webhook erstellt werden soll.
      Auslöser und SSL Events in den Projekten, die Sie abonnieren möchten. Wenn eines dieser Ereignisse auftritt, wird der Webhook ausgelöst.
    5. Klicken Sie auf den zugehörigen Link Geheimes Token generieren.
      Das geheime Token wird generiert und angezeigt. Außerdem wird das Datum, an dem das Geheimnis abläuft, in Geheimnis abläuft ausgefüllt.
      Hinweis:
      Das Geheimnis wird alle 30 Tage neu generiert und aktualisiert. Dieses Geheimnis wird auch in GitLabaktualisiert.
    6. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    7. Klicken Sie auf Webhook erstellen.
      Der Webhook wird in GitLab erstellt, und seine ID wird in Webhook-ID ausgefüllt.

    Nächste Maßnahme

    Um Details der Webhooks zu aktualisieren oder die abonnierten Events zu ändern, klicken Sie auf Webhook aktualisieren.

    Passen Sie einen bidirektionalen Webhook in der GitLab-Spoke an

    Erstellen Sie eine Webhook-Routing-Richtlinie und einen Subflow gemäß Ihren Anforderungen in der GitLab-Spoke.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Die Standard-Routing-Richtlinie in den Modulen für GitLab-WebHook-Routing-Richtlinien löst den relevanten GitLab-Subflow aus und benachrichtigt die ServiceNow-App, wenn bestimmte Events in GitLab auftreten. Führen Sie die folgenden Schritte aus, um andere Felder in Ihrem benutzerdefinierten Subflow zu verwenden und die Bedingungen in der Weiterleitungsrichtlinie anzupassen.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Subflows.
    3. Erstellen Sie eine Kopie des erforderlichen Subflows.
    4. Passen Sie den erforderlichen Subflow an Ihre Anforderungen an, und veröffentlichen Sie ihn.
      Unter Subflows erstellen finden Sie weitere Informationen zum Erstellen und Verwenden von Subflows. In der GitLab-Spoke finden Sie Informationen zu den GitLab-Feldern, die von der Standard-Routing-Richtlinie unterstützt werden, und zu den GitLab-Events, die von den Subflows unterstützt werden.
    5. Navigieren zu Alle > GitLab-Webhooks > GitLab-Webhook-Routing-Richtlinien.
      Zusammen mit der Spoke sind fünf Routing-Richtlinien verfügbar. Sie können sie gemäß Ihren Anforderungen konfigurieren oder eine Weiterleitungsrichtlinie erstellen.
    6. Um eine Weiterleitungsrichtlinie zu erstellen, klicken Sie auf Neu.
    7. Füllen Sie die Felder des Formulars aus.
      Feld Beschreibung
      Bezeichnung Eindeutige Bezeichnung zur Identifizierung der Routing-Richtlinie.
      Standardantwort Option, um anzugeben, ob dies die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Symbol Nachschlagen.
      2. Wählen Sie den erforderlichen Subflow aus der Liste Dokument: aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
      Bedingung Bedingungen, die erfüllt sein müssen, wenn die erforderlichen Ereignisse in GitLab auftreten.
      Antwort Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind.
    8. Klicken Sie auf Absenden.
      Hinweis:
      Diese Weiterleitungsrichtlinien werden in den Entscheidungstabellen gespeichert. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.

    Ergebnisse

    Weiterleitungsrichtlinie und Subflow werden erstellt.