Delivery Pipeline 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

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 über eine Toolchain verfügen und diese Tool-Integration hinzufügen möchten, klicken Sie in der IBM Cloud-Konsole auf das Menü-Symbol ( Hamburger-Symbol ) > Platform Automation > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf die Toolchain, zu der Sie Delivery Pipeline hinzufügen möchten.

    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:

    • Classic: Bietet eine benutzerfreundliche grafische Oberfläche zur Definition von Phasen und Jobs, die auf einer öffentlichen, gemeinsam genutzten Infrastruktur ausgeführt werden, mit der Möglichkeit, einzelne Phasen auf privaten Workern auszuführen.
    • 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 beabsichtigen, Ihre Pipeline zum Bereitstellen einer Benutzeroberfläche zu verwenden, und es sich bei Ihrer Pipeline um eine Classic-Pipeline handelt, aktivieren Sie das Kontrollkästchen Apps im Menü App 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.

    caption-side=bottom"
    TestauftragTestauftrag

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

    Der Sauce Labs-Benutzername und der Zugriffsschlüssel stehen im Testjob-Skript als Umgebungsvariablen SAUCE_USERNAME und SAUCE_ACCESS_KEY zur Verfügung. 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-Instanz, Ziel, Organisation und Space werden automatisch mit dem von Ihnen verwendeten Sauce Labs-Benutzernamen, der Region, der Organisation und dem Space ausgefüllt.

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

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

    Um den Benutzernamen und den Zugriffsschlüssel anzuzeigen, die Sie bei der Konfiguration von Sauce Labs für Ihre Toolchain verwendet haben, klicken Sie auf Konfigurieren.

    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.

Delivery Pipeline-Konfiguration mithilfe der API

Die Delivery Pipeline Tool-Integration unterstützt die folgenden Konfigurationsparameter, die Sie mit der HTTP Toolchain-API und den SDKs verwenden können, wenn Sie Tool-Integrationen erstellen, lesen und 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.