Builderstellung und Bereitstellung

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

IBM Cloud® Continuous Delivery enthält die Delivery Pipeline, die es Ihnen ermöglicht, einen reproduzierbaren, kontinuierlichen Integrationsprozess und einen Continuous Delivery-Prozess zu implementieren.

Führen Sie die folgenden Tasks aus, um eine Pipeline zu konfigurieren.

Eine Phase hinzufügen

  1. Klicken Sie auf der Seite 'Pipeline' auf Phase hinzufügen. Die Seite 'Phasekonfiguration' wird angezeigt.

  2. Konfigurieren Sie die Stage.

    a. Wählen Sie auf der Registerkarte EINGABE eine Eingabe für die Phase aus. Für Build-Phasen enthält die Eingabe-Registerkarte ein Zweig-Feld, um die Verzweigung im Repository anzugeben, das für die Eingabe verwendet werden soll.

    b. Fügen Sie auf der Registerkarte JOBS mindestens einen Job hinzu und konfigurieren Sie diesen. Die erste Phase verfügt in der Regel mindestens über einen Buildjob.

  3. Klicken Sie auf SPEICHERN.

Einen Job zu einer Phase hinzufügen

  1. Klicken Sie in der Phase auf das Symbol Phasenkonfiguration und dann auf Phase konfigurieren.
  2. Klicken Sie auf die Registerkarte JOBS.
  3. Klicken Sie auf Job hinzufügen. Wählen Sie den Typ von Job aus, der hinzugefügt werden soll.
  4. Konfigurieren Sie den Job.
  5. Klicken Sie auf SPEICHERN.

Hinzufügen eines Auftrags zu einer
Hinzufügen eines Auftrags zu einer

Eine Phase ausführen

Sie können eine Phase manuell ausführen, indem Sie auf das Symbol Phase ausführen auf der Seite 'Pipeline' klicken.

Klicken auf das Symbol "Bühne ausführen" auf einer
einer

Sie können über eine von zwei Möglichkeiten auch bedarfsgerechte Builds und Bereitstellungen von der Seite für Buildprotokolle anfordern.

  • Ziehen Sie einen Build auf die Box, die sich unter einer konfigurierten Phase befindet.
  • Klicken Sie im Abschnitt "LETZTES AUSFÜHRUNGSERGEBNIS" auf das Symbol Senden an und wählen Sie dann einen Bereich für die Implementierung aus.

Die Stufe "Ausführen" mit diesem
einer

Klicken Sie in der Phase auf Protokolle und Verlauf anzeigen, um eine aktive Phase abzubrechen. Klicken Sie in der Liste der Jobs auf die Nummer des aktiven Jobs und anschließend auf ABBRECHEN. Sie können Jobs auch einzeln abbrechen, indem Sie auf einen Job und anschließend auf das Symbol Abbrechen klicken, oder indem Sie für einen Job in seiner Phase auf das Symbol Stopp klicken.

Bereitstellung einer App

Ein ordnungsgemäß konfigurierter Bereitstellungsjob stellt Ihre App immer dann in Ihrem Ziel bereit, wenn der Job ausgeführt wird. Um einen Bereitstellungsjob manuell auszuführen, klicken Sie auf das Symbol Phase ausführen der Phase, in der sich der Job befindet.

Eingabeüberarbeitungen

Wenn Sie eine Phase manuell ausführen, oder wenn sie ausgeführt wird, weil eine Phase vor ihr abgeschlossen wurde, wählt die aktive Phase ihre Eingabeüberarbeitung aus. In der Regel ist die Eingabeüberarbeitung eine Buildnummer. Zur Auswahl der Eingabeüberarbeitung erfüllt die Phase die folgenden Bedingungen:

  • Falls eine bestimmte Überarbeitung ausgewählt ist, wird diese verwendet.
  • Falls keine bestimmte Überarbeitung ausgewählt ist, werden vorherige Phasen durchsucht, bis eine Phase gefunden wurde, die dieselbe Eingabe verwendet. Die letzte erfolgreich ausgeführte Überarbeitung dieser Eingabe wird gesucht und verwendet.
  • Falls keine bestimmte Überarbeitung angegeben ist und keine anderen Phasen die angegebene Quelle als Eingabe verwenden, wird die letzte Überarbeitung der Eingabe verwendet.

Sie können einen vorherigen Build bereitstellen. Klicken Sie in der Phase, die den Build enthält, auf Protokolle und Verlauf anzeigen. Klicken Sie auf der Seite, die geöffnet wird, um die Ausführungsnummer zu erweitern, und klicken Sie anschließend auf den Buildjob. Klicken Sie auf Senden an und wählen Sie ein Ziel aus.

