IBM Cloud Docs
Delivery Pipeline konfigurieren

Delivery Pipeline konfigurieren

Delivery Pipeline automatisiert die kontinuierliche Entwicklung Ihrer Projekte durch aufeinanderfolgende Stages, in denen Eingaben abgerufen und Jobs wie Builds, Tests und Bereitstellungen ausgeführt werden.

Konfigurieren Sie Delivery Pipeline, um das kontinuierliche Erstellen, Testen und Bereitstellen Ihrer Apps zu automatisieren. Gehen Sie dazu wie folgt vor:

  1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf Delivery Pipeline. Abhängig von der Vorlage, die Sie verwenden, sind unterschiedliche Felder verfügbar. Überprüfen Sie die Standardfeldwerte und ändern Sie diese Einstellungen gegebenenfalls.

  2. Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen möchten, klicken Sie in der IBM Cloud auf das Hamburger-Symbol im Menü > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf die Toolchain, zu der Sie Delivery Pipeline hinzufügen möchten. 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.

    a. Klicken Sie auf Tool hinzufügen.

    b. Klicken Sie im Abschnitt mit den Toolintegrationen auf Delivery Pipeline.

  3. Geben Sie einen Namen für Ihre neue Pipeline an.

  4. Wählen Sie den Typ von Pipeline aus, die Sie erstellen möchten:

    • Klassisch: Bietet eine einfach zu bedienende grafische Benutzeroberfläche zur Definition von Phasen und Aufträgen, die auf einer öffentlichen, gemeinsam genutzten Infrastruktur laufen, mit Unterstützung für die Ausführung einzelner Phasen auf privaten Arbeitsplätzen.
    • Tekton: Stellt ein Dashboard bereit, in dem Sie die Ausgabe von Tekton-Pipelineausführungen in einem definierten Kubernetes-Cluster anzeigen können, mit Unterstützung für die Konfiguration von Pipelinedefinitionsrepositorys, von Pipeline-Auslösern, von Orten, an denen die Pipeline ausgeführt wird und von einfachen geheimen Schlüsseln.
  5. Wenn Sie mit Ihrer Pipeline eine Benutzeroberfläche bereitstellen möchten und es sich bei Ihrer Pipeline um eine klassische Pipeline handelt, aktivieren Sie das Kontrollkästchen Anwendungen im Menü Anwendung anzeigen. Alle Apps, die Ihre Pipeline erstellt, werden in der Liste App anzeigen auf der Übersichtsseite der Toolchain angezeigt.

  6. Klicken Sie auf Integration erstellen, um die Delivery Pipeline zu Ihrer Toolchain hinzuzufügen.

  7. Klicken Sie in Ihrer Toolchain auf der Karte Delivery Pipelines auf die Delivery Pipeline, um sie anzuzeigen und zu konfigurieren. Die Grundlagen des Konfigurierens einer Pipeline finden Sie unter Pipelines erstellen und bereitstellen.

    Wenn Sie möchten, dass die Pipeline automatisch ausgeführt wird, wenn eine Übergabe an Ihr GitHub- oder Git-Repository (Repo) erfolgt, führen Sie die folgenden Schritte aus:

    a. Konfigurieren Sie GitHub oder Git Repos and Issue Tracking für Ihre Toolchain, bevor Sie die Stages für Ihre Pipeline definieren. Die Pipeline-Stages benötigen die Git-URLs für Ihre Repositorys. Jede Pipelinestufe kann nur auf eine der GitHub-oder Git-Repos verweisen, die Ihrer Toolchain zugeordnet sind. Anweisungen zum Konfigurieren von GitHub finden Sie im Abschnitt GitHub. Anweisungen zum Konfigurieren von Git Repos and Issue Tracking finden Sie im Git Repos and Issue Tracking-Abschnitt.

    b. Verwenden Sie einen Web-Hook. Ohne Web-Hook können Sie Pipelines nur manuell ausführen. Damit Sie einen Web-Hook verwenden können, wenn Sie eine Verbindung zu einem GitHub- oder GitHub Enterprise-Repository herstellen, benötigen Sie Administratorberechtigungen. Zum Herstellen einer Verbindung zu einem Git Repos and Issue Tracking-Repository benötigen Sie Berechtigungen als Master oder Eigner.

  8. Optional: Wenn Sie eine Toolchain auf IBM Cloud Public verwenden und Sie möchten, dass Sauce Labs Tests für Ihre App durchführt, konfigurieren Sie Delivery Pipeline, um einen Sauce Labs-Testjob hinzuzufügen. Anweisungen zum Konfigurieren des Testjobs finden Sie im Abschnitt Sauce Labs-Testjob in Ihrer Pipeline konfigurieren.

