Git Repos and Issue Tracking konfigurieren

DevOps Insights wird am 31. August 2026 das Ende des Betriebs erreichen und eingestellt werden. 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

Die Integration des Git Repos and Issue Tracking-Tools basiert auf GitLab Community Edition, einem webbasierten Hosting-Dienst für Git-Repositorys (Repos). Sie können sowohl über lokale als auch über ferne Kopien Ihrer Repositorys verfügen. Weitere Informationen finden Sie unter Git Repos and Issue Tracking.

Wenn Sie Git Repos and Issue Tracking konfigurieren, während Sie die Toolchain erstellen, führen Sie diese Schritte aus:

  1. Klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf Git Repos and Issue Tracking.
  2. Überprüfen Sie die Standardzielspeicherorte für die Git-Repositorys. Diese Repositorys werden aus den Beispielrepositorys geklont. Ändern Sie gegebenenfalls die Namen der Zielrepositorys.

Wenn Sie eine Toolchain haben und ein Git-Repository in Ihrer Toolchain auf Git Repos and Issue Tracking migrieren wollen, führen Sie die folgenden Schritte aus:

Diese Anweisungen gelten für Toolchains, die bereits das Git-Repository enthalten, das Sie auf Git Repos and Issue Tracking migrieren wollen. Informationen zum Hinzufügen verschiedener Typen von Git-Repositorys zu Ihrer Toolchain finden Sie unter GitHub konfigurieren und GitLab konfigurieren.

  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 Hinzufügen.
  3. Klicken Sie im Abschnitt mit den Toolintegrationen auf Git Repos and Issue Tracking.
  4. Wählen Sie den Server aus, auf dem Sie Codeänderungen bereitstellen möchten. Nachdem Sie die Integration erstellt haben, können Sie sie bearbeiten, um die Liste der Server zu verwalten, mit denen Sie berechtigt sind zu arbeiten. Klicken Sie auf Berechtigung verwalten ,um eine Liste aller Server anzuzeigen und das Token zu löschen, das Sie für die Autorisierung mit dem Server angegeben haben.
  5. Um eine Kopie des Git-Repositorys zu erstellen, klicken Sie auf Klonen. Geben Sie einen neuen Repository-Namen und die URL für das Quellenrepository ein.
  6. Ihr Benutzername wird automatisch ausgewählt, um Ihnen den Besitz dieser neuen Integration zuzuweisen. Nachdem die Integration erstellt wurde, kann ein anderer autorisierter Benutzer den Besitz der Integration an sich selbst neu zuweisen, wenn er sie bearbeitet.
  7. Wenn Sie ein privates Repository erstellen möchten, wählen Sie das Kontrollkästchen Dieses Repository privat erstellen aus.
  8. Wenn Sie Issues für die Verfolgung von Problemen verwenden möchten, wählen Sie das Kontrollkästchen 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.

Wenn Sie das Git-Repository geklont haben, können Sie es aus Ihrer Toolchain entfernen.

Wenn Sie Git Repos and Issue Tracking 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 Git Repos and Issue Tracking.

  4. Wählen Sie den Server aus, auf dem Sie Codeänderungen bereitstellen möchten. Nachdem Sie die Integration erstellt haben, können Sie sie bearbeiten, um die Liste der Server zu verwalten, mit denen Sie berechtigt sind zu arbeiten. Klicken Sie auf Berechtigung verwalten ,um eine Liste aller Server anzuzeigen und das Token zu löschen, das Sie für die Autorisierung mit dem Server angegeben haben.

  5. Wählen Sie einen Repository-Typ aus. Gehen Sie dazu wie folgt vor:

    a. Um ein leeres Repository zu erstellen, klicken Sie für den Repository-Typ auf Neu und geben Sie einen Repository-Namen ein. b. Um ein Git-Repository zu verzweigen, sodass Sie Änderungen über Zusammenführungsanforderungen (Merge) beitragen können, klicken Sie auf Verzweigen. Geben Sie die URL für das Quellenrepository ein. c. Um eine Kopie eines Git-Repositorys zu erstellen, klicken Sie auf Klonen. Geben Sie einen neuen Repository-Namen und die URL für das Quellenrepository ein. d. Falls Sie über ein Git-Repository verfügen und dieses verwenden möchten, klicken Sie beim Repository-Typ auf Vorhanden. Geben Sie die URL für das Quellenrepository ein.

  6. Ihr Benutzername wird automatisch ausgewählt, um Ihnen den Besitz dieser neuen Integration zuzuweisen. Nachdem die Integration erstellt wurde, kann ein anderer autorisierter Benutzer den Besitz der Integration an sich selbst neu zuweisen, wenn er sie bearbeitet.

  7. Wenn Sie ein privates Repository erstellen möchten, wählen Sie das Kontrollkästchen Dieses Repository privat erstellen aus.

  8. Wenn Sie Issues für die Verfolgung von Problemen verwenden möchten, wählen Sie das Kontrollkästchen 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 Git-Repository, mit dem Sie arbeiten möchten. Die Übersichtsseite für Ihr Projekt wird geöffnet.

