GitLab konfigurieren

Continuous Delivery wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, ca-tor, us-east. Code Risk Analyzer wird zu diesem Zeitpunkt ebenfalls in allen Regionen eingestellt. Wenn diese Funktionen in einer Region nicht aktiv genutzt werden, können sie in dieser Region vorzeitig eingestellt werden, sodass keine neuen Instanzen mehr akzeptiert werden. Weitere Informationen

GitLab ist ein webbasierter Hosting-Service für Git-Repositorys. Sie können sowohl über lokale als auch über ferne Kopien Ihrer Repositorys verfügen, was die Zusammenarbeit sehr einfach gestaltet.

Sie können GitLab als Toolintegration in Ihrer Toolchain konfigurieren, sodass Sie Quellcode in einem neuen oder vorhandenen Repository unter GitLab.com oder in der GitLab-Instanz Ihres Unternehmens verwalten können. Nehmen Sie über Wikis, Problemverfolgung und Merge-Anforderungen am Social Coding teil.

Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, führen Sie diese Schritte aus:

  1. Wenn Sie Ihren Quellcode in einem GitLab-Repository GitLab speichern, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf GitLab. Wenn Sie diese Toolintegration auf IBM Cloud Public konfigurieren, müssen Sie IBM Cloud für den Zugriff auf GitLab autorisieren, indem Sie entweder OAuth oder Personal Access Token.

    • Wenn Sie OAuth wählen, klicken Sie auf Autorisieren, um die Website GitLab aufzurufen. Wenn keine aktive GitLab-Sitzung existiert, werden Sie aufgefordert, sich anzumelden. Klicken Sie auf Anwendung autorisieren, um IBM Cloud den Zugriff auf Ihr GitLab-Konto zu erlauben. Falls eine aktive GitLab-Sitzung existiert, Sie Ihr Kennwort aber bereits vor einiger Zeit eingegeben haben, werden Sie möglicherweise aufgefordert, Ihr GitLab-Kennwort durch erneute Eingabe zu bestätigen.

    • Wenn Sie persönliches Zugriffstoken auswählen, müssen Sie das persönliche Zugriffstoken eingeben, das für die Autorisierung mit GitLab zum Klonen von Repositorys und zum Ausführen anderer Aktionen in Ihrem Namen verwendet werden soll. Wenn Sie kein persönliches Zugriffstoken haben, können Sie anhand der Dokumentation auf der GitLab-Website eines erstellen. Stellen Sie sicher, dass Ihr persönliches Zugriffstoken über api-Berechtigungen verfügt.

  2. Wenn Sie ein Repository auf Ihrem eigenen GitLab-Server verwenden, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf Angepassten Server hinzufügen.

    a. Geben Sie einen Titel für Ihren benutzerdefinierten GitHub Server ein, legen Sie das Stammverzeichnis URL für den Server fest und geben Sie Ihr persönliches Zugriffstoken ein.

    b. Wenn Sie kein persönliches Zugriffstoken haben, können Sie anhand der Dokumentation auf der GitLab-Website eines erstellen.

    c. Wenn Ihr GitHub-Server Air-Gapped ist oder nicht über das öffentliche Internet erreichbar ist, können Sie einen Delivery Pipeline Private Worker anschließen und integrieren, der auf Ihrer eigenen Kubernetes-Infrastruktur läuft, um auf interne oder firmeninterne Ressourcen zuzugreifen. Weitere Informationen zu Delivery Pipeline Private Workers finden Sie unter Arbeiten mit Delivery Pipeline Private Workers.

  3. Überprüfen Sie die Standardspeicherorte für die GitLab-Zielrepositorys. Diese Repositorys werden aus den Beispielrepositorys geklont. Ändern Sie gegebenenfalls die Namen der Zielrepositorys.