Sauce Labs-Testjob in Ihrer Pipeline konfigurieren

Bevor Sie einen Sauce Labs-Testjob in Ihrer Pipeline konfigurieren, brauchen Sie eine funktionstüchtige Pipeline, die Stages zum Erstellen und Bereitstellen Ihrer App umfasst. <Ţ Außerdem müssen Sie Sauce Labs für Ihre Toolchain konfigurieren. Anweisungen zur Konfiguration von Sauce Labs finden Sie im Abschnitt Sauce Labs.

Konfigurieren Sie die Delivery Pipeline, um einen Sauce Labs-Testjob hinzuzufügen:

  1. Wenn keine Stage vorhanden ist, die eine Testversion Ihrer App bereitstellt, erstellen Sie eine.

  2. Fügen Sie in der Stage nach dem Bereitstellungsjob einen Testjob hinzu. Indem Sie diese Jobs in derselben Stage platzieren, können sie auf dieselbe Gruppe von Umgebungseigenschaften zugreifen.

    Test job
    Test job

  3. Konfigurieren Sie die Stage. Erstellen Sie auf der Registerkarte UMGEBUNGSEIGENSCHAFTEN die Eigenschaft CF_APP_NAME.

    Der Sauce Labs-Benutzername und der Zugriffsschlüssel sind im Skript des Testjobs als Umgebungsvariablen SAUCE_USERNAME und SAUCE_ACCESS_KEY verfügbar. Wenn Sie Ihre Tests schreiben, müssen Sie diese Umgebungsvariablen verwenden, um sich für Sauce Labs zu authentifizieren.

  4. Konfigurieren Sie den Bereitstellungsjob. Schließen Sie im Feld Bereitstellungsscript diesen Befehl ein: export CF_APP_NAME="$CF_APP". Der Befehl exportiert den Namen der App als Umgebungseigenschaft.

  5. Konfigurieren Sie den Testjob.

    Die Felder Service Instance, Target, Organization und Space werden mit dem Sauce Labs-Benutzernamen, der Region, der Organisation und dem Space ausgefüllt, die Sie verwenden.

    a. Wählen Sie als Testertyp Sauce Labs aus.

    b. Wählen Sie für die Service-Instanz den Sauce Labs-Benutzernamen, den Sie bei der Konfiguration von Sauce Labs für Ihre Toolchain verwendet haben.

    Klicken Sie auf Konfigurieren, um den Benutzernamen und den Zugangsschlüssel zu sehen, den Sie bei der Konfiguration von Sauce Labs für Ihre Toolchain verwendet haben.

    c. Geben Sie im Feld Befehl für die Testausführung die Befehle ein, die die für Ihre Tests erforderlichen Abhängigkeiten installieren, und führen Sie dann die Tests aus. Für eine Node.js-App würden Sie beispielsweise folgende Befehle eingeben:

    npm install
    node_modules/grunt-cli/bin/grunt test:sauce:parallel
    

    d. Wenn Sie Ihre Testberichte in den Testjobprotokollen anzeigen möchten, wählen Sie das Kontrollkästchen Testbericht aktivieren aus und legen Sie das Dateimuster für Testergebnisse auf test/*.xml fest.

  6. Klicken Sie auf SPEICHERN. Immer, wenn Ihre Pipeline aktiv ist, werden Sauce Labs-Tests ausgeführt.

Konfigurieren von Delivery Pipeline mit Hilfe der API

Die Toolintegration Delivery Pipeline 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 pipeline angeben.

parameter für die WerkzeugintegrationDelivery Pipeline
Parameter Verwendung Typ Terraform-Argument Beschreibung
Name Optional, aktualisierbar Zeichenfolge Name Der Name dieser Toolintegration.