So verwenden Sie IBM® App Connect mit GitLab

Gitlab ist eine DevOps Plattform, die kontinuierliche Integration und kontinuierliche Bereitstellung (CI/CD) sowie Bereitstellung in einer einzigen Anwendung ermöglicht.

Unterstützte Produkt- und API-Versionen

Um herauszufinden, welche Produkt- und API-Versionen dieser Konnektor unterstützt, siehe Detaillierte Systemanforderungen auf der Seite IBM Support.

Verbinden mit GitLab

Füllen Sie die Verbindungsfelder aus, die Sie auf der Seite „Verbinden“ > „Anwendungen und APIs“ (früher die Seite „Katalog “) App Connect Designers oder im Flow-Editor sehen. Wenden Sie sich bei Bedarf an Ihren GitLab administrator, um diese Werte zu erhalten.

GitLab verbindungsfelder:

Anwendungstyp
Wählen Sie die Gitlab-Umgebung aus, mit der Sie sich verbinden möchten:
  • GitLab selbstverwaltet - (Standardeinstellung): Eine GitLab -Instanz, die Sie vor Ort oder in der Cloud bereitgestellt haben.
  • GitLab.com : Geführt und verwaltet von GitLab Inc.
Methode der Autorisierung
Wählen Sie die gewünschte Autorisierungsmethode und klicken Sie dann auf Weiter.
  • Geben Sie einen Benutzernamen, ein Kennwort und Client-Anmeldeinformationen an (OAUTH 2.0 PASSWORD) - (Standardeinstellung)
  • Bereitstellung von Anmeldeinformationen für App Connect (BASIC)

Geben Sie dann in den Verbindungsfeldern Werte für die von Ihnen gewählte Gitlab-Umgebung und Autorisierungsmethode an:

Berechtigungstyp Anschlussfelder Anwendbarkeit
Verwenden Sie die Website der Anwendung, um sich anzumelden (OAUTH 2.0 AUTH CODE) (Nur für Git Lab.com nur)   App Connect
Bereitstellung von Anmeldeinformationen für App Connect (BASIC) Endpunkt URL - (Nur für GitLab selbstverwaltet ) App Connect und App Connect in containers
Persönliches Zugriffstoken
Geben Sie einen Benutzernamen, ein Kennwort und Client-Anmeldedaten an (OAUTH 2.0 PASSWORD) Endpunkt URL - (Nur für GitLab selbstverwaltet ) App Connect und App Connect in containers
Benutzername
Kennwort
Client-ID
Geheimer Clientschlüssel
Endpunkt-URL
Die URL der selbstverwalteten Gitlab-Instanz. Beispiel: https://<hostName>:<port_number>.
  • Erforderlich: Wahr
Persönliches Zugriffstoken
Geben Sie das persönliche Zugriffstoken für die Authentifizierung mit der GitLab API an. Für weitere Informationen siehe https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html.
  • Erforderlich: Wahr
Benutzername
Der Benutzername, mit dem Sie sich bei Ihrem GitLab Konto anmelden
  • Erforderlich: Wahr
Kennwort
Das Passwort für die Anmeldung bei Ihrem GitLab Konto
  • Erforderlich: Wahr
Client-ID
Geben Sie die in GitLab erstellte Anwendungs-ID an. Für weitere Informationen siehe https://docs.gitlab.com/ee/integration/oauth_provider.html.
  • Erforderlich: Wahr
Geheimer Clientschlüssel
Geben Sie das in GitLab erstellte Anwendungsgeheimnis an. Für weitere Informationen siehe https://docs.gitlab.com/ee/integration/oauth_provider.html.
  • Erforderlich: Wahr

Um zum ersten Mal von der Seite „Anwendungen und APIs“ App Connect Designers aus eine Verbindung zu einem GitLab -Endpunkt herzustellen, erweitern Sie GitLab und klicken Sie dann auf Verbinden. Weitere Informationen finden Sie unter Verwalten von Konten.

Allgemeine Aspekte

Bevor Sie den App Connect Designer mit GitLab verwenden, sollten Sie die folgenden Punkte beachten:

  • (Allgemeine Überlegungen) Eine Liste der verfügbaren Trigger-Ereignisse und Aktionen finden Sie auf der Seite Anwendungen und APIs des App Connect Designers.

    Bei einigen Anwendungen hängen die Ereignisse und Aktionen von der Umgebung ab und davon, ob der Konnektor konfigurierbare Ereignisse und eine dynamische Ermittlung von Aktionen unterstützt. Wenn die Anwendung konfigurierbare Ereignisse unterstützt, wird ein Link Weitere konfigurierbare Ereignisse anzeigen unter der Ereignisliste angezeigt. Wenn die Anwendung die dynamische Erkennung von Aktionen unterstützt, sehen Sie unter der Liste der Aktionen einen Link Mehr anzeigen.

  • (Allgemeine Überlegung) Wenn Sie mehrere Konten für eine Anwendung verwenden, kann die Menge der Felder, die angezeigt wird, wenn Sie eine Aktion für diese Anwendung auswählen, für verschiedene Konten unterschiedlich sein. Im Ablaufeditor stellen einige Anwendungen immer einen kuratierten Satz von statischen Feldern für eine Aktion bereit. Andere Anwendungen verwenden die dynamische Suche, um die Felder abzurufen, die auf der Instanz, mit der Sie verbunden sind, konfiguriert sind. Wenn Sie zum Beispiel zwei Konten für zwei Instanzen einer Anwendung haben, kann das erste Konto Einstellungen verwenden, die sofort verwendet werden können. Das zweite Konto kann jedoch mit zusätzlichen benutzerdefinierten Feldern konfiguriert sein.

