Integrieren eines Projekts in ein Git Repository

Verbinden Sie ein Projekt mit einem Git Repository, um dort Konfigurationen zu speichern. Auf diese Weise können Sie Ihr Repository und die CI- und CD-Tools Ihrer Wahl verwenden, um Pipelines für Konfigurationen in einem Projekt zu automatisieren.

Dies ist eine experimentelle Funktion, die zu Evaluierungs- und Testzwecken verfügbar ist und ohne Vorankündigung geändert werden kann.

Pipelines und Toolchains sind anpassbar, sodass Sie viele Aktionen zwischen Ihrem Git Repository und Ihrem Projekt automatisieren können, indem Sie API-Methoden oder CLI-Befehle für Projekte verwenden. Sie können beispielsweise eine Pipeline erstellen, um eine Aktualisierung in Ihrem Projekt auszulösen, wenn Konfigurationsänderungen in den Hauptzweig in Ihrem Repository zusammengeführt werden. Weitere Informationen finden Sie unter Automatisieren von Projektaktionen in Ihrem Git Repository.

In einem Projekt können Konfigurationsentwürfe in jedem Zweig Ihres Repository gespeichert werden. Sie können Entwurfskonfigurationen jedoch erst validieren und bereitstellen, nachdem sie mit dem Zweig in Ihrem Repository zusammengeführt wurden, der Ihre CD-Pipelines verwaltet. Sie müssen auch die Aktualisierungen aus Ihrem Repository mit Ihrem Projekt synchronisieren, indem Sie Konfigurationen aktualisieren, bevor Sie diese Konfigurationen validieren und bereitstellen können. Sie können dieses Update mit der API-Methode project.config.update oder dem CLI-Befehl ibmcloud project config-update automatisieren.

Vorbereitende Schritte

  1. Stellen Sie sicher, dass Sie im Dienst „ IBM Cloud Projects“ über die Rolle „Editor“ verfügen, um Git Repository-Integrationen zu verwalten.

  2. Speichern Sie einen Zugriffstoken als Geheimnis, um eine Verbindung zu Ihrem Git Repository herzustellen. Der Zugriffstoken benötigt Schreibzugriff auf die Zweige, die Sie verwenden möchten, und zum Erstellen von Commits in Ihrem Repository. Der Zugriffstoken muss außerdem die Möglichkeit bieten, Zweige aufzulisten und zu lesen.

    1. Erstellen Sie eine Secrets Manager Serviceinstanz in Ihrem IBM Cloud-Konto. Um ein Geheimnis zu erstellen, müssen Sie im Dienst Secrets Manager die Rolle "Writer" oder höher haben.

    2. Stellen Sie nach dem Erstellen Ihrer geheimen Instanz sicher, dass Sie „Anderer geheimer Typ“ auswählen, um ein beliebiges Geheimnis hinzuzufügen. Informationen zum Erstellen eines beliebigen Geheimnisses finden Sie unter Erstellen beliebiger Geheimnisse in der Benutzeroberfläche. Ihr beliebiges Geheimnis muss den Zugriffstoken für Ihr Git Repository enthalten.

Verbinden eines Projekts mit einem Git Repository

Verbinden Sie Ihr Git Repository mit Ihrem Projekt. Auf diese Weise werden Konfigurationsänderungen in Ihrem Repository und nicht in der JSON-Datei des Projekts gespeichert. Da Ihr Projekt Konfigurationen in Ihrem Repository speichern muss, müssen Sie ein Zugriffstoken angeben, um sich von Ihrem Projekt aus beim Repository zu authentifizieren.

  1. Klicken Sie in der IBM Cloud-Konsole auf das Navigationsmenüsymbol Navigationsmenüsymbol > Projekte und wählen Sie ein Projekt aus.
  2. Wählen Sie auf der Registerkarte „Verwalten“ die Option „Integrationen“ aus.
  3. Klicken Sie im Abschnitt Git-Repository-Integration“ auf „Verbinden“.
  4. Wählen Sie im Menü „Repository-Typ“ den Repository-Typ aus, den Sie zum Verwalten Ihrer Konfigurationen verwenden möchten. Normalerweise verwenden Sie dieses Repository zum Verwalten Ihrer Pipelines und Toolchains. Sie können GitHub, GitLab oder GitHub Enterprise auswählen.
  5. Geben Sie die URL zum Repository ein.
  6. Geben Sie optional einen Ordner innerhalb des Repository an. Erwägen Sie die Angabe eines Ordners, wenn Sie Ihr Repository in mehrere Projekte integrieren möchten. Jedes Projekt kann einen eigenen Ordner haben.
  7. Bewegen Sie den Mauszeiger über das Feld „Zugriffstoken“ oder klicken Sie darauf. Klicken Sie dann auf das Symbol „Geheimnisse“ und dann auf das Schlüsselsymbol um das Geheimnis auszuwählen, das Ihr Zugriffstoken enthält.
  8. Wenn Ihr Projekt bereits Konfigurationen enthält, wählen Sie "Vorhandene Konfigurationsdateien in dieses Repository kopieren ", um vorhandene Konfigurationen in Ihrem Repository zu speichern.
  9. Klicken Sie auf Speichern.

Nächste Schritte

Nachdem Ihr Git Repository nun mit Ihrem Projekt verbunden ist, können Sie Pipelines und Toolchains anpassen. Informationen zum Erstellen einer Pipeline, die Konfigurationen in Ihrem Projekt automatisch aktualisiert, wenn Änderungen in Ihren Hauptzweig zusammengeführt werden, finden Sie unter Automatisieren von Projektaktionen in Ihrem Git Repository.