Wenn Sie diese Toolintegration zu einer bereits vorhandenen Toolchain hinzufügen, führen Sie diese Schritte aus:

  1. Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol (Hamburger-Symbol ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf die Toolchain, um die zugehörige Übersichtsseite zu öffnen.

  2. Klicken Sie auf Tool hinzufügen.

  3. Klicken Sie im Abschnitt mit den Toolintegrationen auf GitLab.

  4. Klicken Sie auf den GitLab-Server, den Sie verwenden wollen.

  5. Falls Sie über ein GitLab-Repository verfügen und dieses verwenden möchten, klicken Sie beim Repository-Typ auf Vorhanden und geben Sie die URL ein.

  6. Falls Sie ein neues GitLab-Repository verwenden möchten, geben Sie einen Namen für das Repository ein, geben Sie die URL für das Repository ein, das Sie klonen oder verzweigen, und wählen Sie den Repository-Typ aus:

    a. Klicken Sie auf Neu, um ein leeres Repository zu erstellen.

    b. Klicken Sie auf Klonen, um eine Kopie eines GitLab-Repositorys zu erstellen.

    c. Klicken Sie auf Verzweigen, um ein GitLab-Repository zu verzweigen, sodass Sie Änderungen per Zusammenführungsanforderungen (Merge) beitragen können.

  7. Wenn Sie ein öffentliches Repository auf dem Server erstellen wollen, inaktivieren Sie das Kontrollkästchen Repository als privat definieren.

  8. Wenn Sie GitLab Issues für die Verfolgung von Problemen verwenden möchten, wählen Sie das Kontrollkästchen GitLab Issues aktivieren aus.

  9. Wenn Sie die Bereitstellung von Codeänderungen bei Commits durch Erstellen von Tags und Kommentaren und bei Problemen, die über die Commits referenziert werden, mit Bezeichnungen und Kommentaren verfolgen wollen, wählen Sie das Kontrollkästchen Bereitstellung von Codeänderungen verfolgen aus.

  10. Klicken Sie auf Integration erstellen.

  11. Klicken Sie auf der Übersichtsseite Ihrer Toolchain auf der Karte Repositorys auf das GitLab-Repository, mit dem Sie arbeiten möchten. Abhängig von dem von Ihnen ausgewählten Repository wird entweder die GitLab-Website oder das GitLab-Repository Ihres Unternehmens geöffnet, wo die Inhalte des Repositorys angezeigt werden.

  12. Falls Sie GitLab Issues aktiviert haben, klicken Sie auf GitLab Issues, um GitHub Issues zu öffnen. Sie können diese Instanz von GitLab Issues für Ihre gesamte Toolchain verwenden, selbst wenn die Toolchain mehr als nur ein GitLab-Repository enthält.

    Falls Sie nicht über Eigner- oder Masterberechtigung für das Repository verfügen, zu dem Sie einen Link herstellen, ist Ihre Integration eingeschränkt, da Sie keine Web-Hooks verwenden können. Web-Hooks sind erforderlich, um eine Pipeline automatisch auszuführen, wenn ein Commit per Push-Operation an das Repository übertragen wird. Ohne Web-Hook müssen Sie Ihre Pipelines manuell starten.

GitLab mithilfe der API konfigurieren

Die GitLab Tool-Integration unterstützt die folgenden Konfigurationsparameter, die Sie mit der HTTP Toolchain-API und den SDKs verwenden können, wenn Sie Tool-Integrationen erstellen, lesen und aktualisieren.

Sie müssen die Eigenschaft tool_type_id im Anforderungshauptteil mit dem Wert gitlab angeben.

Parameter für die Integration desGitLab
Parameter Verwendung Typ Terraform-Argument Beschreibung
API-Root-URL Optional, aktualisierbar Zeichenfolge API-Root-URL Die URL der GitLab-API.
API-Token Optional, aktualisierbar Kennwort API-Token Das Personal Access Token (PAT). Dieser Parameter ist nur erforderlich, wenn auth_type auf pat gesetzt ist. Andernfalls wird er ignoriert.
auth_type optional, aktualisierbar, Default: oauth Zeichenfolge auth_type Legen Sie die Authentifizierungsmethode für den Zugriff auf den Git-Provider fest.
Blindverbindung optional, aktualisierbar, Default: false Boolescher Wert Blindverbindung Setzen Sie diesen Wert auf true, um anzuzeigen, dass der Server im öffentlichen Internet nicht ansprechbar ist, weil IBM Cloud die von Ihnen angegebenen Verbindungsdetails nicht validieren kann. Bestimmte Funktionen, die API-Zugriff auf den Git-Server erfordern, werden deaktiviert. Delivery Pipeline funktioniert nur unter Verwendung eines privaten Workers, der Netzwerkzugriff auf den Git-Server hat.
Standardverzweigung Optional, aktualisierbar Zeichenfolge Standardverzweigung Der Name der Standardverzweigung des Git-Repositorys
enable_traceability optional, aktualisierbar, Default: false Boolescher Wert enable_traceability Setzen Sie diesen Wert auf, um true die Bereitstellung von Codeänderungen zu verfolgen, indem Sie Tags, Labels und Kommentare zu Commits, Pull-Anfragen und referenzierten Issues erstellen.
Git-ID Optional, unveränderlich Zeichenfolge Git-ID Setzen Sie diesen Wert für gitlab.comauf gitlab oder auf die GUID eines angepassten GitLab-Servers.
has_issues optional, aktualisierbar, Default: true Boolescher Wert toolchain_issues_aktiviert Setzen Sie diesen Wert auf true, um Probleme im GitLab-Repository zu aktivieren und eine Toolintegrationskarte für Probleme zur Toolchain hinzuzufügen. Setzen Sie diesen Wert auf false, um die Toolintegrationskarte aus der Toolchain zu entfernen. Diese Aktion hat keine Auswirkung darauf, ob Probleme im GitLab-Repository selbst aktiviert sind.
Integrationseigner Optional, aktualisierbar Zeichenfolge Integrationseigner Wählen Sie den Benutzer aus, für den Git-Operationen ausgeführt werden sollen.
owner_id Optional, unveränderlich Zeichenfolge owner_id Der Benutzer oder die Gruppe GitLab, der bzw. die Eigner des Repositorys ist. Dieser Parameter ist erforderlich, wenn Sie ein Repository erstellen oder ein Repository klonen oder verzweigen. Dieser Wert wird berechnet, wenn Sie einen Link zu einem vorhandenen Repository erstellen.
Privates Repository Optional, nicht veränderbar, Default: true Boolescher Wert Privates Repository Setzen Sie diesen Wert auf true, damit das Repository privat wird, wenn Sie ein Repository erstellen oder ein Repository klonen oder verzweigen. Dieser Parameter wird nicht verwendet, wenn Sie einen Link zu einem vorhandenen Repository erstellen.
ID des Repository Optional, unveränderlich Zeichenfolge ID des Repository Die ID des Projekts GitLab.
repo_name Optional, unveränderlich Zeichenfolge repo_name Der Name des zu erstellenden GitLab-Repositorys. Dieser Parameter ist erforderlich, wenn Sie ein Repository erstellen oder ein Repository klonen oder verzweigen. Dieser Wert wird berechnet, wenn Sie einen Link zu einem vorhandenen Repository erstellen.
repo_url Optional, unveränderlich Zeichenfolge repo_url Die URL des GitLab Repos für diese Tool-Integration. Dieser Parameter ist erforderlich, wenn Sie einen Link zu einem vorhandenen Repository erstellen. Dieser Wert wird berechnet, wenn Sie ein Repository erstellen oder ein Repository klonen oder verzweigen.
Quellenrepo_url Optional, unveränderlich Zeichenfolge Quellenrepo_url Der URL des Repositorys, das Sie forken oder klonen möchten. Dieser Parameter ist erforderlich, wenn Sie ein Repository aufspalten oder klonen, er wird jedoch nicht verwendet, wenn Sie ein Repository oder einen Link zu einem vorhandenen Repository erstellen.
Token-URL Optional, aktualisierbar Zeichenfolge Token-URL Das Token, URL das zur Autorisierung beim Server GitLab verwendet wird.
Typ Erforderlich, nicht veränderbar Zeichenfolge Typ Die auszuführende Operation zum Initialisieren der neuen Toolintegration. Verwenden Sie new, um ein Git-Repository zu erstellen, clone um ein vorhandenes Repository in ein neues Git-Repository zu klonen, fork um ein vorhandenes Git-Repository zu verzweigen oder link um ein vorhandenes Git-Repository zu verlinken.