GitLab konfigurieren

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:

Wenn Sie Ihren Quellcode in einem GitLab-Repository GitLab speichern, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf GitLab. Wenn Sie diese Toolintegration in IBM Cloud Public konfigurieren, müssen Sie IBM Cloud für den Zugriff auf GitLab berechtigen, indem Sie entweder OAuth oder Persönliches Zugriffstoken auswählen.
- Wenn Sie sich für OAuth entscheiden, klicken Sie auf Autorisieren, um die GitLab-Website 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.
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 angepassten GitHub-Server ein, geben Sie die Stamm-URL für den Server an 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.
Ü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:

Klicken Sie in der Konsole IBM Cloud auf das im Menü > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf die Toolchain, um die zugehörige Übersichtsseite zu öffnen. Alternativ können Sie auf der Übersichtsseite Ihrer App auf der Karte für Continuous Delivery auf Toolchain anzeigen klicken. Klicken Sie anschließend auf Übersicht.
Klicken Sie auf Tool hinzufügen.
Klicken Sie im Abschnitt mit den Toolintegrationen auf GitLab.
Klicken Sie auf den GitLab-Server, den Sie verwenden wollen.
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.
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.
Wenn Sie ein öffentliches Repository auf dem Server erstellen wollen, inaktivieren Sie das Kontrollkästchen Repository als privat definieren.
Wenn Sie GitLab Issues für die Verfolgung von Problemen verwenden möchten, wählen Sie das Kontrollkästchen GitLab Issues aktivieren aus.
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. Weitere Informationen finden Sie unter Verfolgen, wo Ihr Code mit Toolchains bereitgestellt wird.
Klicken Sie auf Integration erstellen.
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.
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.

Konfigurieren von GitLab mithilfe der API

Die GitLab-Toolintegration unterstützt die folgenden Konfigurationsparameter, die Sie mit der Toolchain-HTTP-API und den SDKs verwenden können, wenn Sie Toolintegrationen erstellen, lesenund 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-Token	Optional, aktualisierbar	Kennwort	API-Token	Das persönliche Zugriffstoken (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.
blind_connection	optional, aktualisierbar, `Default: false`	Boolesch	blind_connection	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`	Boolesch	enable_traceability	Setzen Sie diesen Wert auf ' `true`, um den Einsatz von Codeänderungen zu verfolgen, indem Sie Tags, Labels und Kommentare zu Commits, Pull Requests 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`	Boolesch	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`	Boolesch	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 GitLab.
repo_name	Optional, unveränderlich	Zeichenfolge	repo_name	Der Name des zu erstellenden GitLab. 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-Repositorys für diese Toolintegration 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	Die URL des Repositorys, das Sie aufspalten 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	Die Token-URL, die für die Autorisierung beim GitLab-Server 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.