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
Für die Integration in IBM Cloud® können Sie Testergebnisse mithilfe anderer Continuous Integration- und Continuous Delivery-Tools (CI/CD-Tools) über die IBM Cloud® DevOps Insights-Befehlszeilenschnittstelle (CLI) veröffentlichen. 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. Der Anwendungsname und die Build-ID im Testdatensatz müssen mit den Werten übereinstimmen, die im Builddatensatz für einen bestimmten Build verwendet werden. Nach dem Ausführen eines Tests im CI/CD-Tool können Sie die Ergebnisse in DevOps Insights hochladen.
Vorbereitende Schritte
Bevor Sie Testergebnisse veröffentlichen, müssen Sie einen Bereitstellungsdatensatz veröffentlichen. Weitere Informationen finden Sie in Bereitstellungsdatensatz mithilfe anderer CI/CD-Tools veröffentlichen.
Testergebnisse veröffentlichen
Verwenden Sie den Befehl testrecord-publish zum Hochladen eines Testdatensatzes. 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
# Log in to IBM Cloud 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
# Log in to IBM Cloud 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:
| 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 |
Testdatensätze müssen Daten in einem der folgenden unterstützten Formate bereitstellen:
| Testtyp | Unterstützte Formate |
|---|---|
| Funktionsüberprüfungstest | Mocha, xUnit, Karma/Mocha |
| Komponententest | Mocha, xUnit, Karma/Mocha |
| Codeabdeckung | Cobertura, Icov, JaCoCo |
| 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 |
| SonarQube | Scandaten, die von SonarQube-Überprüfungen bereitgestellt werden |
Testergebnisse anzeigen
Wenn das CI/CD-Tool ausgeführt wird, veröffentlicht sie die Testergebnisdaten in DevOps Insights. Für die Anzeige von Testergebnissen in DevOps Insights öffnen Sie die Seite "Qualitätsdashboard". Weitere Informationen hierzu finden Sie unter DevOps-Datenaggregation.
Nächste Schritte
Lesen Sie die Informationen zur Auswertung von Gates mithilfe anderer CI/CD-Tools.