Ereignisse und Aktionen

GitLab veranstaltungen

Diese Ereignisse beziehen sich auf Änderungen in dieser Anwendung, die einen Ablauf auslösen, um die Aktionen im Ablauf zu vollenden.

Mehr konfigurierbare Ereignisse anzeigen : Ereignisse, die standardmäßig angezeigt werden, sind durch optimierte Konnektivität vorkonfiguriert. Weitere Elemente sind verfügbar, nachdem Sie Ereignisse konfiguriert haben, die einen Fluss auslösen können, indem sie diese Anwendung nach neuen oder aktualisierten Objekten abfragen.

Hinweis: In Containern können nur lokale Konten für diese Ereignisse verwendet werden.

GitLab aktionen

Ihr Arbeitsablauf vervollständigt diese Aktionen für diese Anwendung.

Objekt Aktion Beschreibung
Mitglieder Mitglied hinzufügen Fügt ein Mitglied zu einer Gruppe oder einem Projekt hinzu
Mitglied bearbeiten Aktualisiert ein Mitglied einer Gruppe oder eines Projekts
Mitglied entfernen Entfernt ein Mitglied aus einer Gruppe oder einem Projekt
Mitglieder abrufen Ruft alle Mitglieder einer Gruppe oder eines Projekts ab
Notizen zum Zusammenführungsantrag Notiz zum Seriendruckauftrag erstellen Erzeugt eine neue Notiz für eine einzelne Zusammenführungsanfrage
Notiz zum Zusammenführen von Anträgen löschen Löscht eine bestehende Notiz einer Zusammenführungsanfrage
Abrufen von Notizen zu Zusammenführungsanfragen Ruft eine Liste aller Notizen in einer Zusammenführungsanfrage ab
Notiz zum Zusammenführungsantrag aktualisieren Aktualisiert die bestehende Notiz einer Zusammenführungsanfrage
Anfragen zusammenführen Zusammenführungsanfrage akzeptieren Die Zusammenführung von Änderungen, die während einer Zusammenführungsanforderung eingereicht wurden
Seriendruckauftrag erstellen Erstellt eine Zusammenführungsanfrage
Zusammenführungsantrag löschen Löscht eine Zusammenführungsanfrage
Abrufen von Zusammenführungsanträgen Ruft eine Liste von Zusammenführungsanträgen ab
Zusammenführungsantrag aktualisieren Aktualisiert die Eigenschaften einer Zusammenführungsanfrage
Meilensteine Meilenstein erstellen Erzeugt einen Meilenstein
Meilenstein löschen Löscht einen Meilenstein
Abrufen von Meilensteinen Ruft eine Liste von Meilensteinen ab
Meilenstein aktualisieren Aktualisiert die Eigenschaften eines Meilensteins
Namensbereiche Abrufen von Namespaces Ruft eine Liste von Namespaces ab
Pipelines Stornierung von Aufträgen in einer Pipeline Storniert die Aufträge einer Pipeline
Pipeline erstellen Erzeugt eine Pipeline
Pipeline löschen Löscht eine Pipeline
Abrufen von Pipelines Ruft eine Liste von Pipelines ab
Wiederholung von Aufträgen in einer Pipeline Wiederholt Aufträge in einer Pipeline
Projekte Projekt erstellen Erzeugt ein neues Projekt in GitLab
Projekt löschen Löscht ein Projekt, das alle zugehörigen Ressourcen wie Probleme und Zusammenführungsanfragen enthält
Projekte abrufen Ruft eine Liste aller sichtbaren Projekte auf GitLab für den authentifizierten Benutzer ab
Projekt mit der Gruppe teilen Teilt das Projekt mit einer Gruppe
Projekt aktualisieren Aktualisiert ein bestehendes Projekt
Releases Release erstellen Erzeugt eine Freigabe
Freigabe löschen Löscht eine Freigabe
Freigaben abrufen Ruft eine Liste von Veröffentlichungen ab
Update-Freigabe Aktualisiert die Eigenschaften einer Veröffentlichung
Tags Tag erstellen Erzeugt ein Tag
Tag löschen Löscht ein Tag
Tags abrufen Ruft eine Liste von Tags ab
Benutzer Benutzer abrufen Ruft eine Liste von Benutzern ab

Beispiele

Dashboard-Kachel für eine Vorlage, die GitLab

Verwenden Sie Vorlagen, um schnell Abläufe zu erstellen für GitLab

Lernen Sie, wie Sie mit App Connect vorlagen verwenden, um schnell Abläufe zu erstellen, die die Aktionen auf GitLab. Öffnen Sie zum Beispiel Discover und suchen Sie nach GitLab.

Dashboard-Kachel für eine Vorlage, die GitLab