Code Stream bietet eine Möglichkeit, eine Pipeline auszulösen, wenn ein Codewechsel in Ihrem GitHub-, GitLab- oder Bitbucket-Repository auftritt. Der Git-Auslöser verwendet einen Git-Endpoint auf dem Zweig des Repositorys, den Sie überwachen möchten. Code Stream verbindet sich über einen Webhook mit dem Git-Endpoint.

Um in Code Stream einen Git-Endpoint zu definieren, wählen Sie ein Projekt aus und geben den Zweig des Git-Repositorys ein, in dem sich der Endpoint befindet. Das Projekt gruppiert die Pipeline mit dem Endpoint und anderen verwandten Objekten. Wenn Sie das Projekt in Ihrer Webhook-Definition auswählen, wählen Sie den Endpoint und die auszulösende Pipeline aus.
Hinweis: Wenn Sie einen Webhook mit Ihrem Endpoint definieren und den Endpoint später bearbeiten, können Sie die Details des Endpoints im Webhook nicht ändern. Zum Ändern der Endpoint-Details müssen Sie den Webhook löschen und mit dem Endpoint neu definieren. Weitere Informationen hierzu finden Sie unter Vorgehensweise zum Verwenden des Git-Auslösers in Code Stream zum Ausführen einer Pipeline.

Voraussetzungen

  • Überprüfen Sie, ob Sie auf das GitHub-, GitLab- oder Bitbucket-Repository zugreifen können, zu dem Sie eine Verbindung herstellen möchten.
  • Wenn Sie ein lokales Git-Repository verwenden, vergewissern Sie sich, dass Sie auf VMware Cloud Assembly zugreifen können, sodass Sie einen Cloud-Proxy hinzufügen können. Ein Beispiel finden Sie unter Einrichten von VMware Code Stream zum Modellieren des Freigabeprozesses.
  • Vergewissern Sie sich, dass Sie Mitglied eines Projekts in Code Stream sind. Falls nicht, bitten Sie einen Code Stream-Administrator, Sie als Mitglied eines Projekts hinzuzufügen. Weitere Informationen hierzu finden Sie unter Vorgehensweise zum Hinzufügen eines Projekts in VMware Code Stream.

Prozedur

  1. Definieren Sie einen Git-Endpoint.
    1. Klicken Sie auf Endpoints > Neuer Endpoint.
    2. Wählen Sie ein Projekt aus, und wählen Sie als Endpoint-Typ Git aus. Geben Sie dann einen Namen und eine Beschreibung ein.
    3. Wenn dieser Endpoint eine geschäftskritische Komponente in Ihrer Infrastruktur ist, aktivieren Sie Als eingeschränkt kennzeichnen.
    4. Wenn es sich um einen lokalen Endpoint handelt, wählen Sie einen Cloud-Proxy aus, der diesen mit Code Stream verbindet. Behalten Sie anderenfalls die Standard-Einstellung bei.
    5. Wählen Sie einen der unterstützten Git-Servertypen aus.
    6. Geben Sie die URL für das Repository mit dem API-Gateway für den Server im Pfad ein. Geben Sie beispielsweise https://api.github.com/vmware-example/repo-example ein.
    7. Geben Sie den Zweig im Repository ein, in dem sich der Endpoint befindet.
    8. Wählen Sie den Authentifizierungstyp aus und geben Sie den Benutzernamen für GitHub, GitLab oder Bitbucket ein. Geben Sie dann das Kennwort, das private Token oder den privaten Schlüssel für den Benutzernamen ein.
      • Kennwort. Mit dem Kennwort erhalten Sie Vollzugriff auf das Repository. Sie können auch eine Variable für das Kennwort erstellen.

        Verwenden Sie geheime Variablen, um vertrauliche Informationen auszublenden und zu verschlüsseln. Verwenden Sie eingeschränkte Variablen für Zeichenfolgen, Kennwörter und URLs, die ausgeblendet und verschlüsselt sein müssen, sowie um deren Verwendung in Ausführungen einzuschränken. Verwenden Sie beispielsweise eine geheime Variable für ein Kennwort oder eine URL. Sie können geheime und eingeschränkte Variablen in jeder Art von Aufgabe in Ihrer Pipeline verwenden.

      • Privates Token. Dieses Token ist Git-spezifisch und ermöglicht den Zugriff auf eine spezifische Aktion. Weitere Informationen hierzu finden Sie unter https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html. Sie können auch eine Variable für das private Token erstellen.
      • Privater Schlüssel. Dieser SSH-Schlüssel ist ein privater Schlüssel, der den Zugriff auf ein spezifisches Repository ermöglicht. Wenn ein Git-Ereignis auftritt, verwendet Code Stream diesen Schlüssel zum Klonen eines Repositorys. Weitere Informationen finden Sie unter https://help.github.com/articles/reviewing-your-ssh-keys/.
  2. Klicken Sie auf Validieren und überprüfen Sie, ob sich der Endpoint mit Code Stream verbindet.
    Wenn er sich nicht verbindet, beheben Sie die entsprechenden Fehler und klicken Sie dann auf Erstellen.
    Verwendung eines Git-Endpoints zum Erstellen und Testen Ihres Codes

Nächste Maßnahme

Weitere Informationen finden Sie in den anderen Abschnitten. Weitere Informationen hierzu finden Sie unter Vorgehensweise zum Verwenden des Git-Auslösers in Code Stream zum Ausführen einer Pipeline.