Testergebnisse veröffentlichen

DevOps Insights wird am 31. August 2026 auslaufen und eingestellt werden. Nach diesem Datum wird der Dienst nicht mehr verfügbar sein. Es können keine neuen Tool-Integrationen für „ DevOps Insights “ mehr erstellt werden. Mehr erfahren

Testergebnisse informieren DevOps Insights über die Tests, die während des Buildprozesses ausgeführt werden. Aus diesen Tests muss als Ergebnis eine JSON- oder XML-basierte Datei hervorgehen. Die generierte Testdatei wird als Testdatensatz veröffentlicht. Zusammen mit der Testdatei enthält dieser Datensatz den Anwendungsnamen, die Buildnummer, die Typen von Tests und andere Felder.

Vorbereitende Schritte

Bereitstellungsdatensatz veröffentlichen.

Testergebnisse hochladen

Der Anwendungsname und die Build-ID im Testdatensatz müssen mit den Werten übereinstimmen, die im Builddatensatz für einen bestimmten Build verwendet werden. Mit dem folgenden Beispielscript werden Ergebnisse von Funktionsüberprüfungstests (FVT = Functional Verification Test) in DevOps Insights hochgeladen:

# Run tests and generate a test results file here.
#install the DevOps Insights plugin
ibmcloud plugin install -f doi
# Login to IBMCloud if you are not already logged in.  Assumes that $API_KEY environment variable has been set as a secured property
ibmcloud login --apikey $API_KEY --no-region
ibmcloud doi testrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --filelocation fvttest.json --type fvt

Im Beispielscript gibt testrecord-publish an, dass mit dem Befehl Testdatensätze hochgeladen werden. Das Flag --filelocation gibt die Speicherposition der Testergebnisdatei relativ zum Stammverzeichnis des Jobs an. Das Flag --type gibt den Typ des Testergebnisses an.

Das folgende Beispielscript führt Tests aus und lädt dann die Mocha-Ergebnisse in DevOps Insightshoch:

# Run tests and generate a test results file here.
istanbul cover --report lcov --report json-summary _mocha -- -R xunit -O output=./test/results/mocha.xml 'test/**/*.js'
#install the DevOps Insights plugin
ibmcloud plugin install -f doi
# Login to IBMCloud if you are not already logged in.  Assumes that $API_KEY environment variable has been set as a secured property
ibmcloud login --apikey $API_KEY --no-region
#Publish test results.  Assumes that MY_APP_NAME and MY_BUILD_NUMBER environment variables are already set
ibmcloud doi testrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --filelocation /test/results/mocha.xml --type unittest
ibmcloud doi testrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --filelocation ./coverage/coverage-summary.json --type code

Der Befehl unterstützt die folgenden Werte für type:

Test-Datensatztypen
Typ Beschreibung
unittest Ergebnisse von Komponententests
fvt Ergebnisse von Funktionsüberprüfungstests
code Ergebnisse der Codeabdeckung
sonarqube Ergebnisse der SonarQube-Überprüfung
staticsecurityscan Ergebnisse von statischen Sicherheitsscans aus IBM Application Security on Cloud
dynamicsecurityscan Ergebnisse von dynamischen Sicherheitsscans aus IBM Application Security on Cloud
vulnerabilityadvisor Vulnerability Advisor-Ergebnisse von IBM Vulnerability Advisor on Cloud

Testdatensätze müssen Daten in einem der folgenden unterstützten Formate bereitstellen:

Unterstützte Formate
Testtyp Unterstützte Formate
Komponententest Mocha, xUnit, Karma/Mocha
Funktionsüberprüfungstest Mocha, xUnit, Karma/Mocha
Codeabdeckung Cobertura, Icov, JaCoCo
SonarQube Scandaten, die von SonarQube-Überprüfungen bereitgestellt werden
Static AppScan Statische App-Überprüfungen, die von IBM Application Security on Cloud bereitgestellt werden
Dynamic AppScan Dynamische App-Überprüfungen, die von IBM Application Security on Cloud bereitgestellt werden
Vulnerability Advisor-Ergebnisse Vulnerability Advisor-Ergebnisse von IBM Vulnerability Advisor on Cloud

Testergebnisse anzeigen

Wenn Ihre Pipeline ausgeführt wird, veröffentlicht sie die Testergebnisdaten in DevOps Insights. Sie können die Testergebnisdaten auf der Seite 'Qualitätsdashboard' anzeigen.

  1. Klicken Sie in der IBM Cloud-Konsole auf das Menüsymbol Hamburger-Symbol und wählen Sie Ressourcenliste aus.
  2. Wählen Sie Ihre Toolchain aus.
  3. Klicken Sie auf der Übersichtsseite Ihrer Toolchain auf der Karte IBM Cloud-Tools auf DevOps Insights.
  4. Klicken Sie in der Navigation auf Qualitätsdashboard, um die Datei zu öffnen.

Weitere Informationen zur Seite 'Qualitätsdashboard' finden Sie in DevOps-Datenaggregation.

Nächste Schritte

Gates auswerten