Falls Sie nicht über Master- oder Eignerberechtigung 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.

Git Repos and Issue Tracking-Konfiguration mithilfe der API

Die Git Repos and Issue Tracking Werkzeugintegration unterstützt die folgenden Konfigurationsparameter, die Sie mit der Toolchain HTTP API und den SDKs verwenden können, wenn Sie Werkzeugintegrationen erstellen, lesen und aktualisieren.

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

parameter für die WerkzeugintegrationGit Repos and Issue Tracking
Parameter Verwendung Typ Terraform-Argument Beschreibung
API-Root-URL Optional, aktualisierbar Zeichenfolge API-Root-URL Die URL der Git Repos and Issue Tracking-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.
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 auf hostedgit, um Git Repos and Issue Trackingals Ziel festzulegen.
has_issues optional, aktualisierbar, Default: true Boolescher Wert toolchain_issues_aktiviert Setzen Sie diesen Wert auf true, um Probleme im Git Repos and Issue Tracking-Repository zu ermöglichen, und fügen Sie der Toolintegrationskarte 'Probleme' zur Toolchain hinzu. Setzen Sie diesen Wert auf false, um die Toolintegrationskarte aus der Toolchain zu entfernen. Diese Aktion hat keine Auswirkungen darauf, ob Probleme im Git Repos and Issue Tracking-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 Git Repos and Issue Tracking-Benutzer oder die Gruppe, 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, um das Repository privat zu machen, wenn Sie ein Repository erstellen oder wenn Sie 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 Git Repos and Issue Tracking.
repo_name Optional, unveränderlich Zeichenfolge repo_name Der Name des zu erstellenden Git Repos and Issue Tracking-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 herstellen.
repo_url Optional, unveränderlich Zeichenfolge repo_url Die URL des Git Repos and Issue Tracking Repo 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 Die URL des Projektarchivs, 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 Das Token URL, das für die Autorisierung beim Server Git Repos and Issue Tracking 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 Git-Repository in ein neues Git-Repository zu klonen, fork um ein vorhandenes Git-Repository zu verzweigen oder link um eine Verknüpfung zu einem vorhandenen Git-Repository herzustellen.

Wenn Sie mit einem IBM Cloud vertrauenswürdigen Profil angemeldet sind, müssen Sie bei der Konfiguration einer Git Repos and Issue Tracking Tool-Integration die Authentifizierungsmethode „Persönlicher Zugriffstoken“ verwenden. Die Authentifizierungsmethode OAuth ist nicht kompatibel mit der Authentifizierung über Trusted Profiles.The. Mit der PAT-Authentifizierung (Personal Access Token) können Sie die Integration des Tools Git Repos and Issue Tracking entweder über die GUI, die API oder Terraform konfigurieren. Der Grund dafür ist, dass das PAT an den tatsächlichen Benutzer gebunden ist, der das vertrauenswürdige Profil besitzt. Benutzer können ihre persönlichen Zugangstoken verwenden, um Git Repos and Issue Tracking Tool-Integrationen in der Toolchain zu erstellen oder neu zu konfigurieren. Sie sollten sich jedoch als normaler Benutzer anmelden, um auf die eigentliche Git Repo UI zugreifen zu können.