Services zu Apps hinzufügen

Sie können Services zu Ihren Apps hinzufügen und diese Services über das Dashboard IBM Cloud verwalten. Weitere Informationen zum Hinzufügen von Services finden Sie in Services mit externen Apps verbinden.

Protokolle anzeigen

Sie können die Protokolle für Jobs anzeigen und Phasen, die gerade ausgeführt werden, auf der Seite mit dem Phaseverlaufsprotokoll anzeigen.

  1. Um das Protokoll eines Jobs anzuzeigen, klicken Sie auf den Job. Alternativ können Sie in einer Phase auf Protokolle und Verlauf anzeigen klicken.

  2. Um das Laufzeitprotokoll einer bereitgestellten Anwendung anzuzeigen, klicken Sie auf Laufzeitprotokoll anzeigen.

    Zusätzlich zu den Jobprotokollen können Sie Komponententestergebnisse, generierte Artefakte und Codeänderungen für beliebige Buildjobs anzeigen.

    Sie können ferner eine Phase auf der Seite mit dem Phaseverlaufsprotokoll ausführen, abbrechen oder konfigurieren. Klicken Sie auf AUSFÜHREN, um die Phase auszuführen, auf ERNEUT BEREITSTELLEN, um einen Bereitstellungsjob erneut bereitzustellen, oder auf KONFIGURIEREN, um eine Phase zu konfigurieren. Während der Ausführung einer Phase können Sie diese abbrechen, indem Sie auf die Ausführungsnummer und anschließend auf Abbrechen klicken.

Protokolle aus einem Script herunterladen

Sie können die Protokolldatei für einen Pipelinejob aus einem Script herunterladen und die PIPELINE_LOG_URL speichern, die während der Ausführung des Pipelinejobs bereitgestellt wird. Im folgenden Beispiel finden Sie die Schritte zum Herunterladen der Protokolldatei des Pipelinejobs auf ein anderes System.

  1. Richten Sie eine JOB_LOG-Umgebungseigenschaft für Ihre Phase ein.

  2. Speichern Sie die PIPELINE_LOG_URL in Ihrem Pipelinejob.

    export JOB_LOG="$PIPELINE_LOG_URL"
    
  3. Verwenden Sie die PIPELINE_LOG_URL in einem späteren Job in derselben Phase, um die Protokolldatei für den Export auf ein anderes System herunterzuladen. Verwenden Sie ein IBM Cloud-Trägertoken, um auf die Protokolldatei zuzugreifen.

    ibmcloud login -a cloud.ibm.com \
      --apikey <INSERT API KEY HERE>
    BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )
    curl -H "Authorization: Bearer $BEARER"  \
      -H "Accept: text/plain" \
      -D /tmp/headers.txt \
      -o job_log.txt \
      "$JOB_LOG"
    
  4. Prüfen Sie den Header X-More-Data. Wenn der Header auf true gesetzt ist, wird die Protokolldatei generiert oder verarbeitet. Wenn der Header auf false gesetzt ist, kann die Protokolldatei verwendet werden.

    grep X-More-Data /tmp/headers.txt
    X-More-Data: false
    
  5. Laden Sie die Protokolldatei auf Ihr System hoch.

    scp job_log.txt user@example.org:/job1/logs
    

Artefakte aus einem Script herunterladen

Sie können die Artefakte für einen Pipeline-Buildjob aus einem Script herunterladen und die PIPELINE_ARTIFACT_URL speichern, die während der Ausführung des Pipelinejobs bereitgestellt wird. Im folgenden Beispiel finden Sie die Schritte zum Hochladen der Artefakte des Pipelinejobs auf ein anderes System.

  1. Richten Sie eine JOB_ARTIFACT-Umgebungseigenschaft für Ihre Phase ein.

  2. Speichern Sie die PIPELINE_ARTIFACT_URL in Ihrem Pipelinejob.

    export JOB_ARTIFACT="$PIPELINE_ARTIFACT_URL"
    
  3. Verwenden Sie die PIPELINE_ARTIFACT_URL in einem späteren Job in derselben Phase, um die Artefakte für den Export auf ein anderes System herunterzuladen. Verwenden Sie ein IBM Cloud-Trägertoken, um auf die Artefakte zuzugreifen.

    ibmcloud login -a cloud.ibm.com \
      --apikey <INSERT API KEY HERE>
    BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )
    DOWNLOAD_URL=$( curl -H "Authorization: Bearer $BEARER"  \
      "$JOB_ARTIFACT" )
    curl -O  "$DOWNLOAD_URL"
    
  4. Laden Sie die Artefakte auf Ihr System hoch.

    scp $(basename "$DOWNLOAD_URL") user@example.org:/job1/artifacts