Publication des résultats de test

DevOps Insights sera retiré du service et ne sera plus commercialisé à compter du 31 août 2026. Après cette date, le service ne sera plus disponible. Il n'est plus possible de créer de nouvelles intégrations d'outils dans l' DevOps Insights. En savoir plus

Vous pouvez publier des résultats de test à l'aide d'autres outils d'intégration et de distribution continues (outils CI/CD) avec l'interface de ligne de commande IBM Cloud® pour une intégration à IBM Cloud® DevOps Insights. Les résultats de test fournissent à DevOps Insights des informations concernant les tests exécutés au cours du processus de génération. Ces tests doivent générer un type de fichier basé JSON ou XML.

Le fichier de test généré est publié en tant qu'enregistrement de test. Outre le fichier de test, l'enregistrement contient le nom de l'application, le numéro de génération, les types de test, ainsi que d'autres zones. Le nom d'application et l'ID génération figurant dans l'enregistrement de test doivent correspondre aux mêmes types d'information utilisés dans l'enregistrement de génération pour une génération donnée. Après avoir exécuté un test dans votre outil CI/CD, vous pouvez télécharger les résultats sur DevOps Insights

Avant de commencer

Avant de publier des résultats de test, vous devez publier un enregistrement de déploiement. Pour plus d'information, voir Publication d'un enregistrement de déploiement à l'aide d'autres outils CI/CD.

Publication des résultats de test

Utilisez la commande testrecord-publish pour télécharger un enregistrement de test. L'exemple de script suivant télécharge des résultats de test fonctionnel de vérification dans DevOps Insights:

# 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

Dans l'exemple de script, la commande testrecord-publish spécifie que la commande télécharge les enregistrements de test. L'indicateur --filelocation signale l'emplacement du fichier de résultats de test relativement au répertoire racine du travail. L'indicateur --type précise le type de résultat de test.

L'exemple de script suivant exécute des tests, puis télécharge les résultats Mocha dans DevOps Insights:

# 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

La commande prend en charge les valeurs type suivantes :

Types d'enregistrements test
Type Description
unittest Résultats de test d'unité
fvt Résultats de test fonctionnel de vérification
code Résultats de couverture de code
sonarqube Résultats d'analyse SonarQube
staticsecurityscan Résultats d'analyse de sécurité statique à partir d'IBM Application Security on Cloud
dynamicsecurityscan Résultats d'analyse de sécurité dynamique à partir d'IBM Application Security on Cloud

Les enregistrements de test doivent fournir les données dans l'un des formats pris en charge suivants :

Formats pris en charge
Type de test Formats pris en charge
Test fonctionnel de vérification Mocha, xUnit, Karma/Mocha
Test unitaire Mocha, xUnit, Karma/Mocha
couverture de code Cobertura, lcov, JaCoCo
Analyse application statique Analyses d'application statiques fournies par IBM Application Security on Cloud
Analyse application dynamique Analyses d'application dynamiques fournies par IBM Application Security on Cloud
SonarQube Données d'analyse fournies par les analyses SonarQube

Affichage des résultats de test

Lorsque votre outil CI/CD s'exécute, il publie les données de résultat de test dans DevOps Insights. Pour afficher les données de résultat de test dans DevOps Insights, accédez à la page Tableau de bord Qualité. Pour plus d'informations, voir Agrégation de données DevOps.

Etapes suivantes

Evaluer des jalons à l'aide d'autres outils CI/CD.